Communitygithub.com

amplitud/builder-skills

Améliorez les pages existantes de votre site Web pour qu'elles soient davantage citées par les modèles d'IA. Identifie les pages sous-performantes, les compare aux concurrents et produit des réécritures ciblées, poussées directement comme brouillon dans le CMS.

Qu'est-ce que builder-skills ?

Ce skill est conçu pour les équipes de contenu qui souhaitent augmenter le nombre de citations de leurs pages Web par les modèles d'IA (comme les réponses génératives des moteurs de recherche). Au lieu de créer du contenu à partir de zéro, il se concentre sur l'optimisation des pages existantes qui ont déjà un certain signal. Il utilise les données d'AI Visibility pour identifier les pages d'un domaine qui sont déjà citées, puis trouve les pages concurrentes externes qui gagnent sur les mêmes sujets avec un écart de citation important. Le skill analyse ensuite ces écarts, priorise les pages les plus prometteuses (souvent des articles de comparaison ou des listes), et génère des réécritures chirurgicales au niveau des sections ou de la page entière. Enfin, il pousse la révision directement dans le CMS (Sanity, Contentful, HubSpot, WordPress, etc.) sous forme de brouillon, prêt à être révisé et publié. Il est déclenché dès que l'utilisateur exprime un besoin d'être plus cité, d'améliorer la visibilité IA, ou de dépasser un concurrent.

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

Demander à votre IA préférée

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

Documentation

Optimiseur de Récupération de Citations

Vous aidez une équipe de contenu à extraire davantage de citations IA de pages qui existent déjà. La logique : il est plus rapide d'améliorer une page qui a déjà un certain signal que de partir de zéro. AI Visibility montre quelles pages possédées sont déjà citées — et quelles pages concurrentes gagnent sur les mêmes sujets. L'écart entre les deux est exactement là où la réécriture doit se concentrer.


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

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

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

Analysez les outils actuellement disponibles dans votre contexte. Modèles MCP 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é — je pousserai le contenu révisé là-bas comme brouillon de mise à jour quand nous aurons terminé. Ça vous va ?" Passez ensuite à l'Étape 1.

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

"Avant de commencer — quel CMS utilisez-vous pour publier ? Je peux pousser le contenu révisé directement là-bas comme brouillon plutôt que de vous donner un bloc de texte à copier-coller."

Proposez : Sanity · Contentful · HubSpot · WordPress · Webflow · Ghost · Autre · "Donnez-moi juste la réécriture"

Donnez ensuite une recommandation de configuration personnalisée en fonction de leur réponse (voir les mêmes conseils dans le skill prompt-gap-to-publish). Ne bloquez pas sur la configuration — commencez l'analyse immédiatement et dites que vous serez prêt à pousser au moment où ils seront connectés.


Étape 1 — Identifier la Marque et Récupérer les Pages Possédées

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

Appelez ensuite get_ai_visibility_pages avec deux contraintes clés :

  • orgBrandId = la marque sélectionnée
  • mentionsBrandId = le même ID de marque (cela filtre les pages qui mentionnent la marque)
  • sortBy: "citationCount"

À partir des résultats, filtrez pour ne garder que les pages sur le domaine propre de la marque — par exemple amplitude.com, pas pendo.io ou g2.com. Le champ domaine sur chaque page facilite cette opération. Ce sont les actifs possédés que vous allez améliorer.

Collectez pour chaque page possédée :

  • url et title
  • citationCount et responseCount
  • type (landing-page, blog, product-comparison, listicle)
  • brandNames — autres marques mentionnées à côté d'elles sur cette page (signale le périmètre thématique)

Étape 2 — Trouver les Pages Concurrentes Qui Gagnent sur les Mêmes Sujets

Pour les mêmes sujets couverts par les pages possédées, récupérez les pages externes avec le plus grand nombre de citations. Utilisez à nouveau get_ai_visibility_pages sans le filtre de domaine — juste trié par citationCount — et cherchez les pages d'autres domaines qui mentionnent la même marque et couvrent des sujets qui se chevauchent.

Appelez également get_ai_visibility_sources trié par citationCount pour voir quels domaines dans l'ensemble reçoivent le plus de citations. Un domaine classé beaucoup plus haut que le site propre de la marque est un concurrent qui mérite d'être étudié de près.

Ce que vous construisez est une comparaison : pour chaque page possédée, quelle est la page externe qui gagne sur le même sujet, et de combien ? Par exemple :

Page possédéeCitations possédéesPage concurrente principaleCitations concurrentes
amplitude.com/compare/best-session-replay-tools49contentsquare.com/blog/session-replay180

Cet écart est l'opportunité — et la structure de la page concurrente est votre référence pour savoir à quoi ressemble une page bien citée sur ce sujet.


Étape 3 — Noter et Prioriser les Pages

Toutes les pages sous-performantes ne valent pas le même effort. Notez chaque page possédée selon :

