run-account-review — Claude Code command: what it does, how to install
run-account-review assembles structured account reviews tracking customer health, churn risks, and expansion plays across your portfolio.
Apache-2.0 ★ 450 updated 2026-04-03
.claude/commands/run-account-review.mdWhat run-account-review does
This command automates account portfolio audits for customer success leadership. It starts by pulling adoption metrics, support tickets, sentiment trends, commercial details, and executive touchpoints. Then it calculates risk indices and identifies advocacy readiness.
The execution delegates specific steps to dedicated helpers. Metric ingestion and scoring run through account-health-analyst, while executive narratives and escalations go to relationship-director. Deliverables align with milestones via success-planner, backed by scoring rubrics from account-health-framework and tactics from expansion-playbook.
Output comes as a narrative packet, a risk tracker, and an assigned list of next steps. You must have the referenced subagents and skills present in your workspace, because the workflow depends on their outputs.
What it helps with
- Consolidate customer sentiment, product adoption, and ticket records into one review
- Calculate churn danger and upsell readiness across specific account tiers
- Assign owners and deadlines for customer success action plans
- Generate an advocacy shortlist to source client references and case studies
Example prompts for the agent
- /account-management:run-account-review --segment strategic --window quarter --include-advocacy true
- /account-management:run-account-review --detail deep-dive --window month
- /account-management:run-account-review --segment enterprise --filters ARR-high
How to install run-account-review
Manually: put the files in place
.claude/commands/run-account-review.mdCall it with /run-account-review. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/run-account-review.mdCall it with /prompts:run-account-review. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/run-account-review.prompt.mdManually: put the files in place
.gemini/commands/run-account-review.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about run-account-review
How to install run-account-review in Claude Code?
Add the command file to your project repository at .claude/commands/run-account-review.md.
What does run-account-review do?
It processes client health signals, calculates churn risks, and prepares a review packet with expansion plays and advocacy candidates.
Which dependencies does this command call?
It orchestrates subagents account-health-analyst, relationship-director, and success-planner, relying on account-health-framework and expansion-playbook skills.
Source text
run-account-review.md · Apache-2.0
--- name: run-account-review description: Produces a structured account review packet with health signals, risks, and expansion plays. usage: /account-management:run-account-review --segment strategic --window quarter --include-advocacy true --- # Command: run-account-review ## Inputs - **segment** – filter accounts by tier/region/vertical. - **window** – time range to analyze (month, quarter, rolling-120d). - **include-advocacy** – true/false to highlight reference potential. - **filters** – optional criteria (product, ARR band, health score). - **detail** – summary | deep-dive to control report depth. ## Workflow 1. **Data Pull** – aggregate adoption, support, sentiment, commercial data, exec engagement, and commitments. 2. **Health & Opportunity Scoring** – update risk/opportunity indices plus advocacy readiness. 3. **Insight Narrative** – summarize key wins, issues, blockers, and expansion ideas per account. 4. **Action Mapping** – assign plays, owners, and deadlines (success plan updates, exec outreach, reference asks). 5. **Distribution** – generate decks/dashboards for CS leadership and account teams. ## Outputs - Account review packet (table + narrative per account). - Risk/opportunity tracker with recommended plays. - Advocacy shortlist with next steps if enabled. ## Agent/Skill Invocations - `account-health-analyst` – runs data + scoring. - `relationship-director` – reviews exec narratives + escalations. - `success-planner` – aligns updates to plan milestones. - `account-health-framework` skill – scoring rubric + thresholds. - `expansion-playbook` skill – suggests plays + advocacy ideas. ---
© gtmagents · Apache-2.0 · gtmagents/gtm-agents