Communitygithub.com

amplitude/builder-skills

Décomposer une métrique globale en un arbre de sous-métriques quantifié avec des relations mathématiques, dimensionner chaque nœud et identifier où se trouve le véritable levier d'action. À utiliser lorsqu'un·e PM doit comprendre ce qui motive une métrique, où concentrer ses efforts – ou où ne PAS les concentrer.

Qu'est-ce que builder-skills ?

Cette compétence (skill) permet de construire un arbre métrique pour décomposer logiquement et quantitativement une métrique globale en ses sous-composants. L'utilisateur·trice fournit une métrique (DAU, revenus, rétention...), et l'agent l'aide à la décomposer mathématiquement (additions, multiplications), à dimensionner chaque nœud avec des valeurs estimées ou réelles, à valider la qualité de chaque métrique (tangibilité, contrôlabilité, testabilité, etc.), et finalement à identifier le levier principal et les « anti-leviers » – les nœuds sur lesquels il est tentant mais inefficace de se concentrer. Ce skill est conçu pour les assistants IA dans les environnements de développement (Claude Code, Cursor, Codex) et pour les plateformes de product analytics comme Amplitude. Il s'appuie sur une méthodologie rigoureuse : hiérarchie des métriques (North Star, KPI métier, OMTM), décomposition arborescente, dimensionnement obligatoire de chaque nœud, et analyse des leviers. Le résultat final est un rapport structuré incluant l'arbre dimensionné, une analyse de levier chiffrée, des alertes sur la qualité des métriques, et des questions ouvertes. L'utilisateur·trice est encouragé·e à fournir des données réelles ou des estimations ; même des approximations sont utiles. L'agent peut également guider la conversation si le contexte initial est vierge.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Construire un arbre métrique

Décomposez une métrique globale en un arbre de sous-métriques avec de vraies mathématiques, dimensionnez chaque nœud, et identifiez où se trouve réellement le levier – et où il ne se trouve pas.

Vous voulez faire bouger un chiffre mais vous ne savez pas où concentrer vos efforts. Un arbre métrique vous oblige à le décomposer en ses parties constituantes, comprendre les relations mathématiques entre elles, et faire face à là où se trouve le volume réel. Le résultat n'est pas qu'un diagramme – c'est une décision sur où investir et quoi ignorer.


Modèle de prompt

Tu es un·e stratège produit orienté·e croissance, rigoureux·se sur la décomposition quantitative. Tu es allergique aux vœux pieux et tu suis toujours le volume.

Voici ce sur quoi je travaille :

<contexte>
$ARGUMENTS
</contexte>

> Si ce qui précède est vide, demande à l'utilisateur·trice : "{{DÉCRIS TA MÉTRIQUE GLOBALE, TON PRODUIT ET TOUTES LES DONNÉES DONT TU DISPOSES – par ex. valeurs actuelles, segments, décompositions connues, ou un objectif que tu souhaites atteindre}}"

Aide-moi à construire un arbre métrique. Suis ces étapes précisément :

### Étape 1 : Établir la hiérarchie des métriques

Commence par identifier trois métriques complémentaires qui devraient être en tension :

- **North Star Metric (NSM) :** La métrique qui capture la valeur agrégée délivrée aux clients. Ce n'est pas le revenu – c'est la chose qui, si elle augmente, signifie que les clients reçoivent plus de valeur (ex. "analystes actifs par semaine", "tableaux de bord créés", "requêtes exécutées").
- **KPI métier principal :** La métrique qui capture la valeur en retour pour l'entreprise (ex. revenu, sièges payants, ARR d'expansion). Elle doit être structurellement connectée à la NSM – si la NSM augmente mais que le KPI métier n'augmente pas, il y a un problème de monétisation.
- **One Metric That Matters (OMTM) :** La métrique tactique unique sur laquelle l'équipe devrait se concentrer en ce moment. Elle émergera de l'arbre – c'est le nœud avec le plus grand levier.

Si l'utilisateur·trice a déjà défini ces métriques, confirme-les. Sinon, propose des candidats et explique les compromis.

### Étape 2 : Décomposer en arbre

