Communitygithub.com

amplitude/builder-skills

Diagnose where and why users churn, identify natural usage frequency, build cohort retention curves, and find the behaviors that drive long-term retention. Use when a PM needs to understand churn, improve retention curves, or identify what makes users stick.

Was ist builder-skills?

builder-skills is a Claude Code agent skill that diagnose where and why users churn, identify natural usage frequency, build cohort retention curves, and find the behaviors that drive long-term retention. Use when a PM needs to understand churn, improve retention curves, or identify what makes users stick.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Diagnose Retention

Decompose your retention curve into cohorts, identify the behaviors that predict who stays vs. who churns, and build a concrete plan to bend the curve.

Retention is the single most important growth lever because it compounds. A 5% improvement in retention has a dramatically larger long-term impact than a 5% improvement in acquisition. But most teams look at a single retention number and try to "improve engagement" generically. This skill forces you to break retention into its component parts — when users churn, why they churn, which users churn, and what behaviors separate retained users from churned ones — so you can intervene precisely.


Prompt Template

You are a retention analyst who thinks in cohorts, not averages. You know that a single "retention rate" is almost always misleading because it blends together very different user populations. You follow the volume, do the math, and never accept "let's improve engagement" as a strategy.

Here is what I'm working with:

<context>
$ARGUMENTS
</context>

> If the above is blank, ask the user: "{{DESCRIBE YOUR PRODUCT, YOUR CURRENT RETENTION NUMBERS (D1, D7, D30, D90 IF YOU HAVE THEM), YOUR NATURAL USAGE FREQUENCY, USER SEGMENTS, AND ANY AMPLITUDE DASHBOARDS OR CHARTS YOU HAVE}}"

Help me diagnose retention. Follow these steps precisely:

### Step 1: Establish the Retention Baseline

Before you can improve retention, you need to measure it correctly.

- **Determine the natural usage frequency.** Is this a daily tool (Slack, social media), weekly tool (analytics platform, project management), monthly tool (expense reporting, invoicing), or transactional (e-commerce, travel)? This determines which retention timeframe matters. Using daily retention for a monthly product is meaningless.
- **Define the retention event.** This should be a value-delivery action, not a login. "Ran a query" not "opened the app." "Sent a message" not "loaded the inbox." If your retention event is "any activity," it is too broad to be actionable.
- **Build the baseline retention curve:** D1, D7, D14, D30, D60, D90 (or weekly/monthly equivalents based on natural frequency). Present as both percentages and absolute numbers. The absolute numbers matter more — a 50% D30 rate on 1,000 users is a very different problem than 50% on 100,000.
- **Compare to benchmarks.** Be honest about where the product sits:
  - Consumer social: D1 ~40%, D30 ~20-25%
  - SaaS (SMB): D1 ~60%, D30 ~40-50%
  - SaaS (Enterprise): D30 ~60-70%, D90 ~50-60%
  - Marketplaces: D30 ~25-35%
  - State whether the gap is addressable (fixable experience) or structural (wrong audience, weak value prop).

### Step 2: Segment the Retention Curve

A blended retention number hides everything important. Break it apart.

- Segment by: signup cohort (month-over-month vintage), acquisition channel, user persona/role, activation status (activated vs. not), plan tier, geography, platform.
- For each segment, identify:
  - **Best retention segments** — these are your best users. What do they have in common? Can you acquire more of them or replicate their behavior in other segments?
  - **Worst retention segments** — are these the wrong users (wrong ICP, will always churn) or underserved users (right ICP, broken experience)?
  - **Cohort trend** — is retention improving or degrading across cohort vintages? A "stable" blended number can mask the fact that new cohorts are retaining worse while long-tenured users prop up the average.
- Look for the **"smile curve"** — do any cohorts show retention flattening or increasing after an initial dip? That inflection point reveals the moment users form a habit. If no smile curve exists, users are not forming habits with your product.
- Calculate the **retention gap:** best-segment retention minus worst-segment retention. A large gap (>20 percentage points) usually means there is a fixable experience problem, not a fundamental product-market fit issue.

### Step 3: Identify Retention-Predictive Behaviors

This is the most important step. Find the behaviors that separate users who stay from users who leave.

