borghei/product-analytics
> Product analytics for instrumenting products, defining metrics, and building retention funnels. Use when designing a metric tree, instrumenting a feature, auditing instrumentation, defining a North Star, or building an analytics roadmap.
npx skills add https://github.com/borghei/Claude-Skills --skill product-analytics
A product analytics skill focused on decisions from data, not dashboards.
Covers the metric tree, instrumentation patterns, funnel + retention +
cohort analysis, and the operational rituals that turn measurement into
product changes.
Before designing the metric tree or audit, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
metric_tree_designer.py against your candidate tree to surfaceimbalance, missing layers, anti-patterns.
python3 product-analytics/scripts/metric_tree_designer.py \
--input metric_tree.json --format markdown
event_taxonomy_auditor.py to flag PII risk, schema drift,naming inconsistency, duplication, undocumented events, and gaps.
python3 product-analytics/scripts/event_taxonomy_auditor.py \
--input event_inventory.json --format markdown
retention_cohort_analyzer.py to compute retention rates, identifypatterns (smile curve, leaky bucket), and surface cohort-level alerts.
python3 product-analytics/scripts/retention_cohort_analyzer.py \
--input retention.json --format markdown
A good North Star metric:
Common patterns by product type:
| Product type | Common North Star |
|--------------|-------------------|
| Communication / messaging | Messages sent per WAU |
| Marketplace | Successful transactions per MAU |
| Content | Hours of meaningful content consumed |
| Productivity SaaS | Activated workspaces × engagement depth |
| Consumer payments | Active payment senders per week |
| Developer tool | Weekly active developers performing core action |
Don't pick "DAU" or "Revenue" as North Star — they're outputs, not value drivers.
A clean metric tree has three layers:
Plus a guardrails / counter-metrics sidebar (3–5 that catch
unintended consequences).
If you have 30 KPIs at the top level, you have no top level.
For any new product or feature, ask: "What does it look like when a user
realizes value from this?"
That's the activation event. A clear definition makes:
Common mistake: defining activation as "completed signup." Signup is
table stakes; activation is the moment of value.
| Shape | Diagnosis | Action |
|-------|-----------|--------|
| Power-law smile | Healthy product-market fit | Invest in scale |
| Slow decay then flat | Product-market fit | Investigate the flatline cohort segment |
| Steep then zero | Novelty product | Re-evaluate the value proposition |
| Linear decline | Leaky bucket | Improve retention features |
| Inverted (rising) | Network effects kicking in | Acquire harder |
Read shape before reading numbers.
| Metric | Vanity if | Actionable if |
|--------|-----------|---------------|
| DAU / MAU | Tracked alone | Decomposed by segment, action |
| Pageviews | Tracked alone | Tied to conversion funnel |
| Total revenue | Tracked alone | Decomposed by cohort, channel, segment |
| App downloads | Tracked alone | Paired with activation rate |
| Total accounts | Tracked alone | Paired with active accounts |
The test: "If this metric goes up 10% next week, what do we change?"
If you don't have an answer, it's vanity.
references/metric-tree-and-north-star.md — patterns by product type, tree structure, anti-patternsreferences/instrumentation-and-event-design.md — event taxonomy, naming, PII, schema disciplinereferences/cohort-retention-and-funnel-analysis.md — analysis techniques, segmentation, anti-patternsproduct-team/ab-test-setup — experimentation (paired with metrics)product-team/product-strategist — strategy upstream of metricsdata-analytics/ skills — for the data engineering sideengineering/data-quality-auditor — for instrumentation data qualityc-level-advisor/chief-data-officer-advisor — for platform decisionsTake borghei/product-analytics from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.