Communitygithub.com

compétences-créateur-amplitude

Un guide structuré pour concevoir et construire les bonnes fonctionnalités avec un état d'esprit stratégique et centré sur l'utilisateur.

Qu'est-ce que compétences-créateur-amplitude ?

Ce skill fournit un cadre complet pour la conception et la construction de fonctionnalités, destiné aux ingénieurs, chefs de produit et designers. Il repose sur une méthodologie en trois étapes : d'abord, un énoncé concis du problème qui définit clairement le besoin métier et la motivation sous-jacente ; ensuite, une phase d'exploration de solutions qui évalue plusieurs approches selon des leviers stratégiques clés (avantages de coût, effets de réseau, contre-positionnement, coûts de changement, force de la marque, ressources captives et processus supérieurs) et des principes d'expérience utilisateur (simplicité, continuité, souci du détail et touches de plaisir) ; enfin, des critères d'acceptation granulaires et testables. Il est particulièrement utile pour les équipes travaillant sur Amplitude, mais applicable à toute plateforme SaaS (Claude Code, Cursor, Codex, etc.). Le skill encourage à s'inspirer de Linear pour la conception de composants SaaS et met l'accent sur l'impact, la confiance et l'effort (ICE) pour prioriser les solutions.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/product-skills/skills/draft-spec

Demander à votre IA préférée

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

Documentation

Mis à jour : @date du jour au format MM/JJ/AA

Contexte du problème