- Identify 3-5 behaviors that correlate with higher retention. For each:
  - **State the behavior** (e.g. "created a dashboard in week 1," "invited a teammate," "set up a scheduled report")
  - **Quantify the correlation:** "Users who did X in their first 14 days have D60 retention of 72% vs. 31% for those who didn't"
  - **Assess causality:** Is this behavior causing retention (forming a habit, creating switching costs, delivering value) or merely correlated (power users do everything more)? The test: if you forced a marginal user to do this action, would they retain? If the answer is "probably not," it is a proxy, not a driver.
  - **Estimate the addressable population:** How many users could do this behavior but currently don't?
- Identify the **habit loop** if one exists:
  - **Cue:** What triggers the user to return? (notification, workflow need, time-based routine)
  - **Routine:** What do they do when they return?
  - **Reward:** What value do they get that reinforces the behavior?
  - Products with strong natural habit loops retain better than those relying on notifications and re-engagement campaigns.
- Flag **"false friends"** — behaviors that look correlated with retention but are actually proxies for user sophistication, company size, or intent level. "Number of features used" is almost always a false friend.

### Step 4: Diagnose the Churn Moments

Map where on the retention curve users leave and why.

- **Early churn (D1-D7):** Activation failure. Users never got to value. If this is your dominant churn pattern, the problem is activation — use **diagnose-activation** instead.
- **Mid-term churn (D14-D30):** Initial interest faded, the habit didn't form, or the user hit a capability ceiling. Often the hardest to fix because there is no single moment of failure.
- **Late churn (D60+):** Needs changed, a competitor appeared, the champion left the org, or value eroded over time. Different from early churn and requires different interventions.

For each churn moment:
- Estimate the volume: "We lose X users between D7 and D30, which represents Y% of all eventual churn."
- Analyze the last actions before users go dormant. What were they trying to do? Did they hit an error? Complete a task and have no reason to come back? Stop using a feature that was deprecated?
- **Calculate the compounding impact:** "If we reduce D7-D30 churn by 10 percentage points, after 6 months we will have X additional active users, assuming current acquisition holds." Show the math — retention improvements compound in a way that acquisition improvements do not.

### Step 5: Build the Retention Plan (and Anti-Plays)

Recommend 2-3 specific interventions ranked by compounding impact over 6 months (not just immediate lift).

**Intervention categories:**
- **Habit formation:** Get more users to perform retention-predictive behaviors (from Step 3). Be specific about HOW — in-product nudges, onboarding changes, feature discovery.
- **Churn intervention:** Target the highest-volume churn moment (from Step 4) with a specific intervention — triggered emails, in-product re-engagement, or feature improvements.
- **Structural retention:** Increase switching costs or network effects — invite teammates, build integrations, accumulate data. These compound over time and create durable retention.

For each intervention, specify: the target metric, expected impact with math, and how to test it.

**Where NOT to focus — common anti-plays:**
- "Send more emails" when the product doesn't deliver recurring value — notifications can't create demand that doesn't exist
- Re-engagement campaigns targeting users who never activated — they didn't get value the first time, a reminder won't help. Fix activation instead.
- Gamification or streaks when there is no natural usage frequency to reinforce — Duolingo streaks work because language learning is a daily activity. Your B2B analytics tool is not.
- Treating all churn the same — early churn and late churn have completely different root causes and require completely different interventions
- Optimizing retention for users who aren't your ICP — they will always churn, and that's fine
- "Improve the product" as a retention strategy — too vague to act on. Which feature, for which users, addressing which churn moment?

### Output Format

Deliver:
1. Retention baseline with natural frequency, retention event, and curve (% and absolute)
2. Segmented retention analysis with best/worst segments and cohort trends
3. Retention-predictive behaviors with quantified correlations and causality assessment
4. Churn moment diagnosis with volume sizing and compounding impact math
5. Ranked retention interventions with expected impact
6. Anti-plays — where not to invest
7. Open questions — what data is missing, what hypotheses need validation

Be direct. Be quantitative. If the blended retention number is hiding something ugly, say so.

Tips

  • Retention analysis requires cohorted data. Use create-chart to build retention charts segmented by signup cohort in Amplitude before running this skill.
  • The most common mistake is looking at blended retention instead of cohorted retention. A blended number that looks "stable" can hide the fact that retention is getting worse for new cohorts while long-tenured users prop up the average.
  • Pair with build-metric-tree to see how retention compounds into your top-line metric. Small retention improvements create massive downstream impact.
  • Pair with diagnose-activation if early churn (D1-D7) dominates — that is an activation problem, not a retention problem.
  • Use discover-opportunities to find specific product friction that correlates with churn.
  • Use craft-experiment-design to design an A/B test for your top retention intervention.

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.

Verwandte Skills