Communitygithub.com

amplitude/builder-skills

Utilisez cette compétence lorsqu'un utilisateur souhaite tester des variantes de contenu avant publication pour déterminer laquelle sera la plus citée par les modèles d'IA — que ce soit « quelle version de ce contenu sera la plus performante », « tester cet article avant publication », « simuler comment l'IA répondra à ce contenu », « quel angle utiliser », « générer des variantes de contenu et choisir la gagnante », « exécuter une simulation avant publication », ou toute variante où l'objectif est une sélection de contenu basée sur les données plutôt que sur l'intuition. Cette compétence identifie une opportunité de contenu, génère 2 à 3 variantes distinctes avec des angles ou structures différents, les note en fonction des réponses réelles des modèles d'IA issues de AI Visibility, s'appuie sur la fonctionnalité Simulate Changes pour une validation pré-publication, et produit une recommandation claire sur la variante à publier — puis la pousse dans le CMS. Déclenché par toute mention de « simuler », « tester des variantes », « quelle est la plus performante », « test A/B de contenu » ou « avant publication ».

Qu'est-ce que builder-skills ?

Le skill Simulation-Backed Publisher d'Amplitude transforme la publication de contenu en un processus piloté par les données, remplaçant les paris intuitifs par des décisions éclairées par l'IA. Il génère 2 à 3 variantes de contenu distinctes, les évalue en fonction des réponses réelles des modèles d'IA sur le même sujet (via AI Visibility), et recommande la variante la plus susceptible d'être citée — avant même qu'un seul mot ne soit mis en ligne. Le skill couvre sept étapes structurées : découverte du CMS connecté (Sanity, Contentful, HubSpot, WordPress, Ghost, Webflow), identification de l'opportunité de contenu à simuler, chargement du contexte de réponse des LLM (prompts, tonalité, lacunes), génération de variantes différenciées (angle, profondeur, cadrage), notation de chaque variante sur cinq dimensions clés (alignement des prompts, directivité de la réponse, spécificité, couverture des lacunes, structure), validation via la fonctionnalité Simulate Changes d'AI Visibility, et enfin publication de la variante gagnante dans le CMS sous forme de brouillon. Les scores sont présentés dans un tableau clair (ex. alignement des prompts 4/5, directivité 5/5) avec une recommandation explicite. Le skill est idéal pour les équipes de contenu qui veulent maximiser les citations par l'IA, notamment via des outils comme Claude Code, Cursor ou Codex, et s'intègre avec les principaux CMS du marché.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/content-marketing-skills/skills/simulation-backed-publisher

Demander à votre IA préférée

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

Documentation

Simulation-Backed Publisher

Vous aidez une équipe de contenu à ne plus publier au hasard. Au lieu de publier un seul contenu en espérant qu'il soit cité, cette compétence génère 2 à 3 variantes distinctes, note chacune d'elles par rapport à ce que les modèles d'IA disent réellement sur ce sujet, et recommande la plus susceptible de gagner des citations — avant même qu'un seul mot ne soit mis en ligne.


Étape 0 — Découverte du CMS (exécutée une fois au début de chaque session)

Avant de faire quoi que ce soit d'autre, déterminez où le contenu gagnant sera déposé. Cela évite une impasse de copier-coller à la fin du flux de travail.

Vérifiez les outils CMS déjà connectés

Analysez les outils actuellement disponibles dans votre contexte. Modèles MCP de CMS connus :

CMSModèles de noms d'outils à rechercher
Sanitysanity, create_documents_from_markdown, patch_document_from_markdown
Contentfulcontentful, create_entry, update_entry
HubSpot CMShubspot, update_blog_post, create_blog_post
WordPresswordpress, wp_update_post, wp_create_post
Ghostghost, update_post, create_post
Webflowwebflow, update_cms_item, create_cms_item

Si un MCP CMS est déjà connecté : confirmez en une ligne : « Je vois que [CMS] est connecté — j'y pusherai la variante gagnante en tant que brouillon une fois terminé. D'accord ? » Passez ensuite à l'étape 1.

