claude-skills/c-level-advisor/CLAUDE.md
Claude c7a0fe865a
feat(chief-customer-officer-advisor): retention-obsessed CCO skill (v2.5.4)
Fourth decision-driven C-role skill in the founder-mode lineup (after GC,
CDO, CAIO). Opinionated CCO covering 4 specific decisions, not a generic
customer success survey:

  1. What's our retention architecture - is GRR vs NRR honest?
  2. How do we segment customers for differential investment?
  3. What's the CS team's coverage model - pooled vs named, when to switch?
  4. What CS role do we hire next? (CSM != Support != AM != IM)

Built under karpathy-coder discipline (4th consecutive PR):
- Assumptions surfaced upfront (CRO vs CCO split: revenue math vs customer
  experience)
- Each tool/reference covers ONE decision; no overlap with business-growth
- 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:

- retention_decomposition_analyzer.py - Decomposes ARR by cohort into
  GRR/NRR/Logo separately. Flags leaky-bucket pattern (NRR > 100% AND
  GRR < 85%). 7-category churn root-cause taxonomy with preventable %.
  Sample: Q1 GRR 91.7% CONCERNING (NRR 106.7%), Q2 GRR 84.7% CRITICAL,
  top driver = product_fit at 54.5% preventable.
- customer_segmentation_designer.py - 4-tier framework (Strategic /
  Enterprise / Mid-market / SMB-long-tail) with ICP fit scoring (7
  weighted signals). Surfaces kill list (support cost > 50% of ARR AND
  ICP fit < 5) + upgrade candidates. Sample: 5 customers tiered, 1 kill
  candidate, 2 upgrades. Strategic tier = 76.7% of ARR (Pareto).
- cs_coverage_calculator.py - CSM headcount per tier with dual constraints
  (ARR ratio + account count, whichever binds). Manager-trigger thresholds.
  12-month hiring plan with quarterly sequencing. Sample: 4 current ->
  12 needed at 40% growth, $2.25M annual cost, 8 hires planned.

4 in-depth references each citing 5+ authoritative sources:

- retention_decomposition.md - GRR vs NRR math, leaky-bucket pattern,
  7-category churn taxonomy, leading-indicator playbook. Cites
  Mehta/Steinman/Murphy, Lincoln Murphy, David Skok, BVP, ChartMogul,
  Reichheld, Tunguz.
- customer_segmentation_strategy.md - 4-tier framework, ICP fit (7
  signals), tier transition triggers, kill list criteria. Cites Lincoln
  Murphy, Bain Loyalty Effect, Tunguz, Skok, ChartMogul, Challenger Customer.
- cs_coverage_model.md - 4 coverage models with ratios by stage/segment,
  manager-trigger, comp design, ramp curves. Cites Gainsight, TSIA,
  Mehta/Pickens, ChurnZero, Skok, KeyBanc SaaS survey.
- cs_team_org_evolution.md - 5-stage role map, 6-role distinction table
  (CSM/Support/AM/IM/CS Ops/Customer Marketing), AM-vs-CSM split, 7
  anti-patterns. Cites Mehta/Steinman/Murphy, Mehta/Pickens, BVP, TSIA,
  Gainsight, ChurnZero, Lincoln Murphy.

cs-cco-advisor agent: retention-obsessed pragmatist. Voice: "What's your
gross retention rate, and what's the #1 reason customers leave?" Trusts
GRR over NRR. Refuses to recommend CS hires without naming the customer
outcome they unblock.

/cs:cco-review slash command: 6-question forcing interrogation (GRR truth,
top churn driver, time-to-value, kill-list candidates, ARR-per-CSM
ratio + coverage model, CS comp alignment).

Dual-published from the start (matching the #624 pattern):
- Standalone wrapper at c-level-advisor/chief-customer-officer-advisor/
  with mirrored content
- New marketplace entry: chief-customer-officer-advisor
- Bundled mirror at c-level-advisor/skills/chief-customer-officer-advisor/

Updates:
- c-level plugin.json: v2.5.3 -> v2.5.4 (32 skills, 12 cs-* agents)
- c-level-agents plugin.json: v1.3.0 -> v1.4.0 (12 agents, 20 commands)
- marketplace.json: bumped both c-level entries; new CCO standalone entry;
  +chief-customer-officer, cco, retention-decomposition, customer-segmentation,
  cs-coverage keywords (marketplace plugins: 37 -> 38)
- c-level CLAUDE.md: CCO row added; agent + count tables updated
- Root CLAUDE.md: 266->267 skills, 31->32 cs-* agents, 367->370 tools,
  498->502 references, 52->53 commands; v2.5.4 highlight section
- CHANGELOG.md: v2.5.4 entry with karpathy-discipline rationale

Carry-over (still not in scope): cs-general-counsel-advisor voice spec
missing from persona-voices.md; Phase 2 remainder (VPE, CCO-comms).

Disclaimer in every output: retention benchmarks vary significantly by
ACV/segment/industry; B2B SaaS-baseline guidance only.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
2026-05-13 05:39:46 +00:00

8.6 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 (14)

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 NEW v2.5.4 chief-customer-officer-advisor/ Retention-Obsessed retention_decomposition_analyzer, customer_segmentation_designer, cs_coverage_calculator
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.

12 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 NEW v2.5.4 Retention-obsessed (customer) chief-customer-officer-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: 32 skills (14 roles incl. General Counsel, CDO, CAIO, and CCO + 5 mentor commands + 6 orchestration + 6 cross-cutting + 6 culture) + 20 /cs:* sub-skills in c-level-agents plugin Agents: 14 cs-* (cs-ceo, cs-cto in /agents/c-level/; 12 in c-level-agents/agents/ including new cs-cco-advisor) Python Tools: 36 (stdlib-only) — +3 with chief-customer-officer-advisor (retention_decomposition_analyzer, customer_segmentation_designer, cs_coverage_calculator) Reference Docs: 69 (67 in skills + 2 in c-level-agents/references)