Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/monitor-retention.md
Open on GitHub

What 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.md

Call it with /monitor-retention. For all projects use ~/.claude/commands/

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

Similar slash commands

All slash commands for Data and databases →
retention-optimization-expert Maigent retention-optimization-expert turns your retention numbers into an HTML report: cohorts, curves, health scores, churn reasons and a 90-day plan. Useful when churn has to be explained to the team with numbers. CX Codex +1 ★ 1,013repo stars retention-engagement RefoundAI retention-engagement helps identify user churn drivers, track cohort survival curves, and introduce habit mechanics like streaks. Useful when onboarding friction causes early drop-off. CX Codex +1 2,300installs customer-success-and-retention manojbajaj95 customer-success-and-retention — a skill for designing customer retention flows from first value to churn prevention. Maps onboarding milestones, health scoring models, and risk-driven interventions across the full customer lifecycle. CX Codex +1 239installs retention-strategy kostja94 retention-strategy — a skill that sorts out why customers leave, flags the ones about to cancel, and builds retention tactics for each lifecycle stage. CX Codex +1 1,200installs expansion-retention tech-leads-club expansion-retention is a Claude Code skill that analyzes post-sale growth, calculates NRR, diagnoses churn, and identifies expansion triggers from product usage. CX Codex +1 ★ 7,191repo stars retention-optimization appeeky retention-optimization is a Claude Code skill that diagnoses mobile app retention and builds a prioritized action plan. It activates for questions about churn, engagement, user activation, or users who stop returning. CX Codex +1 3,600installs

From the same set224

The whole set →
analyze-sequences analyze-sequences reviews a running or finished email sequence and reports performance, deliverability and test results, with a prioritized action plan. CX Codex +1 ★ 450repo stars launch-coaching-program launch-coaching-program is a Claude Code command that plans and launches multi-week sales coaching cohorts. It schedules sessions, drafts communications, and tracks cohort outcome metrics. CX Codex +1 ★ 450repo stars launch-in-app-experiments launch-in-app-experiments is a Claude Code command that plans in-app tests for activation, engagement, monetization, or retention. CX Codex +1 ★ 450repo stars plan-merchandising-campaign plan-merchandising-campaign builds an omni-channel merchandising campaign plan with offers, creative, and a QA checklist. CX Codex +1 ★ 450repo stars simulate-pricing-impact simulate-pricing-impact is a Claude Code command that models how price changes affect ARR, margin, churn, and expansion by segment, for comparing scenarios before repricing. CX Codex +1 ★ 450repo stars design-packaging design-packaging is a command that builds pricing packages with features, limits, and usage metrics for customer segments. CX Codex +1 ★ 450repo stars prioritize-hypotheses prioritize-hypotheses scores product experiment backlogs with ICE or RICE while factoring in sprint capacity and guardrail readiness. CX Codex +1 ★ 450repo stars trend-research The trend-research skill helps spot cultural moments, audio trends, memes, and creators for social content. Use it when planning timely posts or refreshing a campaign’s creative direction. CX Codex +1 ★ 450repo stars

Project sponsors

Companies that keep this analytics open