Si rien n'est connecté : demandez une fois, de manière concise :

« Avant de commencer — vers quel CMS publiez-vous ? Je peux y pusher la variante gagnante directement en tant que brouillon au lieu de vous donner un bloc de texte à coller. »

Proposez : Sanity · Contentful · HubSpot · WordPress · Webflow · Ghost · Autre · « Donnez-moi simplement le contenu »

Ensuite, fournissez une recommandation de configuration personnalisée en fonction de leur réponse (même guide que dans prompt-gap-to-publish). Ne bloquez pas sur la configuration — commencez l'analyse immédiatement et dites que vous serez prêt à pusher au moment où ils seront connectés.


Étape 1 — Identifier l'opportunité à simuler

Utilisez list_ai_visibility_org_brands pour identifier la marque (ou utilisez celle spécifiée par l'utilisateur).

L'utilisateur peut arriver ici avec une opportunité déjà en main (par exemple, suite à l'exécution de prompt-gap-to-publish ou competitor-prompt-hijacker). Si c'est le cas, utilisez cette opportunité directement.

Sinon, utilisez get_ai_visibility_topics avec le orgBrandId sélectionné pour faire apparaître les 3 à 5 meilleures opportunités en utilisant l'heuristique de notation standard : sujets avec pertinence > 60 % et visibilité < 40 %. Présentez-les brièvement et demandez laquelle simuler.

Confirmez l'opportunité avec l'utilisateur avant de construire les variantes :

« Je vais générer des variantes pour : [titre de l'opportunité]. Les prompts cibles sont : [2–3 exemples de prompts]. Cela correspond-il à ce que vous souhaitez tester ? »


Étape 2 — Charger le contexte des réponses LLM

Pour l'opportunité sélectionnée, récupérez les réponses réelles des modèles d'IA en utilisant :

  • get_ai_visibility_prompts avec le topicId pertinent pour obtenir la liste des prompts
  • get_ai_visibility_prompt_responses pour les 5 à 8 prompts les plus importants avec le responseCount le plus élevé

Lisez chaque réponse attentivement. C'est la vérité du terrain — c'est exactement ce que les modèles d'IA disent actuellement lorsqu'on leur pose des questions dans cet espace. Vos variantes seront notées par rapport à ce contexte.

Extrayez des réponses :

  • Quel langage et quel cadrage les modèles d'IA utilisent-ils ? (vocabulaire, format des questions, termes clés)
  • Quelles affirmations font-ils ? (statistiques, capacités des produits, outils nommés)
  • Qu'est-ce qui manque ou est insuffisant ? (domaines où la réponse de l'IA est vague, prudente ou cite des sources faibles)
  • Quelles marques apparaissent dans les réponses ? (concurrents qui sont cités et ne devraient pas l'être)
  • Quel format les réponses utilisent-elles ? (listes à puces, prose, tableaux — votre contenu doit correspondre)

Ce contexte constitue la grille de notation pour les variantes que vous allez construire.

Appelez également get_ai_visibility_sentiment pour comprendre le ton : le sentiment de l'IA envers la marque sur ce sujet est-il positif, neutre ou négatif ? Les variantes doivent être conçues pour renforcer un sentiment positif ou contrer un cadrage négatif.


Étape 3 — Générer 2 à 3 variantes

Construisez 2 à 3 variantes distinctes du contenu. Chaque variante doit adopter un angle ou une structure significativement différent — pas simplement le même contenu avec des introductions différentes. De petites réécritures ne vous apprennent rien ; les alternatives authentiques, oui.

Axes de différenciation des variantes

Choisissez les axes les plus pertinents pour l'opportunité :

Angle : Éducatif (« Comment fonctionne X ») vs. Compétitif (« Amplitude vs alternatives ») vs. Cas d'usage (« Meilleur X pour [segment spécifique] »)

Amorce : Données d'abord (commencez par un benchmark ou une statistique) vs. Problème d'abord (commencez par le point douloureux) vs. Réponse d'abord (commencez par la réponse directe à la question centrale)

Profondeur : Guide complet (long format, couvre tout) vs. Précis et spécifique (réponse ciblée à une question) vs. Interactif/structuré (utilisation intensive de tableaux, matrices de comparaison, FAQ)

Cadrage : Marque d'abord (« Voici comment Amplitude fait X ») vs. Neutre catégoriel (« Voici comment fonctionne l'analytique produit — et où se situe Amplitude ») vs. Compétitif (« Le guide honnête des outils X »)

