mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-10-07 02:58:13 +00:00
Same root cause as #587/#591 — Claude Code's runtime loader rejects array-form skills paths like ["./content-production", "./ai-seo", ...] even when each entry is a valid subdirectory containing SKILL.md. `claude plugin validate` accepts them but the loader does not. The proven canonical layout (used by self-improving-agent in #536): <plugin>/ ├── .claude-plugin/plugin.json skills: "./skills" └── skills/ ├── <skill-1>/SKILL.md ├── <skill-2>/SKILL.md └── ... Restructured 9 multi-skill domain plugins: - business-growth (4 skills moved) - c-level-advisor (28) - engineering (36) - engineering-team (32) - finance (2) - marketing-skill (43) - product-team (12) - project-management (8) - ra-qm-team (13) Also fixed standalone plugins that had root SKILL.md + ./skills/ subdir (agenthub, autoresearch-agent, executive-mentor, playwright-pro). The loader rejected them despite skills="./skills" because of the conflicting root SKILL.md (compare self-improving-agent which works because PR #536 moved its root SKILL.md). Moved each root SKILL.md into ./skills/<name>/. Restored standalone plugin folders to their original paths after the multi-skill restructure swept them into parent skills/ directories (marketplace.json source paths require original locations). Removed 7 orphaned marketplace entries that pointed to skill folders without their own plugin.json (content-creator, demand-gen, fullstack-engineer, aws-architect, product-manager, scrum-master, skill-security-auditor) — these were already non-functional. Bumped patch versions on every changed plugin and synced marketplace.json. Marketplace now lists 29 working plugins (down from 36). After merge: users run `/plugin marketplace update claude-code-skills` followed by `/plugin update --all` to pick up the working layout.
9.2 KiB
9.2 KiB
Invocation Patterns — Inter-Agent Protocol
Common cross-functional patterns, with examples and guidance on when to invoke vs assume.
Pattern 1: Revenue Planning Chain
CRO → CFO → CMO
Used when: setting revenue targets, allocating growth budget, modeling pipeline scenarios.
CRO initiates:
"Planning Q3 revenue targets. Need financial constraints and marketing input."
CRO → [INVOKE:cfo|What's our Q3 revenue target given current runway and burn?]
CFO responds:
[RESPONSE:cfo]
Key finding: To maintain 12-month runway without new raise, Q3 ARR target ≥ $2.4M (+20% QoQ)
Supporting data:
- Current ARR: $2.0M, burn: $180K/month, runway: 14 months
- 20% QoQ growth maintains runway; <15% triggers bridge discussion
- Board expectation communicated as 25% QoQ
Confidence: high
Caveat: Assumes no new hires or major infrastructure spend in Q3.
[/RESPONSE]
CRO → [INVOKE:cmo|Given a $2.4M Q3 ARR target, what pipeline coverage and CAC should we plan for?]
[CHAIN: cro → cfo → cmo]
CMO responds:
[RESPONSE:cmo]
Key finding: Need 3x pipeline ($7.2M) and CAC ≤ $8,400 to hit $2.4M ARR target.
Supporting data:
- Historical close rate: 33% → 3x coverage required
- Current CAC: $9,100 → 8% efficiency improvement needed
- Recommended channel mix: 60% outbound, 30% inbound, 10% partner
Confidence: medium
Caveat: Close rate assumes no sales team changes; any rep turnover drops it to 25%.
[/RESPONSE]
What CRO does with this: Synthesizes CFO constraint (target) + CMO playbook (how to hit it) into a revenue plan. Does not invoke further (depth limit reached).
Pattern 2: Hiring Decision Chain
CHRO → CFO → COO
Used when: headcount planning, role approval, capacity vs budget tradeoffs.
CHRO initiates:
"Engineering wants to hire 3 senior engineers. Need budget clearance and capacity validation."
CHRO → [INVOKE:cfo|Can we afford 3 senior engineers in H2? Fully loaded ~$180K each.]
[RESPONSE:cfo]
Key finding: Budget supports 2 hires now; 3rd is contingent on Q2 ARR closing above $2.1M.
Supporting data:
- Current H2 headcount budget: $340K remaining
- 2 hires = $270K fully loaded → $70K buffer
- 3 hires = $405K → $65K over; triggers board approval
Confidence: high
Caveat: Based on current runway projection — fundraise close changes this completely.
[/RESPONSE]
CHRO → [INVOKE:coo|Do operations support onboarding 2-3 engineers in H2? Any capacity constraints?]
[CHAIN: chro → cfo → coo]
[RESPONSE:coo]
Key finding: Can absorb 2 comfortably; 3rd requires dedicated onboarding lead or delays velocity 6 weeks.
Supporting data:
- Current eng team: 8 → adding 2 is 25% growth (manageable)
- Onboarding bottleneck: 1 senior eng mentor per 1-2 new hires, currently at capacity
- Dev environment setup: 3-week lead time per hire
Confidence: medium
Caveat: Assumes no concurrent product launches requiring full team focus.
[/RESPONSE]
CHRO synthesis: Recommends 2 hires now, pipeline 3rd for Q3 contingent on ARR milestone.
Pattern 3: Product Launch Chain
CPO → CTO → CMO
Used when: planning feature launches, assessing readiness, aligning go-to-market.
CPO initiates:
"Planning Q3 launch of [Feature X]. Need technical readiness and GTM input."
CPO → [INVOKE:cto|Is Feature X technically ready for Q3 launch? Key risks?]
[RESPONSE:cto]
Key finding: 70% complete; Q3 launch is achievable with scope cut — 2 items must move to Q4.
Supporting data:
- Core feature: complete; performance optimization: 3 weeks remaining
- Infrastructure scaling: needs load testing at 10x current volume
- Scope cuts needed: advanced analytics dashboard, third-party integrations
Confidence: medium
Caveat: Assumes no critical bugs found in load testing; historical rate suggests 1-2 found.
[/RESPONSE]
CPO → [INVOKE:cmo|Given Q3 launch of Feature X (core only, no analytics/integrations), what's the GTM plan?]
[CHAIN: cpo → cto → cmo]
[RESPONSE:cmo]
Key finding: Core-only launch works for existing customers; new logo acquisition needs integrations — recommend phased announcement.
Supporting data:
- Phase 1: Early access for top 20 accounts → testimonials and case studies
- Phase 2: Full launch with integration partners in Q4
- CAC impact: core-only launch reduces new logo conversion rate 15%
Confidence: medium
Caveat: Competitor launched similar feature last month — window for differentiation is narrow.
[/RESPONSE]
Pattern 4: Crisis Broadcast
CEO → All Roles
Used when: major adverse event, fundraise miss, key customer loss, market disruption.
CEO broadcasts:
[BROADCAST:all|Scenario: largest customer (28% of ARR) gives 60-day termination notice.
Each role: what's the immediate impact on your domain and your top recommended action?]
Roles respond INDEPENDENTLY (no agent sees others' responses first):
[RESPONSE:cfo]
Key finding: 28% ARR loss drops runway from 14 to 8 months at current burn.
Supporting data:
- Lost ARR: ~$560K → burn multiple increases from 1.8x to 3.2x
- Bridge options: $500K credit line (pre-approved), defer 2 planned hires
- Fundraise timeline must compress: target term sheet within 60 days
Confidence: high
Caveat: Assumes no secondary customer churn triggered by news.
[/RESPONSE]
[RESPONSE:cro]
Key finding: Pipeline must replace $560K ARR within 6 months to avoid emergency measures.
Supporting data:
- Current qualified pipeline: $1.8M → need 31% close rate (currently 28%)
- 3 deals in late stage can cover 70% of gap if closed this quarter
- Churn risk: 2 other accounts had similar usage patterns — immediate EBR required
Confidence: medium
Caveat: Close rate may drop if word spreads; manage communication carefully.
[/RESPONSE]
[RESPONSE:chro]
Key finding: Hiring freeze recommended immediately; retain all current staff.
Supporting data:
- 4 open reqs should pause pending CFO guidance
- At-risk of counter-poaching: 2 senior engineers, 1 product lead
- Retention bonuses for key staff: ~$80K to secure 12-month commitments
Confidence: high
Caveat: Morale impact of freeze can accelerate attrition if not communicated well.
[/RESPONSE]
[RESPONSE:cpo]
Key finding: Accelerate features that differentiate with remaining accounts; reduce scope to core.
Supporting data:
- Lost customer's feature requests: deprioritize (no longer strategic)
- Features most valued by remaining top 5 accounts: [list from account data]
- Reduce Q3 scope by 30% to free engineering capacity for retention work
Confidence: medium
Caveat: Need sales input on which features are blocking new logo deals.
[/RESPONSE]
[RESPONSE:cmo]
Key finding: Control the narrative; proactive communication to market reduces churn cascade risk.
Supporting data:
- Draft customer communication within 48 hours (frame as strategic pivot, not loss)
- Press: no comment strategy unless proactively asked
- Replace pipeline: double down on ICP segments where we're strongest
Confidence: medium
Caveat: If customer goes public with criticism, narrative control becomes much harder.
[/RESPONSE]
CEO synthesis: [Aggregates all 9 responses, identifies conflicts, sets priorities]
When to Invoke vs When to Assume
Invoke when:
- Cross-functional data is material to the decision
- Getting it wrong changes the recommendation significantly
- The other role has data you genuinely don't have
- Time allows (not in Phase 2 isolation)
Assume when:
- You're in Phase 2 (always — no exceptions)
- The chain is at depth 2 (you cannot invoke further)
- The answer is directionally obvious (e.g., "CFO will care about runway")
- The precision doesn't change the recommendation
State assumptions explicitly:
[ASSUMPTION: runway ~12 months — not verified with CFO; actual may vary ±20%]
[ASSUMPTION: CAC ~$8K based on industry benchmark — CMO has actual figures]
[ASSUMPTION: engineering capacity at ~70% — not verified with CTO]
Handling Conflicting Responses
When two agents give incompatible answers, surface it:
[CONFLICT DETECTED]
CFO says: runway extends to 18 months if Q3 targets hit
CRO says: only 45% confidence Q3 targets will be hit
Resolution: use probabilistic blend
- 45% probability: 18-month runway (optimistic case)
- 55% probability: 11-month runway (current trajectory)
Expected value: ~14 months
Recommendation: plan for 12 months, trigger bridge at 10.
[/CONFLICT]
Resolution options:
- Conservative: Use worse case — appropriate for cash/runway decisions
- Probabilistic: Weight by confidence scores — appropriate for planning
- Escalate: Flag for human decision — appropriate for high-stakes irreversible choices
- Time-box: Gather more data within 48 hours — appropriate when data gap is closeable
Anti-Patterns to Avoid
| Anti-pattern | Problem | Fix |
|---|---|---|
| Invoke to validate your own conclusion | Confirmation bias loop | Ask open-ended questions |
| Invoke when assuming works | Unnecessary latency | State assumption clearly |
| Hide conflicts between responses | Bad synthesis | Always surface conflicts |
| Invoke across depth > 2 | Loop risk | State assumption at depth 2 |
| Invoke during Phase 2 | Groupthink contamination | Flag with [ASSUMPTION:] |
| Vague questions | Poor responses | Specific, scoped questions only |