Rédigez un paragraphe de problème unique, actionnable et concis, exposant le problème derrière le ticket et sa motivation sous-jacente. Il doit clairement articuler les problèmes fondamentaux que ce ticket vise à résoudre ou les opportunités débloquées par la construction de cette fonctionnalité. Quel est le message marketing de cette fonctionnalité ? Pourquoi la construisons-nous maintenant ? Pourquoi méritons-nous de gagner avec cette fonctionnalité ? Cet énoncé du problème doit être suffisamment détaillé et actionnable pour se suffire à lui-même sans contexte supplémentaire, tout en transmettant TOUS les points clés, mais être limité à 3 phrases concises MAXIMUM. Commencez par la personne la plus pertinente qui fait la demande (ex : « Les propriétaires d'entreprise ont besoin… ») mais n'utilisez JAMAIS de noms exacts de personnes ou d'entreprises dans le paragraphe de synthèse.

Conception de la solution

Explorez l'espace des solutions avant de vous engager dans une direction. Envisagez plusieurs solutions candidates et évaluez-les sous les angles stratégique et expérientiel.

Identifiez les leviers stratégiques les plus importants pour cette solution et approfondissez-les :

  • Priorisez les fonctionnalités qui maximisent les avantages de coût grâce aux économies d'échelle, réduisant le coût unitaire à mesure que l'adoption par les utilisateurs ou le volume opérationnel augmente.
  • Sélectionnez les fonctionnalités qui amplifient les effets de réseau, augmentant la valeur pour les utilisateurs à mesure que le nombre de participants croît.
  • Favorisez les fonctionnalités qui créent des opportunités de contre-positionnement, en introduisant des capacités ou des expériences que les concurrents ne peuvent pas facilement reproduire sans perturber considérablement leur propre stratégie.
  • Mettez l'accent sur les fonctionnalités qui améliorent les coûts de changement pour le client, rendant plus difficile ou moins attrayant pour les utilisateurs de quitter l'écosystème.
  • Concentrez-vous sur les fonctionnalités qui renforcent la marque, renforçant son identité unique et créant des liens émotionnels durables avec les utilisateurs.
  • Exploitez les fonctionnalités qui capitalisent sur les ressources captives, telles que les données propriétaires, les partenariats exclusifs ou les capacités uniques que les concurrents ne peuvent pas facilement obtenir ou imiter.
  • Mettez en œuvre des fonctionnalités qui démontrent des processus supérieurs ou des workflows propriétaires, créant un avantage opérationnel durable par rapport aux concurrents.

Lors de la conception d'une expérience utilisateur simple et agréable, essayez d'employer certains de ces principes lors de la conception du flux utilisateur :

  • Simplifiez sans relâche — supprimez les étapes ou fonctionnalités inutiles pour offrir une expérience intuitive et minimaliste. Chaque élément doit mériter sa place.

  • Maintenez une continuité transparente — guidez les utilisateurs naturellement du début à la fin avec une charge cognitive minimale et sans impasse.

  • Soignez les détails — la typographie, les transitions, l'espacement et le texte doivent tous refléter un savoir-faire méticuleux. Équilibrez fonctionnalité et beauté dans une sensation de marque unifiée et cohérente à chaque point de contact.

  • Ajoutez des touches de plaisir réfléchies — ajoutez des petits détails mémorables qui élèvent l'expérience au-delà du fonctionnel.

  • En cas d'incertitude sur la façon de concevoir un composant SaaS, copiez la façon dont Linear conçoit ou fait fonctionner un composant.

Ne mentionnez pas explicitement ces principes lorsque vous discutez de la solution – intégrez-les simplement dans votre raisonnement lorsque vous explorez, puis décidez et expliquez la meilleure solution.

Après avoir exploré l'espace des solutions et identifié la meilleure stratégie, fournissez une description concise de ce que fait la fonctionnalité, comment elle résout les points de douleur de l'utilisateur et comment elle ravit l'utilisateur — rédigée de manière serrée, sans préambule inutile.

  • Décrivez en détail très spécifique la manière souhaitée dont les utilisateurs interagissent avec le produit et en font l'expérience. Concentrez-vous sur la conception de l'interface, chaque étape du parcours utilisateur et la façon d'améliorer la convivialité et la simplicité globales de la solution.
  • Présentez le récit d'utilisation réel que nous prévoyons de voir se produire suite au lancement de cette fonctionnalité.
  • Ancrez-le à un utilisateur réel dans un moment réel. Exemple : « Lorsque Frank visitait différentes startups à San Francisco, il utilisait [fonctionnalité X] pour enregistrer les plaintes et suivre les exigences dans [fonctionnalité Y] à mesure qu'il les découvrait... »
  • Mettez l'accent sur les tactiques uniques que nous pouvons employer ou les aspects qui distinguent cette solution des alternatives sur le marché et contre-positionnent notre produit vis-à-vis des concurrents.

N'oubliez pas : les meilleures solutions maximisent l'ICE : impact, confiance et effort. Plus l'impact est élevé, plus la confiance est élevée et plus l'effort est faible – meilleure est la solution.

Divisez la description de la solution en paragraphes ciblés et concis séparés par des sauts de ligne — un aspect de l'expérience par paragraphe.

Critères d'acceptation

Chaque critère doit décrire une condition spécifique et testable avec un résultat attendu clair. Les critères décrivent les résultats souhaités, pas les choix d'implémentation. Les critères doivent être MECE — mutuellement exclusifs et collectivement exhaustifs — couvrant toutes les conditions nécessaires à l'achèvement du travail.

Fonctionnels :

  • [Comportement utilisateur observable → réponse système attendue ou résultat]

Cas limites et gestion des erreurs :

  • [Ce qui se passe lorsque l'entrée est invalide, un service tombe en panne, des données sont manquantes ou l'utilisateur rencontre un état inattendu]

Hors du périmètre :

  • [Ce que ce travail n'inclut PAS explicitement — définissez des limites claires pour éviter la surconstruction]

<exemples de critères d'acceptation solides>

  • Lorsqu'un utilisateur tape dans la barre de recherche, les résultats se mettent à jour en direct après un délai d'attente de 300 ms, affichant le nom du produit, l'image et le prix dans une liste classée.
  • Les utilisateurs peuvent naviguer vers Paramètres > Modifier le profil et mettre à jour leur prénom, nom, adresse e-mail et numéro de téléphone. Les modifications persistent immédiatement lors de l'enregistrement et se reflètent dans toute l'application sans actualisation.
  • Si la requête de sauvegarde échoue (délai d'attente ou erreur 5xx), affichez une erreur en ligne : "Quelque chose s'est mal passé. Veuillez réessayer." Le formulaire conserve la saisie non enregistrée de l'utilisateur.
  • La soumission d'une requête de recherche vide renvoie la liste de résultats par défaut, pas une erreur ou un état vide.
  • Cela n'inclut PAS la modification en masse des profils, l'exportation CSV ou les modifications de permissions au niveau administrateur. </exemples de critères d'acceptation solides>

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