Format de la variante

Pour chaque variante, écrivez :

  1. H1 complet et paragraphe d'ouverture (la partie que les modèles d'IA pèsent le plus lourdement)
  2. Plan H2 avec une description de 1 à 2 phrases du contenu de chaque section
  3. Une section entièrement rédigée — le H2 le plus important, complètement rédigé
  4. Bloc FAQ complet — 4 à 6 Q&R utilisant le langage exact des prompts de l'étape 2
  5. Champs Meta : metaTitle, metaDescription, slug

Étiquetez-les clairement : Variante A, Variante B, Variante C.


Étape 4 — Noter chaque variante par rapport au contexte LLM

Évaluez maintenant chaque variante par rapport aux réponses réelles des modèles d'IA de l'étape 2. C'est la simulation. Notez chaque variante sur une échelle de 1 à 5 selon les dimensions suivantes :

Alignement des prompts (1–5) : Le H1, l'ouverture et la FAQ de la variante correspondent-ils directement au langage et au format des questions utilisés dans les prompts AI Visibility ? Score 5 si la variante reflète étroitement le langage des prompts ; score 1 si elle utilise une terminologie différente ou enterre la réponse.

Directivité de la réponse (1–5) : La variante répond-elle à la question centrale dans les 2 premières phrases ? Score 5 si oui ; score 3 si la réponse apparaît dans le paragraphe d'ouverture ; score 1 si le lecteur doit faire défiler.

Spécificité (1–5) : La variante fait-elle des affirmations concrètes et vérifiables (« Amplitude capture les rage clicks, la profondeur de défilement et les heatmaps dans des sessions de moins de 100 ms ») plutôt que génériques ? Score 5 si chaque affirmation majeure est spécifique ; score 1 si les affirmations sont principalement génériques.

Couverture des lacunes (1–5) : La variante couvre-t-elle les domaines où les réponses actuelles de l'IA sont insuffisantes ou absentes ? Score 5 si elle comble toutes les lacunes identifiées ; score 1 si elle répète largement ce que les modèles d'IA disent déjà.

Correspondance de structure (1–5) : Le format de la variante correspond-il à la façon dont les modèles d'IA présentent déjà ce sujet ? Score 5 si la structure reflète le format des réponses (par ex., si les modèles d'IA utilisent des listes à puces, la variante les utilise de manière proéminente).

Présentez les scores sous forme de tableau :

DimensionVariante AVariante BVariante C
Alignement des prompts453
Directivité de la réponse345
Spécificité534
Couverture des lacunes443
Correspondance de structure354
Total192119

Énoncez la recommandation clairement : « La variante B obtient le score le plus élevé (21/25). Son bloc FAQ reflète le langage exact des prompts d'AI Visibility, et elle répond à la question centrale dès la phrase 1. Recommandation : publier la variante B. »


Étape 5 — Point de contrôle Simulate Changes

Avant de pusher vers le CMS, faites référence à la fonctionnalité intégrée Simulate Changes d'AI Visibility :

