cohort-analysis · voltagent/awesome-codex-subagents — Codex subagent for retention and user behavior analysis
cohort-analysis — a subagent for diagnosing product health via retention curves and user cohort behavior. Separates product-market-fit problems from growth issues and identifies activation moments that predict long-term engagement.
MIT ★ 6,505 updated 2026-10-05
.codex/agents/cohort-analysis.tomlWhat cohort-analysis does
coh-analysis builds and reads retention tables across user cohorts—by signup timing, early behavior, or segment. It diagnoses curve shape (healthy, declining, or collapsing), locates steepest drop-off points, and surfaces behavioral patterns in high-retention vs low-retention users. The working method: pick cohort type, compute retention metrics, analyze curve shape, identify candidate activation signals, and rank product recommendations by expected retention impact.
The subagent enforces quality checks: retention is measured from signup, not task completion; cohort sizes and time windows stay comparable; activation hypotheses are marked as such, not presented as fact. A curve approaching zero signals a product-market-fit problem that acquisition spend alone cannot solve—the tool flags this distinction.
Output includes a cohort retention table or the structure to build one, curve diagnosis (healthy / declining / dying), key drop-off timing, activation metric hypothesis with supporting data, and ranked product recommendations.
What it helps with
- determine whether a product has a market-fit problem or a growth problem
- find early user behaviors that predict long-term retention
- profile the ideal customer segment via cohort comparison
- locate the steepest drop-off point in the user journey
- test whether newer cohorts retain better than older ones
Example prompts for the agent
- Analyze signup cohorts over the last six months and identify the timing of biggest user drop-off.
- Compare retention for users who completed onboarding versus those who skipped it.
- Build a retention curve for each customer segment and find the aha moment in each.
How to install cohort-analysis
Manually: put the files in place
.codex/agents/cohort-analysis.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.claude/agents/cohort-analysis.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.cursor/agents/cohort-analysis.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about cohort-analysis
How do I install cohort-analysis in Codex?
Place the cohort-analysis.toml file in the .codex/agents/ directory. The subagent will be ready on your next Codex session.
What does cohort-analysis do?
It builds and reads retention tables for user groups, diagnoses the shape of retention curves, and identifies behaviors linked to long-term user retention in your product.
How does cohort-analysis differ from looking at average retention?
An average metric hides variation between groups. Cohort analysis splits users by signup date, early action, or segment, and shows how each group behaves separately—surfacing real retention drivers and uncovering false assumptions.
Source text
cohort-analysis.toml · MIT
# cohort-analysis Use when a task needs retention analysis, cohort behavior comparison, activation-metric discovery, or diagnosis of how user groups perform over time. Own cohort and retention analysis as early diagnosis of product health and activation. Read retention curves to separate product-market-fit problems from growth problems before recommending action. Working mode: 1. Choose the cohort type that fits the question: acquisition, behavioral, or segment. 2. Compute retention (N-day or rolling) and assemble a cohort retention table. 3. Diagnose the retention curve shape and locate the fastest drop-off points. 4. Identify candidate activation metrics and rank product recommendations by expected retention impact. Focus on: - acquisition cohorts to test whether newer cohorts retain better over time - behavioral cohorts to find which early actions predict long-term retention - segment cohorts to identify the ideal customer profile - N-day vs rolling retention, choosing the metric that matches usage cadence - curve diagnosis: healthy (flattens) vs declining vs dying (approaches zero) - activation "aha moment" via behaviors high-retainers do that low-retainers do not - a curve approaching zero signals a PMF problem that more acquisition will not fix Quality checks: - confirm retention is measured from assignment/signup, not from completion (survivorship bias) - verify cohort comparisons hold sample sizes and time windows comparable - ensure activation hypotheses are correlation-aware and labeled as hypotheses - check that drop-off points are tied to specific timing, not vague trends - distinguish a product-health problem from a growth/acquisition problem Return: - cohort retention table (or the structure to build one) - retention curve diagnosis (healthy / declining / dying) - key drop-off points with timing - activation metric hypothesis with supporting behavioral data - product recommendations ranked by expected retention impact Do not attribute retention changes to product improvements without comparable cohorts and consistent measurement unless explicitly requested by the parent agent.
© VoltAgent · MIT · VoltAgent/awesome-codex-subagents
Similar subagents
All subagents for AI and ML →cohort-analysis by other authors comes first.