product-analytics-setup
How to actually instrument product analytics correctly. Event taxonomy, property design, naming conventions, schema versioning, identity stitching, funnel design, retention cohorts, North Star metric selection, dashboard hygiene, instrumentation debt, and the failure modes that produce data nobody t…
Install / Use
npx skills add rampstackco/claude-skills --skill product-analytics-setupInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Data & AnalyticsSupported Platforms
Our assessment of product-analytics-setup
product-analytics-setup scores 86/100 on our quality scale, 440th of 604 Data & Analytics skills we index.
Its SKILL.md is 23 KB long, well organised into 18 sections and no code examples: a thorough specification that gives an agent plenty to work with.
It has 902 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so product-analytics-setup is actively maintained.
- Our last check on 2026-11-03 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
product-analytics-setup compared with similar skills
All 4 of these similar skills score higher than product-analytics-setup; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| product-analytics-setup (this skill)by rampstackco | 86 | 902 | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install product-analytics-setup?
- Run
npx skills add rampstackco/claude-skills --skill product-analytics-setup. The install tabs above show the steps for each supported agent. - Which AI agents does product-analytics-setup work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is product-analytics-setup safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is product-analytics-setup still maintained?
- The repository was last updated about 2 months ago, so product-analytics-setup is actively maintained.
Skill content
View source on GitHubname: product-analytics-setup description: "How to actually instrument product analytics correctly. Event taxonomy, property design, naming conventions, schema versioning, identity stitching, funnel design, retention cohorts, North Star metric selection, dashboard hygiene, instrumentation debt, and the failure modes that produce data nobody trusts. Triggers on product analytics setup, event taxonomy, tracking plan, instrumentation, schema versioning, North Star metric, retention cohorts, funnel design, naming conventions, instrument new feature, audit existing analytics, dashboard reconciliation, instrumentation debt, Mixpanel setup, Amplitude setup, PostHog setup, warehouse-native analytics. Also triggers when the team has data but cannot trust it, or when designing instrumentation for a new feature, or when auditing an existing setup that has drifted." category: product catalog_summary: "Instrument product analytics correctly: event taxonomy, properties, naming conventions, schema versioning, funnels, retention cohorts, North Star selection, and the instrumentation debt that compounds without discipline" display_order: 8
Product Analytics Setup
A senior PM and analyst's playbook for instrumenting product analytics correctly the first time.
Most product analytics setups are some combination of inherited mistakes, dashboard sprawl, and events nobody trusts. The team launches a new feature; instrumentation gets bolted on under deadline pressure; naming drifts; properties are inconsistent; six months later nobody can answer simple questions because the answer depends on which event you trust.
This skill is the discipline that prevents that. It assumes you have answered the strategic questions about what to measure (see analytics-strategy). It assumes you have a tool connected (Mixpanel, Heap, PostHog, Amplitude, or warehouse-native via BigQuery, Snowflake, or dbt). The hard part is the systematic execution: naming conventions, property design, schema versioning, funnel construction, cohort definitions, retention measurement.
When to use this skill: setting up product analytics from scratch, auditing an existing instrumentation, fixing a "we have data but cannot trust it" problem, or designing instrumentation for a new feature.
What this skill is for
This skill spans instrumentation execution. It does not cover measurement strategy (use analytics-strategy), experimentation result interpretation (use experimentation-analytics), paid media analytics (use ads-performance-analytics), or platform decisions (use experimentation-platform-orchestrator). Pair this skill with the relevant integrations microsite for your specific tool.
The clean distinction from analytics-strategy. That skill (Growth category) is strategic: what to measure and why, KPI hierarchy, dashboard architecture, attribution models. This skill (Product category) is execution: how to actually instrument the product correctly. The two compose. Read analytics-strategy first to decide what matters; read this skill to instrument it.
The instrumentation hierarchy
The mental model. Every analytics setup is a stack of layers. Each layer depends on the one below it being correct.
- Events are the atomic facts:
user_signed_up,checkout_completed,feature_x_used. - Properties describe events: who, what, where, when, with what context.
- Identities map events to people:
anonymous_id,user_id,account_id. - Cohorts are filters across events: "users acquired via paid in March."
- Funnels are sequences of events: signup, then activated, then first paid action.
- Retention measures repeat behavior: signups still active at week N.
You cannot construct higher levels without correct lower levels. Garbage events produce garbage funnels. The discipline is bottom-up. Most "we have data but cannot trust it" problems trace back to the bottom two layers.
Event taxonomy design
Three rules for event design.
- Past tense, action-oriented.
checkout_completed, notcheckout_completeorcompleting_checkout. Past tense reads as "this happened" rather than as a state. - Object-action format. Noun then verb.
video_played,form_submitted,email_opened. Reading the event name aloud should describe what happened. - Granular but not redundant. Track distinct user actions, not button clicks. Fire
checkout_completedonce at the moment of completion, notsubmit_button_clickedpluscheckout_completed. UI events are noise; semantic events are signal.
The verbs vs states trap.
- Verbs ARE events.
checkout_completed,subscription_canceled,account_upgraded. - States are NOT events; they are properties.
user_status: activeis a property on the user, not an event. Setting state via events ("status_changed_to_active") is a code smell that produces double-counting.
How many events to design. Thirty to fifty events is the sweet spot for a typical SaaS product. Below twenty means under-instrumented; above one hundred almost always means tracking UI noise or duplicating events in different formats.
Detail and a canonical event spec in references/event-taxonomy-template.md.
Property design: event-level vs user-level
Two property types, treated separately.
Event-level properties describe THIS event. The checkout_completed event has properties like cart_value, item_count, payment_method, discount_code. They live on the event payload and are immutable once fired.
User-level properties describe the USER over time. subscription_tier, lifetime_value, acquisition_channel. Set them once on the user profile; the analytics tool joins them onto every event the user fires. They update over time as the user changes.
The trap. Putting user-level properties on every event. Do not track subscription_tier on every event payload; set it once on the user profile and rely on the join. Putting it on the event creates payload bloat, schema drift when the value changes, and reporting confusion when a user upgrades mid-session.
Data type discipline.
- Strings for enums: status, tier, channel, region. Enumerable values where the set is bounded.
- Numbers only for actual numbers: count, value, duration, score. Never use strings for numeric data ("free trial day 7" should be
trial_day: 7). - Booleans for actual booleans:
is_admin,has_trial,is_new_user. Two values; nothing else. - Timestamps in ISO 8601, always. Always. The number of bugs caused by inconsistent date formats is uncountable.
- Arrays rarely. An array property is usually a sign you should split into multiple events with one item per event.
Worked example in references/property-design-patterns.md showing right and wrong design for a product_viewed event.
Naming conventions
Pick ONE convention and enforce it. Three conventions worth picking.
- snake_case for events and properties:
user_signed_up,cart_value. Most platforms default to this; pushback is rarely worth it. - Object-action format for events:
user_signed_up,video_played. Reading the name should describe what happened. - Verb-noun for user properties (or just nouns):
subscription_tier,is_admin,last_active_at.
What NOT to do.
- Mixed case across events.
user_signedUp,User Signed Up,userSignedUpall coexisting in the same project. Pick one and migrate. - Spaces in event or property names. "Sign Up Completed" breaks every URL-encoding scenario and confuses every tool.
- Inconsistent verbs.
user_signed_uppluscompletedCheckoutplusVIEW_PRODUCTin the same project means nobody can predict an event name without looking it up. - Brand names in event names.
mailchimp_email_openedages badly when you switch to Customer.io.
The naming convention reference file provides a complete style guide. Cite it in your team's data contract.
Detail in references/naming-convention-reference.md.
Schema versioning
Schema changes are inevitable. The pattern.
Additive changes are safe. New event, new property on an existing event, new value in an enum. Just ship. Existing dashboards continue to work.
Breaking changes require migration. Renamed event, removed property, changed property type, narrowed enum. These break dashboards downstream; the migration plan is part of the change.
Versioning patterns.
- Append
_v2to events when semantics change.checkout_completed_v2fires alongsidecheckout_completedduring a transition. - Keep old events firing during the transition (90 days is typical). Both versions fire; analytics queries gradually migrate to v2.
- Migrate dashboards to v2 before retiring v1. Then deprecate v1 explicitly with a documentation note.
The data contract idea.
- Document the canonical schema in code: TypeScript interface, JSON Schema, or Protobuf definition.
- Code review every schema change. Schema is product, not afterthought.
- CI lint rejects schema violations before they hit production. The deploy that adds an event with the wrong type fails the build.
Detail in references/schema-versioning-patterns.md.
Funnel design
Funnels measure progression through a sequence. Four rules.
- Order matters. A then B then C is a different funnel from B then A then C. The platform will compute different conversion rates depending on order.
- Time windows matter. Most funnels use a 1 to 30 day window from the first event. Document the window explicitly; "users who completed signup AND activated" is meaningless without "within 14 days."
- Drop-off interpretation is hard. Eighty percent of users dropping at step 2 might be the funnel design (audience is wrong), might be the audience (timing is wrong), or might be the product (genuine drop-off). Investigate before declaring.
- The anchor event pattern. Every funnel starts with a high-intent action: signup, trial start, key feature use. Not a vanity event like
page_vieworsession_start. Vanity-event-anchored funnels show 99% drop-off and tell you nothing.
Common funnel mistakes.
- Funnels that include events firing automatically.
session_startedhappens for every visit; using it as a step inflates the denominator and makes the rest of the funnel meaningless. - Funnels too long (10+ steps). Break into two or three shorter funnels. A 10-step funnel produces near-zero end-to-end conversion that is hard to interpret.
- Funnels with the same event in multiple positions. The platform handles this poorly; the analyst handles it worse.
- Mixing different time windows in one funnel. "Users who signed up within 7 days AND converted within 30 days" is two different cohort definitions glued together.
Common funnel shapes and time-window guidance in references/funnel-design-templates.md.
Cohort definitions
A cohort is a group of users sharing an attribute or behavior. Useful patterns.
- Acquisition cohorts. Users acquired in month X. The standard for retention analysis.
- Behavioral cohorts. Users who completed action Y. Useful for activation analysis ("users who sent first message in week 1").
- Property cohorts. Users with
subscription_tier: pro. Useful for segment-level analysis. - Combined cohorts. Signup in March AND completed onboarding AND in EU. The most common in real analytics work.
Cohort discipline.
- Define cohorts in code (or in your tool's saved-cohort feature) so they are reusable.
- Version them when criteria change. Compare apples-to-apples.
- Do not compare a 30-day-old cohort to a 365-day-old cohort on retention; the older cohort has had more time to retain by definition.
Detail in [references/cohort-definition-patterns.md](references/cohort-defi
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
