Communitygithub.com

amplitude/builder-skills

Decomponha uma métrica principal em uma árvore de métricas quantificada com relações matemáticas, dimensione cada nó e identifique onde está a verdadeira alavancagem. Use quando um gerente de produto precisar entender o que impulsiona uma métrica, onde focar ou onde NÃO focar.

O que é builder-skills?

Esta skill guia você na construção de uma árvore de métricas — uma decomposição estruturada de uma métrica principal (como Usuários Ativos Semanais) em seus componentes matemáticos, revelando onde está o volume real e a alavancagem. Diferente de diagramas superficiais, a skill exige que cada nó seja dimensionado com valores atuais ou estimativas, forçando decisões baseadas em dados em vez de intuição. Ela suporta qualquer plataforma onde você possa descrever seu produto e dados (funciona como um prompt standalone para Claude, Cursor, Codex e similares). O processo inclui cinco etapas: definir a hierarquia de métricas (NSM, KPI de negócio e a métrica tática crítica), decompor em uma árvore com operações de adição e multiplicação, dimensionar cada nó, validar a qualidade das métricas e, finalmente, identificar o nó de maior alavancagem (e os anti-alavancas). A saída é uma análise direta e quantitativa que ajuda equipes de produto a decidir onde investir e o que ignorar, prevenindo o desperdício de recursos em métricas de baixo impacto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/growth-skills/skills/build-metric-tree

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Construa uma Árvore de Métricas

Decomponha uma métrica principal em uma árvore de sub-métricas com matemática real, dimensione cada nó e identifique onde a alavancagem realmente está — e onde não está.

Você quer mover um número, mas não tem certeza de onde focar. Uma árvore de métricas força você a dividi-lo em suas partes componentes, entender as relações matemáticas entre elas e encarar onde está o volume real. O resultado não é apenas um diagrama — é uma decisão sobre onde investir e o que ignorar.


Template de Prompt

Você é um estrategista de produto com mentalidade de crescimento e rigoroso sobre decomposição quantitativa. Você é alérgico a pensamentos ilusórios e sempre segue o volume.

Aqui está no que estou trabalhando:

<context>
$ARGUMENTS
</context>

> Se o acima estiver em branco, pergunte ao usuário: "{{DESCREVA SUA MÉTRICA PRINCIPAL, SEU PRODUTO E QUAISQUER DADOS QUE VOCÊ TEM — por exemplo, valores atuais, segmentos, decomposições conhecidas ou uma meta que você está tentando atingir}}"

Ajude-me a construir uma árvore de métricas. Siga estes passos precisamente:

### Passo 1: Estabeleça a Hierarquia de Métricas

Comece identificando três métricas complementares que devem estar em tensão:

- **Métrica North Star (NSM):** A métrica que captura o valor agregado entregue aos clientes. Isso não é receita — é a coisa que, se aumentar, significa que os clientes estão obtendo mais valor (ex.: "analistas ativos semanais," "painéis criados," "consultas executadas").
- **KPI de Negócio Principal:** A métrica que captura o valor de volta para o negócio (ex.: receita, assentos pagos, ARR de expansão). Ela deve estar estruturalmente conectada à NSM — se a NSM aumenta mas o KPI de negócio não, há um problema de monetização.
- **Uma Métrica que Importa (OMTM):** A única métrica tática na qual a equipe deve se obcecar no momento. Ela emergirá da árvore — é o nó com maior alavancagem.

Se o usuário já definiu essas métricas, confirme-as. Se não, proponha candidatos e explique os trade-offs.

### Passo 2: Decomponha em uma Árvore

Divida a NSM (ou qualquer métrica principal que o usuário especificar) em suas partes componentes. Para cada ramo:

- **Declare a relação matemática explicitamente.** Use adição (+) para componentes que somam ao pai (ex.: MAU = Novos Usuários + Usuários Recorrentes + Usuários Reativados). Use multiplicação (x) para relações baseadas em taxas (ex.: Novos Usuários = Visualizações da Loja x Taxa de Conversão).
- **Vá de 2 a 3 níveis de profundidade.** Pare quando alcançar métricas que uma única equipe poderia possuir e influenciar diretamente.
- **Marque ramos de hipótese.** Se uma relação é assumida mas não comprovada (ex.: "acreditamos que a retenção é impulsionada por usuários que completam a integração na primeira sessão"), sinalize-a como uma hipótese que precisa de validação. Distinga-as claramente de decomposições definicionais.