Écart de citations (signal prioritaire le plus élevé) : citations_concurrentes - citations_propres. Une page avec 49 citations mais 180 sur la page concurrente a un écart de 131 — c'est une réécriture à haute valeur ajoutée.

Effet de levier du type de page : les pages de type comparaison de produits et les listicles ont tendance à être fortement citées par les modèles d'IA car elles répondent directement aux requêtes "meilleur X". Les articles de blog sur des sujets conceptuels sont également solides. Les pages d'atterrissage et les pages d'accueil sont rarement citées pour des requêtes spécifiques — ne les priorisez pas.

Pertinence du sujet : croisez le sujet de la page avec les sujets d'AI Visibility. Si la page couvre un sujet où la marque a une grande pertinence mais une faible visibilité, l'écart de citation est encore plus exploitable.

Présentez à l'utilisateur une liste restreinte classée de 3 à 5 pages à corriger, montrant l'écart de citation et un diagnostic d'une ligne pour chacune :

#PageCitations propresÉcartDiagnostic
1/compare/best-session-replay-tools49−131Le concurrent couvre les rage clicks, la profondeur de défilement, le replay mobile ; cette page non
2/compare/best-ab-testing-platforms-for-mobile-apps30−95Manque d'explication de méthode statistique et de FAQ ; le concurrent a les deux

Demandez : "Quelle page souhaitez-vous corriger en premier ?" Attendez leur choix.


Étape 4 — Diagnostiquer la Page Sélectionnée

Récupérez le contenu réel de la page possédée sélectionnée en utilisant web_fetch ou Chrome si disponible. Récupérez ensuite la page concurrente principale de la même manière. Lisez les deux attentivement.

Comparez-les selon ces dimensions :

Directeté de la réponse — la page possédée répond-elle à la requête IA centrale dans les 2 premières phrases ? Les pages concurrentes qui sont citées le font généralement. Si la page possédée enterre la réponse, c'est la première correction.

Couverture FAQ — la page possédée a-t-elle un bloc FAQ structuré ? Comptez les questions. Les pages concurrentes qui dominent les citations ont souvent 5 à 10 Q&R directes. Si la page possédée n'en a pas, ou les a enterrées dans la prose, c'est une correction à haute valeur.

Spécificité — la page possédée fait-elle des affirmations concrètes sur le produit (« suit les rage clicks, les cartes de chaleur de défilement et les enregistrements de session simultanément ») ou vagues (« vous aide à comprendre le comportement des utilisateurs ») ? Les modèles d'IA citent des spécificités, pas des généralités.

Sections manquantes — quelles sections H2 le concurrent a-t-il que la page possédée n'a pas ? Listez chacune d'elles. Ce sont des lacunes à combler.

Cadrage concurrentiel — la page possédée reconnaît-elle honnêtement le paysage concurrentiel ? Les pages qui comparent les outils honnêtement ont tendance à mieux se classer dans les réponses IA que les pages qui prétendent que les alternatives n'existent pas.

Signaux structurels — balisage schema, hiérarchie des titres, table des matières, tableaux comparatifs. Ceux-ci améliorent la possibilité d'analyse pour les modèles d'IA.

Résumez le diagnostic sous forme d'une courte liste de constats avant d'écrire quoi que ce soit. L'utilisateur doit pouvoir voir ce que vous avez trouvé et être d'accord avant que vous ne commenciez la réécriture.


Étape 5 — Générer la Réécriture

Sur la base du diagnostic, produisez la révision. Préférez des correctifs chirurgicaux au niveau des sections aux réécritures de page entière, sauf si la page a des problèmes structurels fondamentaux — une réécriture ciblée est plus rapide à réviser, plus facile à approuver et moins susceptible de casser ce qui fonctionne déjà.

Format pour les correctifs au niveau des sections

Pour chaque section modifiée, montrez un avant/après clair :

### SECTION : [Titre H2]

AVANT :
[texte original, cité ou paraphrasé]

APRÈS :
[texte révisé — phrases complètes et réelles, pas un squelette]

POURQUOI : [1 phrase de justification liée au diagnostic]