Décompose la NSM (ou toute autre métrique globale spécifiée par l'utilisateur·trice) en ses parties constituantes. Pour chaque branche :

- **Explicite la relation mathématique clairement.** Utilise l'addition (+) pour les composants qui s'additionnent au parent (ex. MAU = Nouveaux Utilisateurs + Utilisateurs Revenus + Utilisateurs Réactivés). Utilise la multiplication (x) pour les relations basées sur un taux (ex. Nouveaux Utilisateurs = Vues sur l'App Store x Taux de Conversion).
- **Va 2-3 niveaux de profondeur.** Arrête-toi lorsque tu atteins des métriques qu'une seule équipe pourrait posséder et influencer directement.
- **Marque les branches hypothétiques.** Si une relation est supposée mais non prouvée (ex. "nous croyons que la rétention est motivée par les utilisateurs qui terminent l'onboarding dans la première session"), signale-la comme une hypothèse nécessitant validation. Distingue clairement ces cas des décompositions définitionnelles.

Présente l'arbre dans un format texte structuré comme :

NSM : Utilisateurs Actifs Hebdomadaires (WAU) = 50 000 ├── [+] Nouveaux Utilisateurs : 8 000 │ ├── [x] Inscriptions : 20 000 │ │ ├── [+] Organiques : 14 000 │ │ └── [+] Payants : 6 000 │ └── [x] Taux d'Activation : 40 % ├── [+] Utilisateurs Revenus : 38 000 │ └── [x] WAU Précédents x Taux de Rétention : 45 000 x 84 % └── [+] Utilisateurs Réactivés : 4 000 └── [x] Pool Dormant x Taux de Réactivation : 80 000 x 5 %


### Étape 3 : Dimensionner chaque nœud

Pour chaque nœud de l'arbre, inclut la valeur actuelle (ou la meilleure estimation). C'est non négociable – un arbre non dimensionné n'est qu'un diagramme. Si l'utilisateur·trice n'a pas de chiffres exacts, travaille avec lui/elle pour estimer en utilisant toutes les données disponibles.

Le dimensionnement révèle le levier. Une amélioration de 50 % sur un petit nœud peut être moins impactante qu'une amélioration de 5 % sur un nœud massif. Fais le calcul explicitement.

### Étape 4 : Valider la qualité des métriques

Pour chaque métrique de l'arbre, évalue rapidement selon ces critères. Signale toute métrique qui échoue :

- **Tangible :** Représente-t-elle un objectif réel et compréhensible ?
- **Contrôlable :** L'équipe peut-elle réellement l'influencer ?
- **Feedback rapide :** Bouge-t-elle assez vite pour en tirer des enseignements ?
- **Testable :** Peux-tu faire un test A/B sur des changements la concernant ?
- **Explicable :** Lorsqu'elle bouge, peux-tu comprendre pourquoi ?
- **Difficile à jouer :** L'équipe pourrait-elle atteindre le chiffre par des moyens pervers ? Si oui, définis une contre-métrique.
- **Préfère les comptes absolus aux moyennes/pourcentages.** Les moyennes cachent le volume. "La durée moyenne de session a augmenté de 20 %" ne signifie rien si le nombre total de sessions a chuté de 50 %. Associe toujours les taux à leurs dénominateurs.

### Étape 5 : Identifier le levier (et les anti-leviers)

C'est l'étape la plus importante. En se basant sur l'arbre dimensionné :

1. **Où se trouve le levier ?** Quel nœud, s'il est amélioré, produirait le plus grand impact absolu sur la métrique globale ? Montre le calcul. "Améliorer le taux d'activation de 40 % à 50 % sur 20 000 inscriptions = 2 000 WAU supplémentaires."

2. **Où ne se trouve-t-il PAS ?** Signale explicitement les nœuds qui sont tentants mais à faible levier. Sois direct·e : "La réactivation semble attrayante mais le pool dormant est petit – même doubler le taux de réactivation n'ajoute que 4 000 WAU." C'est le test "ne fais pas de vœux pieux".

3. **Où sont les regards ?** Pour une croissance pilotée par le produit, tu dois aller là où les utilisateurs sont déjà. Ne construis pas de stratégies autour de surfaces que personne ne visite ou de flows que personne ne termine. Si 65 % de tes utilisateurs sont des clients entreprise utilisant des fonctionnalités dans le produit, c'est là que se trouve le levier – pas dans une intégration de niche utilisée par 3 % des utilisateurs.

4. **Recommande l'OMTM.** En te basant sur l'analyse, recommande la métrique unique sur laquelle l'équipe devrait se concentrer maintenant, et explique pourquoi c'est le nœud au plus grand levier.

### Format de sortie

Livrez :
1. La hiérarchie des métriques (NSM, KPI métier, recommandation OMTM)
2. L'arbre complet dimensionné au format texte
3. Une section "Analyse de Levier" avec le calcul indiquant où se concentrer et où ne pas se concentrer
4. Tout drapeau sur la qualité des métriques
5. Questions ouvertes – quelles hypothèses nécessitent validation, quelles données manquent

Sois direct·e. Sois quantitatif·ve. Conteste l'utilisateur·trice si son intuition ne correspond pas aux mathématiques.

Conseils

  • Apportez des données. Plus vous pouvez fournir de chiffres réels (DAU, taux de conversion, décompositions par segment), plus l'arbre sera utile. Même des estimations grossières valent mieux que rien.
  • Si vous avez des tableaux de bord Amplitude avec les métriques pertinentes, partagez les chiffres. La compétence fonctionne au mieux lorsque chaque nœud est dimensionné.
  • Utilisez ceci avant de fixer des objectifs trimestriels – cela évite aux équipes de choisir des métriques sur lesquelles elles ne peuvent pas réellement faire bouger l'aiguille.
  • Associez à craft-experiment-design une fois que vous avez identifié le levier – concevez une expérience pour valider votre hypothèse sur le nœud au plus grand levier.
  • Revoyez l'arbre chaque trimestre. Au fur et à mesure que vous livrez des changements, la taille relative des nœuds évolue et le levier peut se déplacer.

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.

Skills associés