Apresente a árvore em um formato de texto estruturado como:

NSM: Usuários Ativos Semanais (WAU) = 50.000 ├── [+] Novos Usuários: 8.000 │ ├── [x] Cadastros: 20.000 │ │ ├── [+] Orgânicos: 14.000 │ │ └── [+] Pagos: 6.000 │ └── [x] Taxa de Ativação: 40% ├── [+] Usuários Recorrentes: 38.000 │ └── [x] WAU Anterior x Taxa de Retenção: 45.000 x 84% └── [+] Usuários Reativados: 4.000 └── [x] Pool Inativo x Taxa de Reativação: 80.000 x 5%


### Passo 3: Dimensione Cada Nó

Para cada nó na árvore, inclua o valor atual (ou a melhor estimativa). Isso é inegociável — uma árvore não dimensionada é apenas um diagrama. Se o usuário não tiver números exatos, trabalhe com ele para estimar usando quaisquer dados disponíveis.

O dimensionamento revela a alavancagem. Uma melhoria de 50% em um nó pequeno pode ser menos impactante do que uma melhoria de 5% em um nó enorme. Faça a matemática explicitamente.

### Passo 4: Valide a Qualidade das Métricas

Para cada métrica na árvore, avalie rapidamente contra estes critérios. Sinalize qualquer uma que falhe:

- **Tangível:** Representa uma meta real e compreensível?
- **Controlável:** A equipe consegue realmente influenciá-la?
- **Feedback rápido:** Ela se move rápido o suficiente para aprender?
- **Testável:** Você pode testar mudanças nela com A/B?
- **Explicável:** Quando ela se move, você consegue entender por quê?
- **Difícil de manipular:** A equipe poderia atingir o número por meios perversos? Se sim, defina uma contra-métrica.
- **Prefira contagens absolutas em vez de médias/porcentagens.** Médias escondem volume. "A duração média da sessão aumentou 20%" não significa nada se o total de sessões caiu 50%. Sempre emparelhe taxas com seus denominadores.

### Passo 5: Identifique a Alavanca (e as Anti-Alavancas)

Este é o passo mais importante. Com base na árvore dimensionada:

1. **Onde está a alavancagem?** Qual nó, se melhorado, produziria o maior impacto absoluto na métrica principal? Mostre a matemática. "Melhorar a taxa de ativação de 40% para 50% em 20.000 cadastros = 2.000 WAU adicionais."

2. **Onde NÃO está?** Explicitamente mencione nós que são tentadores mas de baixa alavancagem. Seja direto: "A reativação parece atraente, mas o pool inativo é pequeno — mesmo dobrando a taxa de reativação, adiciona apenas 4.000 WAU." Esta é a verificação de "não seja ilusório".

3. **Onde estão os olhos?** Para crescimento impulsionado pelo produto, você tem que ir para onde os usuários já estão. Não construa estratégias em torno de superfícies que ninguém visita ou fluxos que ninguém completa. Se 65% dos seus usuários são clientes empresariais usando recursos no produto, é aí que está a alavancagem — não em uma integração de nicho usada por 3% dos usuários.

4. **Recomende a OMTM.** Com base na análise, recomende a métrica única na qual a equipe deve focar agora, e explique por que ela é o nó de maior alavancagem.

### Formato de Saída

Entregue:
1. A hierarquia de métricas (NSM, KPI de negócio, recomendação de OMTM)
2. A árvore dimensionada completa em formato de texto
3. Uma seção "Análise de Alavancagem" com a matemática sobre onde focar e onde não focar
4. Quaisquer sinalizações de qualidade de métrica
5. Perguntas em aberto — quais hipóteses precisam de validação, quais dados estão faltando

Seja direto. Seja quantitativo. Desafie o usuário se o instinto dele não corresponder à matemática.

Dicas

  • Traga dados. Quanto mais números reais você puder fornecer (DAU, taxas de conversão, decomposições por segmento), mais útil será a árvore. Mesmo estimativas aproximadas são melhores do que nada.
  • Se você tiver painéis Amplitude com as métricas relevantes, compartilhe os números. A skill funciona melhor quando cada nó é dimensionado.
  • Use isso antes de definir metas trimestrais — impede que as equipes escolham métricas nas quais não conseguem realmente mexer o ponteiro.
  • Combine com craft-experiment-design depois de identificar a alavanca — desenhe um experimento para validar sua hipótese sobre o nó de maior alavancagem.
  • Revisite a árvore trimestralmente. À medida que você implementa mudanças, o tamanho relativo dos nós muda e a alavancagem pode se deslocar.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

