Skip to main content
subagent CX Codex

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

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/cohort-analysis.toml
Open on GitHub

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

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/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.

cohort-analysis VoltAgent Community cohort-analysis — a Claude Code subagent that investigates retention trends, builds cohort matrices, and isolates product activation metrics from project data. CX Codex ★ 26,718repo stars ab-test-analysis VoltAgent Community Subagent for A/B test analysis: interprets p-values, calculates confidence intervals, and helps decide whether to ship a change to production. CX Codex ★ 26,718repo stars product-analytics Alireza Rezvani The product-analytics skill helps define product KPIs, shape metric dashboards, and read cohort, retention, and feature adoption data. CX Codex +1 684installs tooluniverse-epidemiological-analysis mims-harvard The tooluniverse-epidemiological-analysis skill takes observational epidemiology from a PECO question to a statistical report, generating Python code for the analysis. CX Codex +1 258installs cohort-analyst YujxZJCN cohort-analyst turns ability lists, entry diagnostics and pre-lesson surveys into teaching decisions. Reports stay at cohort level. CX Codex +1 ★ 49repo stars signals-scout-product-analytics PostHog signals-scout-product-analytics — a skill for Claude Code and Codex monitoring core product analytics flows in PostHog. Detects derived-rate regressions across funnels and retention while entrant volume holds steady. CX Codex +1 204installs research-analyst VoltAgent Community research-analyst gathers data across the web and project files, synthesizes findings into structured reports, and extracts actionable insights for strategic decisions. CX Codex 575installs

From the same set176

The whole set →
first-principles-thinking The first-principles-thinking subagent strips a problem down to basic facts, tests its assumptions, and rebuilds the solution. Use it when the current approach may be misleading. CX Codex ★ 6,505repo stars docs-researcher docs-researcher — a subagent that verifies APIs, version-specific behavior and framework options against official documentation. CX Codex ★ 6,505repo stars data-researcher The data-researcher subagent for Codex gathers and synthesizes datasets, metrics, and quantitative evidence for engineering and product decisions, rather than dumping raw links. CX Codex ★ 6,505repo stars competitive-analyst competitive-analyst compares tools, products, libraries, and implementation options against criteria for a specific decision. Useful when adoption and maintenance matter as much as features. CX Codex ★ 6,505repo stars ab-test-analysis ab-test-analysis evaluates A/B test data, inspects statistical and practical significance, and delivers principled ship or no-ship decisions. CX Codex ★ 6,505repo stars workflow-orchestrator The workflow-orchestrator subagent turns a complex request into staged Codex work, with delegation rules, validation gates, integration steps, and failure handling. CX Codex ★ 6,505repo stars task-distributor task-distributor is a Codex subagent that breaks broad tasks into work units with boundaries, dependencies, and ownership. It divides work across agents without duplication or overlap. CX Codex ★ 6,505repo stars performance-monitor performance-monitor triages build, runtime, and operational metrics, weeds out noise, and pinpoints responsible subsystems before heavy profiling starts. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open