From dev-team-kit-fv
Defines tracking plans, event naming conventions, conversion funnels, and product metrics for analytics instrumentation. Use before coding a new feature to ensure measurable success criteria.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dev-team-kit-fv:21-data-analyticsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Uma feature sem medicao e uma aposta sem placar. Esta skill fecha o gap entre "entregamos" e "funcionou": define o tracking plan, o naming, os funis e as metricas — antes de instrumentar, para nao gerar dados que ninguem consegue ler depois.
Uma feature sem medicao e uma aposta sem placar. Esta skill fecha o gap entre "entregamos" e "funcionou": define o tracking plan, o naming, os funis e as metricas — antes de instrumentar, para nao gerar dados que ninguem consegue ler depois.
Esta skill segue GLOBAL.md, policies/execution.md, policies/handoffs.md, policies/quality-gates.md, policies/token-efficiency.md, policies/verification-before-completion.md (evento "instrumentado" exige prova: aparece no debugger/live events da ferramenta) e policies/stack-flexibility.md.
Tracking toca dados de usuario — trate como tal:
Inconsistencia de naming e o que mais apodrece um projeto de analytics. Padrao recomendado: object_action, snake_case, verbo no passado.
| Bom | Ruim | Por que |
|---|---|---|
signup_completed | Completed Signup / signupComplete / user_signed_up | object primeiro agrupa eventos relacionados no dashboard; passado = fato ocorrido |
checkout_started | start_checkout | consistencia: object_action sempre |
subscription_cancelled | cancel | cancel o que? sem objeto e ambiguo |
Regras:
video_played, invite_sent, payment_failedplan_tier, referral_source, error_codelower_snake ou enum fixo, nao texto livre (plan_tier: "pro", nao "Pro Plan!!")_v2 se precisar.Sempre tabela, sempre com owner e criterio de leitura:
| Evento | Dispara quando | Propriedades | Tipo | Owner |
|---|---|---|---|---|
signup_started | usuario abre o form de cadastro | referral_source, plan_tier | funnel | PO |
signup_completed | conta criada com sucesso (server-confirmed) | plan_tier, method (email/google) | funnel, north-star input | PO |
activation_reached | usuario faz a acao "aha" (ex: 1o projeto criado) | time_to_activate_min | north-star | PO |
Dispare no servidor eventos de dinheiro/conversao (signup, purchase) — client-side perde 5-15% por adblock/erro de rede. Eventos de UI/interacao (clique, hover) podem ser client-side.
activation_reached rate). Sem ela, a feature nao tem placar.signup_started (100%) → signup_completed (62%) → activation_reached (28%)
↑ -38% aqui ↑ -34% aqui (maior vazamento)
O maior drop e onde investir.Sign Up, signup, user_signup coexistindo = impossivel agregarpolicies/handoffs.md e, quando util, templates/analytics-plan.mdnpx claudepluginhub felvieira/claude-skills-fv --plugin dev-team-kit-fvInstruments product analytics correctly: event taxonomy, property design, naming conventions, schema versioning, identity stitching, funnel construction, retention cohorts, and fixing instrumentation debt.
Guides SaaS analytics setup: event tracking, key metrics by growth stage, funnels, naming conventions, data quality, and tools like PostHog, Plausible, Mixpanel.
Designs event taxonomies, property schemas, and tracking plans for analytics instrumentation. Scans for tools like PostHog/Mixpanel, maps user journeys, and prioritizes P0 events before coding.