amplitude/builder-skills

Performs deep analysis of a specific Amplitude chart to explain trends, anomalies, and likely drivers. Use when a metric looks unusual, investigating a spike or drop, or understanding the "why" behind numbers.

amplitude/builder-skills

Deeply analyze Amplitude dashboards by analyzing key charts, surfacing top areas for concern and takeaways, identify anomalies, then explain changes using customer feedback trends.

amplitude/builder-skills

Designs A/B tests with proper metrics and variants, analyzes running or completed experiments, and interprets results with statistical rigor. Use when setting up experiments, checking experiment status, analyzing results, or making ship decisions.

amplitude/builder-skills

Synthesizes customer feedback into actionable themes including feature requests, bugs, pain points, and praise. Use when planning product roadmap, understanding user sentiment, investigating specific issues, or preparing voice-of-customer reports.

amplitude/builder-skills

Analyze MCP server usage instrumented with Amplitude's MCP Analytics SDK: break usage and errors down by tool, read the rationales within each tool to see what callers are trying to do, and produce a prioritized write-up of actionable fixes. Use this skill whenever the user asks to understand how their MCP server is being used, what agents/users are trying to do with it, why tool calls are failing, what to fix or improve in their MCP server, or asks for an "MCP usage report", "tool error analysis", "intent analysis", "rationale clustering", or "MCP insights". Also trigger when the user mentions [MCP]-prefixed events, tool rationale, tool call errors, or just finished instrumenting their MCP server and wants to see what the data says. Requires the Amplitude MCP connector.

amplitude/builder-skills

Read lost deals and churned accounts from your CRM, extract reasons clustered by theme (missing features, pricing, competitors, UX), and write a prioritized weekly analysis with product improvement recommendations. Use before roadmap planning or to build the case for prioritizing retention work.

amplitude/builder-skills

Creates Amplitude charts from natural language descriptions, handling event selection, filters, groupings, and visualization choices. Use when you know what you want to measure but prefer not to build the chart manually.

amplitude/builder-skills

Guide an Amplitude user through building a custom agent by suggesting use cases grounded in their role and data, shaping the idea into a well-formed spec, and generating a ready-to-run Global Agent deeplink that creates it. Use to create, build, or set up a custom agent, automate a recurring analysis, or put a repeated report on a schedule.

amplitude/builder-skills

Builds comprehensive Amplitude dashboards from requirements or goals, organizing charts into logical sections with appropriate layouts. Use when creating a complete dashboard from scratch or assembling existing charts into a cohesive view.

amplitude/builder-skills

Monitors all active and recently completed experiments across Amplitude projects, triages them by importance, then runs deep analysis and reporting on the most impactful ones. Use when the user asks to "check on experiments", "experiment status", "experiment review", "what experiments are running", or wants a periodic experiment health report.

amplitude/builder-skills

Pull Intercom tickets and Slack support messages from the past 7 days, classify each signal, enrich with CRM data (ARR, plan, renewal), score by customer value and churn risk, and output a tiered priority report saved to Drive. Use when you need a fast, data-driven view of what support signals matter most.

amplitude/builder-skills

Use this skill whenever a user wants to improve existing pages on their website to get cited more by AI models — whether they say "our pages aren't getting cited", "improve this page for AI visibility", "which of our pages should we update", "make this article more cite-worthy", "our competitors are getting cited instead of us", "update our content for AI search", or any variation where the goal is improving an existing asset rather than creating something new. This skill pulls owned pages from AI Visibility, identifies which ones have citation potential but are underperforming, compares them against the external pages that are winning citations on the same topics, and produces section-level rewrites or a full-page update — then pushes the revision to the CMS as a draft. Trigger even if the user just says "help me get cited more" or "why is [competitor] getting cited instead of us".

amplitude/builder-skills

Use this skill whenever a user wants to win AI citations on prompts that competitors currently dominate — whether they say "competitors are getting cited instead of us", "we're losing on these prompts", "how do I outrank [competitor] in AI answers", "find prompts where we should be winning", "create content to beat [competitor]", or any variation where the goal is capturing AI share on prompts a competitor currently owns. This skill pulls competitor visibility data from AI Visibility, identifies the specific prompts where competitors win and Amplitude is absent, clusters them by intent, and produces targeted comparison pages, alternatives content, or rebuttal assets — then pushes drafts to CMS. Trigger on any mention of competitor, prompt hijack, outrank, or "why is [competitor] getting cited instead of us".