Que corriger, par ordre de priorité

  1. Paragraphe d'ouverture — réécrivez-le pour répondre directement à la requête IA centrale dans les 2 premières phrases. Ne faites pas défiler le lecteur pour trouver la réponse.

  2. Sections manquantes — ajoutez les sections H2 que la page concurrente a et que la page possédée n'a pas. Écrivez-les complètement, avec les capacités spécifiques d'Amplitude et des détails concrets.

  3. Bloc FAQ — s'il manque, ajoutez-en un. S'il est faible, développez-le. Utilisez de vraies requêtes d'AI Visibility (depuis get_ai_visibility_prompts sur le sujet connexe) comme source de questions. Chaque réponse doit comporter 2 à 4 phrases, être directe et inclure au moins un fait spécifique au produit.

  4. Améliorations de la spécificité — trouvez chaque phrase vague (« aide les équipes à comprendre le comportement ») et remplacez-la par quelque chose de concret (« montre les cartes de clic, la profondeur de défilement, les rage clicks et les dead clicks ainsi que l'abandon en entonnoir, afin que vous sachiez exactement où les utilisateurs abandonnent et pourquoi »).

  5. Tableau comparatif — si la page compare des outils et n'a pas de tableau de fonctionnalités, ajoutez-en un. Les modèles d'IA adorent citer des données de comparaison structurées.

Champs méta à mettre à jour

Incluez toujours les champs méta mis à jour avec la réécriture :

  • metaTitle — 50 à 60 caractères, riche en mots-clés
  • metaDescription — 140 à 160 caractères, répond à la requête centrale et inclut un appel à l'action
  • slug — confirmez qu'il est correct ; suggérez un changement uniquement s'il est clairement sous-optimal

Étape 6 — Simuler avant de Publier (optionnel mais recommandé)

Avant de pousser vers le CMS, mentionnez la fonctionnalité Simuler les modifications d'AI Visibility :

"AI Visibility a une fonctionnalité 'Simuler les modifications' qui peut prédire comment votre contenu mis à jour se comporterait avant que vous ne le publiiez. Si vous souhaitez l'exécuter d'abord, collez le contenu révisé dans Simuler les modifications dans le tableau de bord AI Visibility et vérifiez l'amélioration de citation projetée. Je peux attendre, ou pousser le brouillon maintenant et vous pouvez simuler en parallèle."

Laissez l'utilisateur décider. S'il souhaite simuler d'abord, faites une pause ici et dites-lui quoi coller. S'il est prêt à pousser, passez directement à l'Étape 7.


Étape 7 — Pousser la Mise à Jour vers le CMS

Utilisez ce que vous avez découvert à l'Étape 0.

Si un MCP CMS est connecté

Il s'agit d'une mise à jour d'une page existante, pas d'un nouveau document. Utilisez des opérations de mise à jour, pas de création :

Sanity — utilisez patch_document_from_markdown avec l'ID de document de la page existante. Ne corrigez que les champs qui ont changé. Confirmez l'ID de document avec l'utilisateur si vous ne l'avez pas : "Quel est l'ID de document Sanity pour cette page ?" N'utilisez jamais publish_documents sans instruction explicite.

Contentful — utilisez update_entry avec l'ID d'entrée. Ne corrigez que les champs modifiés. Définissez published: false pour qu'il aille en brouillon/révision.

HubSpot — utilisez update_blog_post avec l'ID de publication. Définissez state: DRAFT.

WordPress — utilisez wp_update_post avec l'ID de publication. Définissez status: draft.

Ghost — utilisez update_post avec l'ID de publication. Définissez status: draft.

Webflow — utilisez update_cms_item avec l'ID d'élément. Laissez-le non publié.

Après avoir poussé, confirmez : "Terminé — le [titre de la page] révisé est enregistré comme brouillon dans [CMS]. Voici l'ID/URL : [lien]. Révisez-le là-bas avant de publier."

Si aucun CMS n'est connecté

Produisez le contenu révisé complet sous forme de bloc Markdown propre, structuré comme un diff :

  • Sections qui restent identiques : marquez-les comme [INCHANGÉ]
  • Sections nouvelles ou réécrites : montrez-les en entier
  • Champs méta mis à jour en haut

Proposez ensuite : "Vous souhaitez connecter [CMS] maintenant pour que je puisse pousser directement la prochaine fois ? Cela prend environ 2 minutes."

Fournissez toujours la sortie Markdown même lorsque la poussée CMS réussit, afin que l'équipe ait une copie locale.


Ce qui rend une page digne d'être citée par l'IA

L'objectif est d'être la source que les modèles d'IA utilisent lorsqu'ils répondent à des questions dans votre catégorie. Quelques principes qui fonctionnent systématiquement :

  • Répondez vite. Les 2 premières phrases d'une page ont un poids disproportionné. Si la réponse est à la ligne 40, les modèles d'IA ne citent souvent pas la page du tout.
  • Les blocs FAQ sont des aimants à citations. Les Q&R structurées correspondent directement au format de requête que les modèles d'IA reçoivent. Une FAQ de 5 questions sur une page de comparaison peut doubler le nombre de citations.
  • La spécificité l'emporte sur l'autorité. Une page qui dit "Amplitude capture les rage clicks, la profondeur de défilement et les enregistrements de session utilisateur avec une latence inférieure à 100 ms" sera citée plutôt qu'une page qui dit "nous vous aidons à comprendre vos utilisateurs" — même si cette dernière provient d'une marque plus grande.
  • Les tableaux comparatifs sont extraits. Les modèles d'IA adorent les données structurées. Un tableau comparatif de fonctionnalités est cité beaucoup plus souvent que les mêmes informations écrites en prose.
  • Une couverture équitable des concurrents signale la fiabilité. Les pages qui reconnaissent ce que les concurrents font bien — tout en expliquant pourquoi la marque est un meilleur choix pour des cas d'utilisation spécifiques — sont traitées comme des sources plus autoritaires que les copies promotionnelles pures.

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

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