Product Analytics
Define, track, and interpret product metrics across discovery, growth, and mature product stages.
When To Use
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
Workflow
- Select metric framework
- AARRR for growth loops and funnel visibility
- North Star for cross-functional strategic alignment
- HEART for UX quality and user experience measurement
- Define stage-appropriate KPIs
- Pre-PMF: activation, early retention, qualitative success
- Growth: acquisition efficiency, expansion, conversion velocity
- Mature: retention depth, revenue quality, operational efficiency
- Design dashboard layers
- Executive layer: 5-7 directional metrics
- Product health layer: acquisition, activation, retention, engagement
- Feature layer: adoption, depth, repeat usage, outcome correlation
- Run cohort + retention analysis
- Segment by signup cohort or feature exposure cohort
- Compare retention curves, not single-point snapshots
- Identify inflection points around onboarding and first value moment
- Interpret and act
- Connect metric movement to product changes and release timeline
- Distinguish signal from noise using period-over-period context
- Propose one clear product action per major metric risk/opportunity
KPI Guidance By Stage
Pre-PMF
- Activation rate
- Week-1 retention
- Time-to-first-value
- Problem-solution fit interview score
Growth
- Funnel conversion by stage
- Monthly retained users
- Feature adoption among new cohorts
- Expansion / upsell proxy metrics
Mature
- Net revenue retention aligned product metrics
- Power-user share and depth of use
- Churn risk indicators by segment
- Reliability and support-deflection product metrics
Dashboard Design Principles
- Show trends, not isolated point estimates.
- Keep one owner per KPI.
- Pair each KPI with target, threshold, and decision rule.
- Use cohort and segment filters by default.
- Prefer comparable time windows (weekly vs weekly, monthly vs monthly).
See:
references/metrics-frameworks.md
references/dashboard-templates.md
Cohort Analysis Method
- Define cohort anchor event (signup, activation, first purchase).
- Define retained behavior (active day, key action, repeat session).
- Build retention matrix by cohort week/month and age period.
- Compare curve shape across cohorts.
- Flag early drop points and investigate journey friction.
Retention Curve Interpretation
- Sharp early drop, low plateau: onboarding mismatch or weak initial value.
- Moderate drop, stable plateau: healthy core audience with predictable churn.
- Flattening at low level: product used occasionally, revisit value metric.
- Improving newer cohorts: onboarding or positioning improvements are working.
Anti-Patterns
| 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 |
Tooling
scripts/metrics_calculator.py
CLI 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
Cross-References
- Related:
product-team/experiment-designer — for A/B test planning after identifying metric opportunities
- Related:
product-team/product-manager-toolkit — for RICE prioritization of metric-driven features
- Related:
product-team/product-discovery — for assumption mapping when metrics reveal unknowns
- Related:
finance/saas-metrics-coach — for SaaS-specific metrics (ARR, MRR, churn, LTV)
Source: alirezarezvani/claude-skills → product-team/skills/product-analytics/SKILL.md
1---2name: product-analytics3description: Use when defining product KPIs, building metric dashboards, running cohort or retention analysis, or interpreting feature adoption trends across product stages.4---5
6
7# Product Analytics
8
9Define, track, and interpret product metrics across discovery, growth, and mature product stages.
10
11## When To Use
12
13Use this skill for:
14- Metric framework selection (AARRR, North Star, HEART)
15- KPI definition by product stage (pre-PMF, growth, mature)
16- Dashboard design and metric hierarchy
17- Cohort and retention analysis
18- Feature adoption and funnel interpretation
19
20## Workflow
21
221. Select metric framework
23- AARRR for growth loops and funnel visibility
24- North Star for cross-functional strategic alignment
25- HEART for UX quality and user experience measurement
26
272. Define stage-appropriate KPIs
28- Pre-PMF: activation, early retention, qualitative success
29- Growth: acquisition efficiency, expansion, conversion velocity
30- Mature: retention depth, revenue quality, operational efficiency
31
323. Design dashboard layers
33- Executive layer: 5-7 directional metrics
34- Product health layer: acquisition, activation, retention, engagement
35- Feature layer: adoption, depth, repeat usage, outcome correlation
36
374. Run cohort + retention analysis
38- Segment by signup cohort or feature exposure cohort
39- Compare retention curves, not single-point snapshots
40- Identify inflection points around onboarding and first value moment
41
425. Interpret and act
43- Connect metric movement to product changes and release timeline
44- Distinguish signal from noise using period-over-period context
45- Propose one clear product action per major metric risk/opportunity
46
47## KPI Guidance By Stage
48
49### Pre-PMF
50- Activation rate
51- Week-1 retention
52- Time-to-first-value
53- Problem-solution fit interview score
54
55### Growth
56- Funnel conversion by stage
57- Monthly retained users
58- Feature adoption among new cohorts
59- Expansion / upsell proxy metrics
60
61### Mature
62- Net revenue retention aligned product metrics
63- Power-user share and depth of use
64- Churn risk indicators by segment
65- Reliability and support-deflection product metrics
66
67## Dashboard Design Principles
68
69- Show trends, not isolated point estimates.
70- Keep one owner per KPI.
71- Pair each KPI with target, threshold, and decision rule.
72- Use cohort and segment filters by default.
73- Prefer comparable time windows (weekly vs weekly, monthly vs monthly).
74
75See:
76- `references/metrics-frameworks.md`
77- `references/dashboard-templates.md`
78
79## Cohort Analysis Method
80
811. Define cohort anchor event (signup, activation, first purchase).
822. Define retained behavior (active day, key action, repeat session).
833. Build retention matrix by cohort week/month and age period.
844. Compare curve shape across cohorts.
855. Flag early drop points and investigate journey friction.
86
87## Retention Curve Interpretation
88
89- Sharp early drop, low plateau: onboarding mismatch or weak initial value.
90- Moderate drop, stable plateau: healthy core audience with predictable churn.
91- Flattening at low level: product used occasionally, revisit value metric.
92- Improving newer cohorts: onboarding or positioning improvements are working.
93
94## Anti-Patterns
95
96| Anti-pattern | Fix |
97|---|---|
98| **Vanity metrics** — tracking pageviews or total signups without activation context | Always pair acquisition metrics with activation rate and retention |
99| **Single-point retention** — reporting "30-day retention is 20%" | Compare retention curves across cohorts, not isolated snapshots |
100| **Dashboard overload** — 30+ metrics on one screen | Executive layer: 5-7 metrics. Feature layer: per-feature only |
101| **No decision rule** — tracking a KPI with no threshold or action plan | Every KPI needs: target, threshold, owner, and "if below X, then Y" |
102| **Averaging across segments** — reporting blended metrics that hide segment differences | Always segment by cohort, plan tier, channel, or geography |
103| **Ignoring seasonality** — comparing this week to last week without adjusting | Use period-over-period with same-period-last-year context |
104
105## Tooling
106
107### `scripts/metrics_calculator.py`
108
109CLI utility for retention, cohort, and funnel analysis from CSV data. Supports text and JSON output.
110
111```bash
112# Retention analysis
113python3 scripts/metrics_calculator.py retention events.csv
114python3 scripts/metrics_calculator.py retention events.csv --format json
115
116# Cohort matrix
117python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain month
118python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain week --format json
119
120# Funnel conversion
121python3 scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,pay
122python3 scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,pay --format json
123```
124
125**CSV format for retention/cohort:**
126```csv
127user_id,cohort_date,activity_date
128u001,2026-01-01,2026-01-01
129u001,2026-01-01,2026-01-03
130u002,2026-01-02,2026-01-02
131```
132
133**CSV format for funnel:**
134```csv
135user_id,stage
136u001,visit
137u001,signup
138u001,activate
139u002,visit
140u002,signup
141```
142
143## Cross-References
144
145- Related: `product-team/experiment-designer` — for A/B test planning after identifying metric opportunities
146- Related: `product-team/product-manager-toolkit` — for RICE prioritization of metric-driven features
147- Related: `product-team/product-discovery` — for assumption mapping when metrics reveal unknowns
148- Related: `finance/saas-metrics-coach` — for SaaS-specific metrics (ARR, MRR, churn, LTV)
149
150---
151
152**Source:** [`alirezarezvani/claude-skills`](https://github.com/alirezarezvani/claude-skills) → `product-team/skills/product-analytics/SKILL.md`