Product Analytics

alirezarezvani/claude-skills/product-team/skills/product-analytics

by alirezarezvani19392f7a0826No license27K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 5 weeks ago

Use when defining product KPIs, building metric dashboards, running cohort or retention analysis, or interpreting feature adoption trends across product stages.

AI-generated overview

Defines product KPIs, designs metric dashboards, and runs cohort, retention, and funnel analysis from CSV data.

What it does
Guides selection of metric frameworks such as AARRR, North Star, and HEART, and defines stage-appropriate KPIs for pre-PMF, growth, and mature products. It covers dashboard layering, cohort and retention curve interpretation, and anti-patterns for metric reporting. A bundled CLI script computes retention, cohort matrices, and funnel conversion from CSV event data with text or JSON output.
When to use it
Use it when defining product KPIs, choosing a metric framework, designing metric dashboards, or interpreting feature adoption and funnel trends. It also fits cohort and retention analysis where retention curves must be compared across cohorts rather than reported as single snapshots.
Requirements
Python 3 to run the bundled scripts/metrics_calculator.py, plus CSV input files in the documented retention/cohort or funnel formats. Reference documents are read by the model; no credentials or network access are described.

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

  1. 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
  1. Define stage-appropriate KPIs
  • Pre-PMF: activation, early retention, qualitative success
  • Growth: acquisition efficiency, expansion, conversion velocity
  • Mature: retention depth, revenue quality, operational efficiency
  1. Design dashboard layers
  • Executive layer: 5-7 directional metrics
  • Product health layer: acquisition, activation, retention, engagement
  • Feature layer: adoption, depth, repeat usage, outcome correlation
  1. 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
  1. 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

  1. Define cohort anchor event (signup, activation, first purchase).
  2. Define retained behavior (active day, key action, repeat session).
  3. Build retention matrix by cohort week/month and age period.
  4. Compare curve shape across cohorts.
  5. 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-patternFix
Vanity metrics — tracking pageviews or total signups without activation contextAlways 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 screenExecutive layer: 5-7 metrics. Feature layer: per-feature only
No decision rule — tracking a KPI with no threshold or action planEvery KPI needs: target, threshold, owner, and "if below X, then Y"
Averaging across segments — reporting blended metrics that hide segment differencesAlways segment by cohort, plan tier, channel, or geography
Ignoring seasonality — comparing this week to last week without adjustingUse 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.

bash
# Retention analysispython3 scripts/metrics_calculator.py retention events.csvpython3 scripts/metrics_calculator.py retention events.csv --format json
# Cohort matrixpython3 scripts/metrics_calculator.py cohort events.csv --cohort-grain monthpython3 scripts/metrics_calculator.py cohort events.csv --cohort-grain week --format json
# Funnel conversionpython3 scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,paypython3 scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,pay --format json

CSV format for retention/cohort:

csv
user_id,cohort_date,activity_dateu001,2026-01-01,2026-01-01u001,2026-01-01,2026-01-03u002,2026-01-02,2026-01-02

CSV format for funnel:

csv
user_id,stageu001,visitu001,signupu001,activateu002,visitu002,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 and attribution

Source:alirezarezvani/claude-skillsinproduct-team/skills/product-analyticsat commit19392f7

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal