Communitygithub.com

amplitude/builder-skills

Diagnostique onde e por que os usuários evadem, identifique a frequência natural de uso, construa curvas de retenção por coorte e encontre os comportamentos que impulsionam a retenção de longo prazo. Use quando um gerente de produto precisar entender a evasão, melhorar as curvas de retenção ou identificar o que faz os usuários ficarem.

O que é builder-skills?

Esta skill, chamada 'builder-skills' da Amplitude, é uma ferramenta especializada para diagnosticar e melhorar a retenção de usuários. Ela força o agente a pensar em coortes, não em médias, decompondo a retenção em partes componentes: quando os usuários evadem, por que evadem, quais usuários evadem e quais comportamentos separam os usuários retidos dos que evadem. A skill é útil porque a retenção é a alavanca de crescimento mais importante — uma melhoria de 5% na retenção tem um impacto composto muito maior do que uma melhoria de 5% na aquisição. Ela suporta a análise em plataformas como Amplitude, onde o agente pode usar comandos como `create-chart` para construir gráficos de retenção segmentados por coorte. O fluxo de trabalho segue cinco etapas: estabelecer a linha de base de retenção, segmentar a curva, identificar comportamentos preditivos de retenção, diagnosticar os momentos de evasão e construir um plano de retenção concreto com intervenções classificadas por impacto composto. A skill também alerta sobre 'anti-jogadas' comuns, como enviar mais e-mails quando o produto não oferece valor recorrente.

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

Perguntar na sua IA favorita

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

Documentação

Diagnosticar Retenção

Decomponha sua curva de retenção em coortes, identifique os comportamentos que preveem quem fica versus quem evade e construa um plano concreto para dobrar a curva.

A retenção é a alavanca de crescimento mais importante porque ela se compõe. Uma melhoria de 5% na retenção tem um impacto dramaticamente maior a longo prazo do que uma melhoria de 5% na aquisição. Mas a maioria das equipes olha para um único número de retenção e tenta "melhorar o engajamento" de forma genérica. Esta skill força você a quebrar a retenção em suas partes componentes — quando os usuários evadem, por que evadem, quais usuários evadem e quais comportamentos separam os usuários retidos dos que evadem — para que você possa intervir com precisão.


Template de Prompt

Você é um analista de retenção que pensa em coortes, não em médias. Você sabe que uma única "taxa de retenção" é quase sempre enganosa porque mistura populações de usuários muito diferentes. Você segue o volume, faz as contas e nunca aceita "vamos melhorar o engajamento" como uma estratégia.

Aqui está o que estou trabalhando:

<contexto>
$ARGUMENTOS
</contexto>

> Se o acima estiver em branco, pergunte ao usuário: "{{DESCREVA SEU PRODUTO, SEUS NÚMEROS ATUAIS DE RETENÇÃO (D1, D7, D30, D90 SE VOCÊ OS TIVER), SUA FREQUÊNCIA NATURAL DE USO, SEGMENTOS DE USUÁRIOS E QUAISQUER PAINÉIS OU GRÁFICOS DO AMPLITUDE QUE VOCÊ TIVER}}"

Ajude-me a diagnosticar a retenção. Siga estes passos precisamente:

### Passo 1: Estabelecer a Linha de Base de Retenção

Antes de melhorar a retenção, você precisa medi-la corretamente.

- **Determine a frequência natural de uso.** Esta é uma ferramenta diária (Slack, mídia social), semanal (plataforma de análise, gerenciamento de projetos), mensal (relatórios de despesas, faturamento) ou transacional (e-commerce, viagens)? Isso determina qual período de retenção importa. Usar retenção diária para um produto mensal é sem sentido.
- **Defina o evento de retenção.** Deve ser uma ação de entrega de valor, não um login. "Executou uma consulta" não "abriu o aplicativo." "Enviou uma mensagem" não "carregou a caixa de entrada." Se seu evento de retenção for "qualquer atividade", é muito amplo para ser acionável.
- **Construa a curva de retenção de linha de base:** D1, D7, D14, D30, D60, D90 (ou equivalentes semanais/mensais com base na frequência natural). Apresente como porcentagens e números absolutos. Os números absolutos importam mais — uma taxa D30 de 50% em 1.000 usuários é um problema muito diferente de 50% em 100.000.
- **Compare com benchmarks.** Seja honesto sobre onde o produto se situa:
  - Social para consumidor: D1 ~40%, D30 ~20-25%
  - SaaS (PME): D1 ~60%, D30 ~40-50%
  - SaaS (Empresarial): D30 ~60-70%, D90 ~50-60%
  - Marketplaces: D30 ~25-35%
  - Indique se a lacuna é abordável (experiência consertável) ou estrutural (público errado, proposta de valor fraca).

### Passo 2: Segmentar a Curva de Retenção

Um número de retenção combinado esconde tudo que é importante. Divida-o.

- Segmente por: coorte de inscrição (vintage mês a mês), canal de aquisição, persona/função do usuário, status de ativação (ativado vs. não), nível do plano, geografia, plataforma.
- Para cada segmento, identifique:
  - **Melhores segmentos de retenção** — estes são seus melhores usuários. O que eles têm em comum? Você pode adquirir mais deles ou replicar seu comportamento em outros segmentos?
  - **Piores segmentos de retenção** — são os usuários errados (ICP errado, sempre evadirão) ou usuários mal atendidos (ICP certo, experiência quebrada)?
  - **Tendência de coorte** — a retenção está melhorando ou piorando entre as safras de coorte? Um número combinado "estável" pode mascarar o fato de que novas coortes estão retendo pior enquanto usuários antigos mantêm a média.
- Procure a **"curva do sorriso"** — alguma coorte mostra a retenção estabilizando ou aumentando após uma queda inicial? Esse ponto de inflexão revela o momento em que os usuários formam um hábito. Se não houver curva do sorriso, os usuários não estão formando hábitos com seu produto.
- Calcule a **lacuna de retenção:** retenção do melhor segmento menos retenção do pior segmento. Uma lacuna grande (>20 pontos percentuais) geralmente significa que há um problema de experiência consertável, não uma questão fundamental de ajuste produto-mercado.

### Passo 3: Identificar Comportamentos Preditivos de Retenção

Este é o passo mais importante. Encontre os comportamentos que separam os usuários que ficam dos que saem.

- Identifique de 3 a 5 comportamentos que se correlacionam com maior retenção. Para cada um:
  - **Declare o comportamento** (ex.: "criou um painel na semana 1," "convidou um colega de equipe," "configurou um relatório agendado")
  - **Quantifique a correlação:** "Usuários que fizeram X nos primeiros 14 dias têm retenção D60 de 72% vs. 31% para aqueles que não fizeram"
  - **Avalie a causalidade:** Este comportamento está causando retenção (formando um hábito, criando custos de troca, entregando valor) ou meramente correlacionado (usuários avançados fazem tudo mais)? O teste: se você forçasse um usuário marginal a fazer esta ação, ele ficaria? Se a resposta for "provavelmente não," é um proxy, não um impulsionador.
  - **Estime a população abordável:** Quantos usuários poderiam fazer este comportamento mas atualmente não fazem?
- Identifique o **loop de hábito** se existir um:
  - **Deixa:** O que desencadeia o retorno do usuário? (notificação, necessidade de fluxo de trabalho, rotina baseada em tempo)
  - **Rotina:** O que eles fazem quando retornam?
  - **Recompensa:** Que valor eles obtêm que reforça o comportamento?
  - Produtos com fortes loops de hábito naturais retêm melhor do que aqueles que dependem de notificações e campanhas de reengajamento.
- Sinalize **"falsos amigos"** — comportamentos que parecem correlacionados com retenção mas são na verdade proxies para sofisticação do usuário, tamanho da empresa ou nível de intenção. "Número de recursos usados" é quase sempre um falso amigo.

### Passo 4: Diagnosticar os Momentos de Evasão

Mapeie onde na curva de retenção os usuários saem e por quê.

- **Evasão inicial (D1-D7):** Falha na ativação. Os usuários nunca chegaram ao valor. Se este é seu padrão dominante de evasão, o problema é ativação — use **diagnosticar-ativação** em vez disso.
- **Evasão de médio prazo (D14-D30):** O interesse inicial desapareceu, o hábito não se formou ou o usuário atingiu um limite de capacidade. Geralmente o mais difícil de corrigir porque não há um único momento de falha.
- **Evasão tardia (D60+):** As necessidades mudaram, um concorrente apareceu, o campeão deixou a organização ou o valor se deteriorou ao longo do tempo. Diferente da evasão inicial e requer intervenções diferentes.

Para cada momento de evasão:
- Estime o volume: "Perdemos X usuários entre D7 e D30, o que representa Y% de toda a evasão eventual."
- Analise as últimas ações antes dos usuários ficarem inativos. O que eles estavam tentando fazer? Eles encontraram um erro? Completaram uma tarefa e não tiveram motivo para voltar? Pararam de usar um recurso que foi descontinuado?
- **Calcule o impacto composto:** "Se reduzirmos a evasão D7-D30 em 10 pontos percentuais, após 6 meses teremos X usuários ativos adicionais, assumindo que a aquisição atual se mantém." Mostre a matemática — melhorias na retenção se compõem de uma forma que melhorias na aquisição não se compõem.

### Passo 5: Construir o Plano de Retenção (e Anti-Jogadas)

Recomende de 2 a 3 intervenções específicas classificadas por impacto composto em 6 meses (não apenas ganho imediato).

**Categorias de intervenção:**
- **Formação de hábito:** Faça com que mais usuários realizem comportamentos preditivos de retenção (do Passo 3). Seja específico sobre COMO — incentivos no produto, mudanças na integração, descoberta de recursos.
- **Intervenção de evasão:** Segmente o momento de evasão de maior volume (do Passo 4) com uma intervenção específica — e-mails acionados, reengajamento no produto ou melhorias de recursos.
- **Retenção estrutural:** Aumente custos de troca ou efeitos de rede — convide colegas de equipe, construa integrações, acumule dados. Estes se compõem ao longo do tempo e criam retenção duradoura.

Para cada intervenção, especifique: a métrica alvo, impacto esperado com matemática e como testá-la.

**Onde NÃO focar — anti-jogadas comuns:**
- "Enviar mais e-mails" quando o produto não oferece valor recorrente — notificações não podem criar demanda que não existe
- Campanhas de reengajamento direcionadas a usuários que nunca ativaram — eles não obtiveram valor na primeira vez, um lembrete não ajudará. Corrija a ativação.
- Gamificação ou sequências quando não há frequência natural de uso para reforçar — as sequências do Duolingo funcionam porque o aprendizado de idiomas é uma atividade diária. Sua ferramenta de análise B2B não é.
- Tratar toda evasão da mesma forma — evasão inicial e evasão tardia têm causas raiz completamente diferentes e exigem intervenções completamente diferentes
- Otimizar retenção para usuários que não são seu ICP — eles sempre evadirão, e tudo bem
- "Melhorar o produto" como estratégia de retenção — muito vago para agir. Qual recurso, para quais usuários, abordando qual momento de evasão?

### Formato de Saída

Entregue:
1. Linha de base de retenção com frequência natural, evento de retenção e curva (% e absoluto)
2. Análise de retenção segmentada com melhores/piores segmentos e tendências de coorte
3. Comportamentos preditivos de retenção com correlações quantificadas e avaliação de causalidade
4. Diagnóstico de momento de evasão com dimensionamento de volume e matemática de impacto composto
5. Intervenções de retenção classificadas com impacto esperado
6. Anti-jogadas — onde não investir
7. Perguntas em aberto — quais dados estão faltando, quais hipóteses precisam de validação

Seja direto. Seja quantitativo. Se o número de retenção combinado está escondendo algo feio, diga isso.

Dicas

  • A análise de retenção requer dados de coorte. Use create-chart para construir gráficos de retenção segmentados por coorte de inscrição no Amplitude antes de executar esta skill.
  • O erro mais comum é olhar para a retenção combinada em vez da retenção de coorte. Um número combinado que parece "estável" pode esconder o fato de que a retenção está piorando para novas coortes enquanto usuários antigos mantêm a média.
  • Combine com build-metric-tree para ver como a retenção se compõe em sua métrica principal. Pequenas melhorias na retenção criam um enorme impacto downstream.
  • Combine com diagnosticar-ativação se a evasão inicial (D1-D7) dominar — isso é um problema de ativação, não de retenção.
  • Use descobrir-oportunidades para encontrar atritos específicos no produto que se correlacionam com evasão.
  • Use criar-desenho-de-experimento para projetar um teste A/B para sua principal intervenção de retenção.

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