amplitude/builder-skills

Use this skill whenever a user wants to turn AI Visibility data into published content — whether they say "find content gaps", "what should we write about", "which topics have low visibility", "help me get cited by AI models", "create a blog post from our AI Visibility gaps", "we're losing to competitors on these prompts", or any variation where they want to go from AI visibility weakness to a draft article, landing page, or FAQ. This skill connects directly to Amplitude AI Visibility data (topics, prompts, visibility scores, citations, competitor data, full LLM responses and sources) and produces a publish-ready content brief plus full article draft. If the user mentions CMS (WordPress, Webflow, Contentful, Sanity, HubSpot, Ghost, Shopify), also trigger this skill to push the draft directly. Trigger even if they just say something vague like "what content should we create?" in an AI Visibility context.

amplitude/builder-skills

Use this skill whenever a user wants to test content variants before publishing to find which one will get cited most by AI models — whether they say "which version of this content will perform better", "test this article before we publish", "simulate how AI will respond to this content", "which angle should we use", "generate content variants and pick the winner", "run a simulation before publishing", or any variation where the goal is data-driven content selection rather than gut-feel publishing. This skill takes an identified content opportunity, generates 2–3 distinct variants with different angles or structures, scores them against actual AI model responses from AI Visibility, references the Simulate Changes feature for pre-publish validation, and produces a clear recommendation on which variant to publish — then pushes the winner to CMS. Trigger on any mention of "simulate", "test variants", "which performs better", "A/B content", or "before we publish".

amplitude/builder-skills

Use this skill whenever a user wants to understand which external sources are being cited by AI models on topics relevant to their brand, and wants to create content that will outrank those sources — whether they say "what sources are AI models citing", "why is [third-party site] being cited instead of us", "we want to be the definitive source on X", "build something that gets cited more than G2 or TechRadar", "create an authoritative asset", or any variation where the goal is producing a new reference asset (definition page, benchmark, methodology, glossary, comparison hub) designed to beat existing top-cited sources. This skill analyzes AI Visibility source data, reverse-engineers what makes top-cited pages authoritative, and produces a superior source asset — then pushes it to CMS as a draft. Trigger on any mention of "sources", "third-party citations", "authoritative content", "definitional pages", or "outrank".

amplitude/builder-skills

Instrument a Node/TypeScript MCP server with Amplitude's @amplitude/mcp-analytics SDK so tool calls, sessions, and rationale are tracked as Amplitude events. Use this skill whenever the user wants to add Amplitude analytics to their MCP server, mentions "MCP Analytics", "@amplitude/mcp-analytics", "instrument my MCP server", "track MCP tool calls", "add rationale to my MCP tools", or wants agent traffic (Claude, Cursor, ChatGPT) attributed back to Amplitude. Also use for adding UTM tagging to MCP-returned links, or for troubleshooting identity/user_id mismatches between MCP events and web/mobile Amplitude data.

amplitude/builder-skills

Instruments a pull request with Amplitude analytics that conform to the project's existing taxonomy. Reads the tracking plan via the Amplitude MCP server (events, properties, naming conventions), analyzes the PR diff to find the few user actions genuinely worth tracking, detects the codebase's SDK and tracking patterns, and adds instrumentation that matches both. Optionally (opt-in) stages new events and properties on an Amplitude tracking-plan branch for data-governance review. Use when asked to "instrument this PR", "add analytics to this change", "add tracking", "add Amplitude events", "instrument this feature", or "what should I track here".

amplitude/builder-skills

Diagnoses product health by cross-referencing Amplitude analytics (dashboards, charts, funnels, feedback, AI agent analytics), optionally Datadog (errors, latency, stack traces), and optionally Slack (qualitative feedback, bug reports, feature requests). Identifies what's broken, what's working, and what to do about it — with root causes, not just symptoms. Use when asked to "diagnose my product", "what's going on", "product health check", "what's broken", "where are users struggling", "give me a product diagnosis", or "what should I focus on".

amplitude/builder-skills

Summarizes B2B account health by analyzing usage patterns, engagement trends, risk signals, and expansion opportunities. Use for customer success reviews, renewal preparation, QBRs, or account prioritization.

Habilidades Relacionadas