Defines product KPIs and metric frameworks (AARRR, North Star, HEART) tailored to product stages, designs dashboard hierarchies, and performs cohort, retention, and funnel analysis to interpret feature adoption and user behavior trends.
Say it in your own words; the assistant finds this recipe by itself. Examples:
Use this skill when you need to define or refine product metrics for a specific stage of the product lifecycle (pre-PMF, growth, or mature). It is appropriate for designing executive or product health dashboards, running cohort and retention analyses on event data, and interpreting feature adoption trends to identify drop-off points or success signals.
Define, track, and interpret product metrics across discovery, growth, and mature product stages.
Use this skill for: - Metric framework selection (AARRR, North Star, HEART) - KPI definition by product stage (pre-PMF, growth, mature) - Dashboard design and metric hierarchy - Cohort and retention analysis - Feature adoption and funnel interpretation
HEART for UX quality and user experience measurement
Define stage-appropriate KPIs
Mature: retention depth, revenue quality, operational efficiency
Design dashboard layers
Feature layer: adoption, depth, repeat usage, outcome correlation
Run cohort + retention analysis
Identify inflection points around onboarding and first value moment
Interpret and act
See:
- references/metrics-frameworks.md
- references/dashboard-templates.md
| Anti-pattern | Fix |
|---|---|
| Vanity metrics — tracking pageviews or total signups without activation context | Always pair acquisition metrics with activation rate and retention |
| Single-point retention — reporting "30-day retention is 20%" | Compare retention curves across cohorts, not isolated snapshots |
| Dashboard overload — 30+ metrics on one screen | Executive layer: 5-7 metrics. Feature layer: per-feature only |
| No decision rule — tracking a KPI with no threshold or action plan | Every KPI needs: target, threshold, owner, and "if below X, then Y" |
| Averaging across segments — reporting blended metrics that hide segment differences | Always segment by cohort, plan tier, channel, or geography |
| Ignoring seasonality — comparing this week to last week without adjusting | Use period-over-period with same-period-last-year context |
scripts/metrics_calculator.pyCLI utility for retention, cohort, and funnel analysis from CSV data. Supports text and JSON output.
# Retention analysis
python3 scripts/metrics_calculator.py retention events.csv
python3 scripts/metrics_calculator.py retention events.csv --format json
# Cohort matrix
python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain month
python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain week --format json
# Funnel conversion
python3 scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,pay
python3 scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,pay --format json
CSV format for retention/cohort:
user_id,cohort_date,activity_date
u001,2026-01-01,2026-01-01
u001,2026-01-01,2026-01-03
u002,2026-01-02,2026-01-02
CSV format for funnel:
user_id,stage
u001,visit
u001,signup
u001,activate
u002,visit
u002,signup
product-team/experiment-designer — for A/B test planning after identifying metric opportunitiesproduct-team/product-manager-toolkit — for RICE prioritization of metric-driven featuresproduct-team/product-discovery — for assumption mapping when metrics reveal unknownsfinance/saas-metrics-coach — for SaaS-specific metrics (ARR, MRR, churn, LTV)LICENSESKILL.mdreferences/dashboard-templates.mdreferences/metrics-frameworks.mdscripts/metrics_calculator.pyVendored from alirezarezvani/claude-skills, commit 27cfcd0fb0a4, path product-team/skills/product-analytics, licence MIT. The upstream licence file ships inside the skill.