mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-08-28 04:24:58 +00:00
034c9fdda0
Fifth decision-driven C-role skill in the founder-mode lineup (after GC, CDO, CAIO, CCO). Throughput-first VPE covering 4 specific decisions distinct from CTO: 1. Are we delivering at the right throughput? (DORA 4 metrics + bottleneck) 2. How do we scale the eng hiring funnel? (7-stage funnel + pipeline gap) 3. What's our eng team structure? (squad/tribe + manager-trigger) 4. What's our production discipline? (on-call, deployment, postmortems) Critical distinction enforced: VPE is NOT a CTO skill. - CTO owns 'what to build' (architecture, scaling cliffs, build-vs-buy) - VPE owns 'how to ship it' (delivery, hiring, team structure, production) Built under karpathy-coder discipline (5th consecutive PR): - Assumptions surfaced upfront (CTO vs VPE distinction locked) - Each tool/reference covers ONE decision; no overlap with engineering tactical skills - Surgical scope; no edits to other c-level skills - All 3 tools smoke-tested with embedded samples - karpathy/complexity_checker: 0 findings on 3 new tools - karpathy/diff_surgeon: 0 findings on staged diff - check_plugin_json.py + sync_skill_bundles.py --check: both pass 3 stdlib Python tools with deterministic logic: - delivery_throughput_analyzer.py - DORA 4 metrics (Deployment Frequency, Lead Time, MTTR, Change Failure Rate) with Elite/High/Medium/Low verdict per metric and overall. Cycle-time bottleneck ID with fixes per stage. Sample (Platform Squad, 30 days, 28 deploys) -> overall High; bottleneck = first_review_to_approval at 45.8% of cycle. - eng_hiring_funnel_calculator.py - 7-stage funnel conversion with healthy/leaky verdict per stage. End-to-end conversion, required top-of-funnel volume for hiring target, weakest-stage fixes (sourcing, calibration, interview design, comp/close). Sample (Q2 2026, 4-hire target) -> 0.62% end-to-end, gap of 160 candidates, weakest = offer_to_accept at 60%. - eng_team_structure_designer.py - Structure recommendation by headcount, squad sizing (5-9 IC range), manager-trigger, director-trigger, span-of-control. Sample (25 engineers, 22 ICs / 3 EMs / 1 CTO) -> 4-squad structure; no EM trigger; director trigger FIRES. 4 in-depth references each citing 5+ authoritative sources: - delivery_throughput.md - Full DORA framework, 4 bottleneck patterns, what to fix first, anti-patterns. Cites Accelerate (Forsgren/Humble/Kim), Google State of DevOps, Phoenix Project, Reinertsen Flow, Humble Continuous Delivery. - engineering_hiring_funnel.md - 7-stage funnel + benchmarks + leakage diagnosis + pipeline math + sourcing diversification + interview design. Cites LinkedIn Talent Insights, Levels.fyi+Pave, Lou Adler, Adler/Bock "Work Rules!", CMU/Booth research. - eng_team_structure.md - Conway's Law + headcount-to-structure + span-of- control + EM vs tech lead + manager/director/VPE triggers + squad sizing + chapter discipline. Cites Kniberg "Scaling Agile @ Spotify" + 2020 retrospective, Will Larson, Camille Fournier, Conway 1968, engineering blog corpus. - production_discipline.md - On-call (6+ rotation), incidents (4-tier + blameless postmortems), deployment cadence, SLO discipline, 5-level maturity model. Cites Google SRE + SRE Workbook, Allspaw, PagerDuty IR, Charity Majors, Nora Jones, Mikey Dickerson. cs-vpe-advisor agent: throughput-first operator. Voice: "What's your cycle time, and where does the work spend most of its time waiting?" Trusts DORA over vibe. Distinguishes "what to build" (CTO) from "how to ship it" (VPE). /cs:vpe-review slash command: 6-question forcing interrogation (cycle time, DORA verdict, hiring leakage, structure health, production maturity, VPE-vs-CTO scope). Dual-published from the start (per #624 pattern): - Standalone at c-level-advisor/vpe-advisor/ with mirrored content - New marketplace entry: vpe-advisor (category: leadership) - Bundled mirror at c-level-advisor/skills/vpe-advisor/ Updates: - c-level plugin.json: v2.5.4 -> v2.5.5 (33 skills, 13 cs-* agents) - c-level-agents plugin.json: v1.4.0 -> v1.5.0 (13 agents, 21 commands) - marketplace.json: bumped both c-level entries; new VPE standalone entry; +vp-engineering, vpe, dora, delivery-throughput, engineering-hiring, eng-team-structure, production-discipline keywords (38 -> 39 plugins) - c-level CLAUDE.md: VPE row added; counts updated - Root CLAUDE.md: 267->268 skills, 32->33 cs-* agents, 370->373 tools, 502->506 references, 53->54 commands; v2.5.5 highlight section - CHANGELOG.md: v2.5.5 entry with karpathy-discipline rationale Carry-over (still not in scope): cs-general-counsel-advisor voice spec missing from persona-voices.md (multi-PR carry-over); Phase 2 final remainder = CCO-comms (Chief Communications Officer) with naming disambiguation needed. https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
8.8 KiB
8.8 KiB
C-Level Advisory Skills — Claude Code Guidance
A complete virtual board of directors: 28 skills covering 10 executive roles, orchestration, cross-cutting capabilities, and culture & collaboration frameworks — plus the new c-level-agents plugin layer that surfaces 8 cs-* persona agents and 17 /cs:* slash commands on top of the skills.
Architecture
/cs:setup (Founder Interview) → company-context.md
│
Chief of Staff (Router)
│
┌───────────┼───────────┐
10 Roles 6 Cross-Cut 6 Culture
│ │ │
└───────────┼────────────┘
│
Executive Mentor (Critic)
│
Decision Logger (Two-Layer Memory)
Skills Overview
C-Suite Roles (15)
| Role | Folder | Reasoning Technique | Scripts |
|---|---|---|---|
| CEO | ceo-advisor/ |
Tree of Thought | strategy_analyzer, financial_scenario_analyzer |
| CTO | cto-advisor/ |
ReAct | tech_debt_analyzer, team_scaling_calculator |
| COO | coo-advisor/ |
Step by Step | ops_efficiency_analyzer, okr_tracker |
| CPO | cpo-advisor/ |
First Principles | pmf_scorer, portfolio_analyzer |
| CMO | cmo-advisor/ |
Recursion of Thought | marketing_budget_modeler, growth_model_simulator |
| CFO | cfo-advisor/ |
Chain of Thought | burn_rate_calculator, unit_economics_analyzer, fundraising_model |
| CRO | cro-advisor/ |
Chain of Thought | revenue_forecast_model, churn_analyzer |
| CISO | ciso-advisor/ |
Risk-Based | risk_quantifier, compliance_tracker |
| CHRO | chro-advisor/ |
Empathy + Data | hiring_plan_modeler, comp_benchmarker |
| General Counsel | general-counsel-advisor/ |
Risk-Based | contract_risk_scanner, term_sheet_analyzer |
| Chief Data Officer | chief-data-officer-advisor/ |
Decision-Driven | ai_training_data_audit, data_product_strategy_picker, data_asset_valuator |
| Chief AI Officer | chief-ai-officer-advisor/ |
Eval-Demanding | model_buildvsbuy_calculator, ai_risk_classifier, ai_cost_economics |
| Chief Customer Officer | chief-customer-officer-advisor/ |
Retention-Obsessed | retention_decomposition_analyzer, customer_segmentation_designer, cs_coverage_calculator |
| VP of Engineering ⭐ NEW v2.5.5 | vpe-advisor/ |
Throughput-First | delivery_throughput_analyzer, eng_hiring_funnel_calculator, eng_team_structure_designer |
| Executive Mentor | executive-mentor/ |
Adversarial | decision_matrix_scorer, stakeholder_mapper |
Orchestration (6)
| Skill | Folder | Purpose |
|---|---|---|
| C-Suite Onboard | cs-onboard/ |
Founder interview → company-context.md |
| Chief of Staff | chief-of-staff/ |
Routes questions, triggers board meetings |
| Board Meeting | board-meeting/ |
6-phase multi-agent deliberation |
| Decision Logger | decision-logger/ |
Two-layer memory (raw + approved) |
| Agent Protocol | agent-protocol/ |
Inter-agent invocation, loop prevention, quality loop |
| Context Engine | context-engine/ |
Company context loading + anonymization |
Cross-Cutting Capabilities (6)
| Skill | Folder | Purpose |
|---|---|---|
| Board Deck Builder | board-deck-builder/ |
Assembles board/investor updates |
| Scenario War Room | scenario-war-room/ |
Multi-variable what-if modeling |
| Competitive Intel | competitive-intel/ |
Systematic competitor tracking |
| Org Health Diagnostic | org-health-diagnostic/ |
Cross-functional health scoring |
| M&A Playbook | ma-playbook/ |
Acquiring or being acquired |
| International Expansion | intl-expansion/ |
Market entry strategy |
Culture & Collaboration (6)
| Skill | Folder | Purpose |
|---|---|---|
| Culture Architect | culture-architect/ |
Build and operationalize culture |
| Company OS | company-os/ |
EOS/Scaling Up operating system |
| Founder Coach | founder-coach/ |
Founder development and growth |
| Strategic Alignment | strategic-alignment/ |
Strategy cascade, silo detection |
| Change Management | change-management/ |
ADKAR-based change rollout |
| Internal Narrative | internal-narrative/ |
One story across all audiences |
c-level-agents Plugin (v1.0.0 — new in v2.5.0)
A separate plugin at c-level-agents/ that wraps the 10 C-roles with persona agents and slash commands. Founder-mode entry layer.
13 cs-* Agents (in c-level-agents/agents/)
| Agent | Voice | Wraps Skill |
|---|---|---|
| cs-cfo-advisor | Numerate skeptic | cfo-advisor |
| cs-cmo-advisor | Narrative-first | cmo-advisor |
| cs-cro-advisor | Pipeline-paranoid | cro-advisor |
| cs-cpo-advisor | JTBD-driven | cpo-advisor |
| cs-coo-advisor | Execution OS | coo-advisor |
| cs-chro-advisor | People-systems | chro-advisor |
| cs-ciso-advisor | Risk-paranoid | ciso-advisor |
| cs-chief-of-staff | Router & synthesist | chief-of-staff |
| cs-general-counsel-advisor | Risk-paranoid (legal) | general-counsel-advisor |
| cs-cdo-advisor | Decision-driven (data) | chief-data-officer-advisor |
| cs-caio-advisor | Eval-demanding (AI) | chief-ai-officer-advisor |
| cs-cco-advisor | Retention-obsessed (customer) | chief-customer-officer-advisor |
| cs-vpe-advisor ⭐ NEW v2.5.5 | Throughput-first (engineering ops) | vpe-advisor |
Existing cs-ceo-advisor and cs-cto-advisor live in /agents/c-level/ and integrate with the same protocol.
17 /cs:* Slash Commands (in c-level-agents/skills/)
Forcing-question office hours (8): /cs:office-hours, /cs:cfo-review, /cs:cmo-review, /cs:cpo-review, /cs:cro-review, /cs:cto-review, /cs:ciso-review, /cs:gc-review
Strategic sprint pipeline (5): /cs:brief → /cs:boardroom → /cs:decide → /cs:execute → /cs:post-mortem
Meta + safety (4): /cs:founder-mode (auto-router), /cs:onboard (founder interview), /cs:cross-eval (multi-model consensus), /cs:freeze (cooldown lock)
See c-level-agents/README.md for the full plugin guide and c-level-agents/references/persona-voices.md for voice specs.
Executive Mentor Slash Commands
The only skill with a plugin.json (namespace: em) because it has slash commands. Other skills are invoked by name through the Chief of Staff router or directly by the user. This is intentional — only add plugin.json when a skill has dedicated slash commands that need a namespace.
| Command | Purpose |
|---|---|
/em:challenge |
Pre-mortem analysis of any plan |
/em:board-prep |
Board meeting preparation |
/em:hard-call |
Framework for hard decisions |
/em:stress-test |
Stress-test any assumption |
/em:postmortem |
Honest retrospective |
Key Design Decisions
- Two-layer memory: Raw transcripts (reference) + approved decisions only (feeds future meetings). Prevents hallucinated consensus.
- Phase 2 isolation: During board meetings, agents think independently before cross-examination.
- Internal Quality Loop: Self-verify → peer-verify → critic pre-screen → present. No unverified output reaches the founder.
- Proactive triggers: Every role has context-driven early warnings that surface issues without being asked.
- User Communication Standard: Bottom Line → What → Why → How to Act → Your Decision. Results only, no process narration.
Python Tools (25 total)
All scripts are stdlib-only, CLI-first, with JSON output and embedded sample data.
# Examples
python cfo-advisor/scripts/burn_rate_calculator.py
python cro-advisor/scripts/churn_analyzer.py
python cpo-advisor/scripts/pmf_scorer.py
python org-health-diagnostic/scripts/health_scorer.py
python strategic-alignment/scripts/alignment_checker.py
python decision-logger/scripts/decision_tracker.py
Integration with Other Domains
| C-Level Role | Layers Above |
|---|---|
| CMO | marketing-skill/ (content, demand gen, ASO execution) |
| CFO | finance/financial-analyst (spreadsheets, DCF) |
| CRO | business-growth/ (revenue ops, sales engineering) |
| CISO | ra-qm-team/ (ISO 27001 checklists, ISMS audits) |
| CPO | product-team/ (PM toolkit, user stories, sprint planning) |
Last Updated: 2026-05-13 Skills Deployed: 33 skills (15 roles incl. General Counsel, CDO, CAIO, CCO, and VPE + 5 mentor commands + 6 orchestration + 6 cross-cutting + 6 culture) + 21 /cs:* sub-skills in c-level-agents plugin Agents: 15 cs-* (cs-ceo, cs-cto in /agents/c-level/; 13 in c-level-agents/agents/ including new cs-vpe-advisor) Python Tools: 39 (stdlib-only) — +3 with vpe-advisor (delivery_throughput_analyzer, eng_hiring_funnel_calculator, eng_team_structure_designer) Reference Docs: 73 (71 in skills + 2 in c-level-agents/references)