monitor-retention — Claude Code command: setup and features
monitor-retention generates cohort retention dashboards, risk signal summaries, and customer save plays directly in Claude Code.
Apache-2.0 ★ 450 updated 2026-04-03
.claude/commands/monitor-retention.mdWhat monitor-retention does
The command automates customer retention review across chosen dimensions. It pulls records across product telemetry, billing, customer support, and pipeline sources to calculate churn, net retention, and expansion figures per segment.
Under the hood, the workflow coordinates retention-analyst, segmentation-architect, and customer-insights-partner agents alongside retention-dashboard and save-play-library skills. It outputs interactive dashboards, executive decks, or briefs paired with an action tracker assigning clear owners and due dates.
Execution assumes active access to your telemetry and billing systems, as the cohort calculations rely on direct queries against real customer data.
What it helps with
- calculate churn and expansion rates across account tiers or regions
- detect at-risk customer cohorts with quantified revenue impact
- assign targeted save plays with owners and delivery deadlines
- prepare cohort health summaries for executive leadership reviews
Example prompts for the agent
- /customer-analytics:monitor-retention --window quarter --grouping "plan,persona" --include-expansion true
- /customer-analytics:monitor-retention --window rolling-90d --grouping region --format brief
- /customer-analytics:monitor-retention --window month --signals "usage,billing" --format dashboard
How to install monitor-retention
Manually: put the files in place
.claude/commands/monitor-retention.mdCall it with /monitor-retention. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/monitor-retention.mdCall it with /prompts:monitor-retention. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/monitor-retention.prompt.mdManually: put the files in place
.gemini/commands/monitor-retention.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about monitor-retention
How to install monitor-retention in Claude Code?
Place the command specification file into .claude/commands/monitor-retention.md inside your repository.
What does monitor-retention do?
It aggregates usage and billing inputs, computes cohort retention metrics, flags emerging churn signals, and produces remediation action plans.
Which arguments does the command support?
It accepts window (month, quarter, rolling-90d), grouping dimensions, include-expansion boolean flag, optional metric signals, and target format (dashboard, deck, or brief).
Source text
monitor-retention.md · Apache-2.0
--- name: monitor-retention description: Builds retention dashboards, signal briefs, and recommended save plays per cohort. usage: /customer-analytics:monitor-retention --window quarter --grouping "plan,persona" --include-expansion true --- # Command: monitor-retention ## Inputs - **window** – analysis window (month, quarter, rolling-90d). - **grouping** – comma-separated dimensions (plan, persona, region, product, acquisition-channel). - **include-expansion** – true/false to show upsell impact alongside churn. - **signals** – optional list of metrics to emphasize (usage, support, sentiment, billing). - **format** – dashboard | deck | brief. ## Workflow 1. **Data Refresh** – query billing, product telemetry, support, survey, and pipeline sources. 2. **Cohort Calculations** – compute retention, churn, expansion, and health indexes per grouping. 3. **Signal Detection** – surface top risk/improvement cohorts with quantified impact. 4. **Play Recommendations** – map cohorts to lifecycle or CS save plays with owners. 5. **Packaging** – produce dashboards/decks plus action trackers for leadership reviews. ## Outputs - Retention dashboard with drillable cohorts. - Signal brief highlighting risks/opportunities + recommended plays. - Action tracker with owners, due dates, and success metrics. ## Agent/Skill Invocations - `retention-analyst` – leads analytics + insights. - `segmentation-architect` – ensures segment definitions align. - `customer-insights-partner` – adds qualitative proof. - `retention-dashboard` skill – provides visualization templates. - `save-play-library` skill – links insights to remediation programs. ---
© gtmagents · Apache-2.0 · gtmagents/gtm-agents