« AI Visibility dispose d'une fonctionnalité 'Simulate Changes' qui évalue votre contenu par rapport aux prompts des modèles d'IA en direct et projette l'amélioration des citations avant publication. Voici ce qu'il faut coller : [le texte complet de l'ouverture de la variante gagnante + le bloc FAQ]

Pour l'exécuter : ouvrez AI Visibility → sélectionnez votre marque → allez dans Simulate Changes → collez le contenu → lancez la simulation. Je patiente, ou je pousse le brouillon maintenant et vous pouvez simuler en parallèle. »

Laissez l'utilisateur décider. S'il souhaite simuler d'abord, faites une pause et fournissez le texte exact à coller. S'il est prêt à pusher, passez à l'étape 6.

Si la simulation revient et change d'avis sur la variante à utiliser, générez la variante révisée complète avant de pusher.


Étape 6 — Construire la gagnante en entier

Une fois la variante sélectionnée (avec ou sans résultats de simulation), rédigez l'article complet :

  • H1 complet jusqu'au CTA final — pas d'espaces réservés, pas de « [ajouter une section ici] »
  • Toutes les sections H2 du plan, entièrement rédigées
  • Bloc FAQ complet (4 à 6 Q&R)
  • Champs Meta : metaTitle, metaDescription, slug
  • Mention « Dernière mise à jour : [mois/année en cours] » dans les métadonnées

Enregistrez également les variantes finalistes sous forme de bloc Markdown à la fin — étiquetez-les clairement comme alternatives. Elles pourront être utilisées pour des tests A/B après le lancement, ou adaptées pour différents canaux.


Étape 7 — Pusher vers le CMS

Utilisez ce que vous avez découvert à l'étape 0. Il s'agit d'un nouveau document (opération de création, pas de mise à jour) sauf si l'utilisateur spécifie qu'il met à jour une page existante.

Sanity — utilisez create_documents_from_markdown avec la variante gagnante. Définissez _type pour correspondre au schéma blog/article. Demandez si vous n'êtes pas sûr : « Quel est le type de document pour les articles dans votre schéma Sanity ? » N'utilisez jamais publish_documents sans instruction explicite.

Contentful — utilisez create_entry avec contentType correspondant à leur type d'article. Définissez fields.title, fields.slug, fields.body. Laissez published: false.

HubSpot — utilisez create_blog_post avec state: DRAFT. Incluez la méta-description et le slug.

WordPress — utilisez wp_create_post avec status: draft. Mappez H1 sur title, le corps sur content.

Ghost — utilisez create_post avec status: draft. Incluez slug, title, html ou lexical, et meta_description.

Webflow — utilisez create_cms_item en ciblant la Collection de blog. Mappez les champs sur le schéma de la Collection (demandez les noms des champs à l'utilisateur s'ils ne sont pas évidents).

Après avoir poussé, confirmez : « Terminé — [titre de l'article] est enregistré en tant que brouillon dans [CMS]. Voici l'ID/l'URL : [lien]. Les variantes finalistes sont ci-dessous en Markdown — conservez-les pour une utilisation future ou des tests A/B. »

Sortez toujours un repli Markdown de la variante gagnante, plus les alternatives finalistes, même lorsque la poussée CMS réussit.


Pourquoi simuler avant de publier

Chaque contenu est un pari. La publication appuyée par simulation transforme ce pari en un choix raisonné :

  • L'alignement des prompts est le prédicteur le plus fort de citation. Un contenu qui reflète le langage exact que les modèles d'IA utilisent dans les prompts sera récupéré et cité bien plus fiablement qu'un contenu rédigé dans un langage SEO générique.
  • La directivité de la réponse s'accumule avec le temps. La première phrase d'une page est pondérée de manière disproportionnée par la récupération IA. Une variante qui répond dès la phrase 1 surpassera systématiquement celle qui met trois paragraphes pour y arriver.
  • La couverture des lacunes est la victoire de citation la plus rapide. Si les réponses de l'IA sur un sujet sont insuffisantes ou vagues sur une sous-question spécifique, la première page à y répondre concrètement devient la citation de référence.
  • Les variantes exposent les hypothèses. Rédiger 3 versions du même contenu oblige l'équipe à articuler ce qu'elle croit vraiment que le public a besoin — et la notation les surprend souvent.

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 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

Turn one or more meeting transcripts, notes, or Slack threads into concise takeaways and clear action items with DRIs. Works with a single meeting or a batch from the whole week.

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