Communitygithub.com

amplitude/builder-skills

Utilisez cette compétence pour analyser les sources citées par les IA sur des sujets liés à votre marque et créer un contenu plus autoritaire qui les surclasse.

Qu'est-ce que builder-skills ?

Cette compétence permet à un agent IA (comme Claude Code, Cursor ou Codex) d'aider une équipe contenu à devenir la source de référence que les modèles d'IA citent en priorité. Elle débute par une découverte du CMS connecté (Sanity, Contentful, HubSpot, WordPress, Ghost, Webflow) pour éviter les impasses de copier-coller. Ensuite, elle identifie la marque et extrait les sources les plus citées par les IA sur des sujets pertinents via `get_ai_visibility_sources`, en séparant les sources propriétaires des sources tierces. L'audit détaillé des 5 premières sources tierces examine la structure des réponses, les données spécifiques, la couverture du sujet, les signaux de fraîcheur et les signaux d'autorité. Enfin, elle génère un nouvel actif de contenu (guide définitionnel, rapport de référence, hub de comparaison) et le pousse directement comme brouillon dans le CMS, en respectant des templates précis pour chaque type d'actif, avec des métadonnées complètes et un ton d'autorité propre à surclasser les sources existantes.

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

Demander à votre IA préférée

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

Documentation

Source Outranker

Vous aidez une équipe contenu à devenir la source principale que les modèles d'IA citent — pas seulement pour les requêtes sur la marque, mais pour les questions qui définissent la catégorie. Quand une IA demande "qu'est-ce que l'analyse produit" ou "comment fonctionnent les outils d'analyse numérique", elle cite la page qu'elle juge la plus autoritaire. Cette compétence trouve ces pages, découvre ce qui les rend gagnantes et crée quelque chose de meilleur.


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

Avant toute chose, déterminez où le nouveau contenu sera publié. Cela évite une impasse de copier-coller en fin de workflow.

Vérification des outils CMS déjà connectés

Analysez les outils actuellement dans votre contexte. Modèles d'outils 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 nouvel actif source comme brouillon une fois terminé. Cela vous va ?" Puis passez à l'Étape 1.

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

"Avant de commencer — sur quel CMS publiez-vous ? Je peux pousser le contenu directement comme brouillon au lieu de vous donner un bloc de texte à copier-coller."

Proposez : Sanity · Contentful · HubSpot · WordPress · Ghost · Webflow · Autre · "Donnez-moi juste le contenu"

Ensuite, donnez une recommandation de configuration personnalisée selon leur réponse (mêmes conseils que dans prompt-gap-to-publish). Ne bloquez pas sur la configuration — commencez l'analyse immédiatement et dites que vous serez prêt à publier quand ils seront connectés.


Étape 1 — Identifier la marque et extraire les sources les plus citées

Utilisez list_ai_visibility_org_brands pour identifier la marque (ou utilisez ce que l'utilisateur a spécifié).

Appelez ensuite get_ai_visibility_sources avec orgBrandId sélectionné, trié par citationCount décroissant. Cela retourne chaque domaine cité par les modèles d'IA sur des sujets pertinents pour la marque, avec les champs : domain, citationCount, responseCount, url, title.

Séparez les résultats en deux groupes :

  • Sources propriétaires : pages sur le domaine de la marque (par ex., amplitude.com)
  • Sources tierces : tout le reste — sites d'avis, médias, documentation, blogs concurrents

Les sources tierces qui surpassent le domaine de la marque sont les cibles. Ce sont les pages que vous devez battre.

Identifiez les 10 premières sources tierces par nombre de citations. Présentez un résumé :

Domaine sourceCitationsType
g2.com340Agrégeur d'avis
contentsquare.com/blog180Blog concurrent
techradar.com150Média
...

Appelez aussi get_ai_visibility_topics pour comprendre quels sujets génèrent ces citations — vous l'utiliserez pour choisir quel actif source construire.


Étape 2 — Auditer ce qui rend les meilleures sources gagnantes

Pour chacune des 5 premières sources tierces, récupérez le contenu réel de la page en utilisant web_fetch. Lisez chacune attentivement. Vous cherchez les modèles structurels et de contenu qui rendent ces pages autoritaires aux yeux des modèles d'IA.

Évaluez chaque source selon :

Structure de réponse : La page répond-elle à une question claire de manière directe ? A-t-elle une hiérarchie de H2s et H3s qui correspondent à des sous-questions ? Les pages avec une structure claire sont plus fiables lors du scraping.

Données et spécificité : La page cite-t-elle des statistiques, des benchmarks, des résultats d'enquête ou d'autres données vérifiables ? Les modèles d'IA citent de manière disproportionnée les pages avec des données concrètes plutôt que des opinions.

Exhaustivité : Couvre-t-elle le sujet de manière exhaustive — historique, mécanismes, cas d'usage, comparaison, FAQ ? Une couverture légère perd face à une couverture approfondie.

Signaux de fraîcheur : La page affiche-t-elle une date, "Mis à jour pour [année]", ou référence-t-elle des événements récents ? Les modèles d'IA préfèrent les sources qui semblent actuelles.

Signaux d'autorité : Accréditations de l'auteur, réputation de l'entreprise, divulgations méthodologiques, citations de recherche, références par des pairs.

Type d'actif : Quel format rend cette page autoritaire ? Formats gagnants courants :

  • Guides définitionnels ("Qu'est-ce que l'analyse produit")
  • Rapports de référence ("État de l'analyse produit 2025")
  • Explications méthodologiques ("Comment fonctionne l'enregistrement de session")
  • Glossaires ("Termes d'analyse produit expliqués")
  • Hubs de comparaison ("Outils d'analyse produit comparés")

Résumez l'audit comme un modèle : "Les sources les plus citées sur ce sujet partagent : [3–4 modèles]. Le contenu existant de la marque manque de : [2–3 lacunes]."


Étape 3 — Identifier l'opportunité d'actif source

En fonction de l'audit, identifiez l'actif source à construire offrant le meilleur levier. Évaluez les opportunités selon :

Écart de citation : combien de citations supplémentaires la meilleure source externe a-t-elle par rapport à la meilleure page propriétaire de la marque sur le même sujet ? Un écart de 200+ citations est une cible à forte valeur.

Importance stratégique du sujet : croisez avec get_ai_visibility_topics — s'agit-il d'un sujet où la marque a une forte pertinence mais une faible visibilité ? Si oui, dominer la source aurait un impact amplifié.

Faisabilité de construction : la marque peut-elle légitimement posséder ce type d'actif ? Un rapport de référence nécessite des données ; un guide définitionnel nécessite juste de l'expertise. Privilégiez les actifs que la marque peut produire avec autorité.

Guide de sélection du type d'actif :

  • Si les meilleures sources sont des pages définitionnelles → construisez un guide complet qui va plus loin
  • Si les meilleures sources sont des agrégateurs d'avis (G2, Capterra) → construisez une page de méthodologie/transparence que les modèles d'IA citent comme source principale pour les critères de comparaison
  • Si les meilleures sources sont des blogs concurrents → construisez un actif neutre, riche en données, plus autoritaire que la version intéressée du concurrent
  • Si les meilleures sources sont des rapports médias/analystes → construisez un benchmark propriétaire ou un rapport de recherche

Présentez 2–3 options d'actifs avec recommandation :

#Type d'actifSujet cibleÉcart de citation estiméRecommandation
1Guide définitif"Qu'est-ce que l'analyse produit"−280Construire d'abord : définitionnel, volume élevé
2Rapport de référence"Adoption de l'analyse produit 2025"−140Construire ensuite : nécessite des données
3Hub de comparaison"Outils d'analyse produit comparés"−95Bon, mais espace concurrentiel

Demandez : "Quel actif souhaitez-vous construire ?" Attendez leur choix.


Étape 4 — Générer l'actif source

Rédigez l'actif complet. Pas une ébauche — un contenu complet, prêt à publier, qui est réellement plus utile, spécifique et complet que les sources qu'il est conçu pour surpasser.

Modèles par type d'actif

Guide Définitif ("Qu'est-ce que X", "Comment fonctionne X", "Le guide complet de X")

  • H1 : répond directement à la question définitionnelle
  • Ouverture (2–3 paragraphes) : définition directe dans la phrase 1 ; pourquoi c'est important ; ce que couvre le guide
  • Sections principales (5–8 H2s) : définition → fonctionnement → composants clés → cas d'usage par type d'entreprise → comment évaluer → considérations de mise en œuvre → FAQ
  • Points de données : incluez au moins 5 statistiques ou benchmarks concrets (citez les sources ou mentionnez qu'ils proviennent de la recherche Amplitude si propriétaires)
  • Aides visuelles décrites : mentionnez quels diagrammes, captures d'écran ou tableaux renforceraient chaque section — même si les images ne sont pas incluses, la structure décrite signale l'autorité
  • Bloc FAQ : 6–8 Q&R en utilisant le langage exact des prompts AI Visibility sur ce sujet
  • Liens internes : 4–5 liens vers du contenu connexe d'Amplitude
  • Note de dernière mise à jour : incluez une mention "Dernière mise à jour : [mois/année en cours]" dans les métadonnées

Rapport de Référence ("État de X", "Rapport de tendances X", "X en chiffres")

  • H1 : "Rapport de référence [Catégorie] [Année] : Indicateurs et tendances clés"
  • Résumé exécutif : 5–7 résultats clés en format liste à puces
  • Section méthodologie : comment les données ont été collectées, taille de l'échantillon, période — les modèles d'IA adorent citer une méthodologie transparente
  • Sections de données (4–6 H2s) : chacune avec un résultat principal, des données de support et une interprétation
  • Comparaison par segment : entreprise vs PME, secteurs verticaux, stade de l'entreprise
  • Analyse des tendances : changements d'une année sur l'autre si disponibles
  • Recommandations : ce que les données signifient pour les équipes produit
  • Bloc FAQ : 4–5 Q&R

Hub de Comparaison ("Outils X comparés", "Meilleures plateformes X", "Guide logiciel [Catégorie]")

  • H1 : "Meilleurs outils [Catégorie] en [Année] : Comparés pour les équipes produit"
  • Critères de sélection : comment les outils ont été évalués — cela rend la comparaison digne de confiance
  • Tableau récapitulatif des comparaisons : 8–10 outils, dimensions clés, mentions "meilleur pour"
  • Analyses approfondies par outil : 200–300 mots chacun, couvrant les points forts, les limites, le modèle de tarification, les cas d'usage les mieux adaptés
  • Cadre de décision : format "Choisissez X si vous [condition]" pour 5–6 scénarios
  • Bloc FAQ : 5–6 Q&R

Inclure toujours les champs méta

  • metaTitle — 50–60 caractères, contient le mot-clé principal
  • metaDescription — 140–160 caractères, signale autorité et exhaustivité
  • slug — riche en mots-clés, spécifique (par ex., /blog/qu-est-ce-que-l-analyse-produit pas /blog/analyse)
  • lastUpdated — date actuelle

Étape 5 — Pousser vers le CMS

Utilisez ce que vous avez découvert à l'Étape 0. C'est un nouveau document (opération de création, pas de mise à jour).

Sanity — utilisez create_documents_from_markdown avec le contenu complet de l'actif. Définissez _type pour correspondre au schéma blog/article. Interrogez l'utilisateur si vous n'êtes pas sûr : "Quel est le type de document pour les guides longs 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. Associez H1 à title, le corps à 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. Associez les champs au schéma de la Collection (demandez les noms des champs à l'utilisateur si le contexte ne les rend pas évidents).

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

Affichez toujours une version Markdown de repli du contenu complet, même lorsque la poussée CMS réussit.


Ce qui rend une source autoritaire aux yeux des modèles d'IA

Les modèles d'IA ne citent pas des sources parce qu'elles proviennent d'une grande marque. Ils citent des sources qui :

  • Répondent à une question spécifique mieux que quiconque. La meilleure source pour "qu'est-ce que l'analyse produit" est la page qui le définit le plus clairement, le plus complètement et le plus directement.
  • Incluent des données avec une méthodologie transparente. Un benchmark qui dit "nous avons enquêté auprès de 500 équipes produit" est cité plutôt qu'un qui dit "les principaux experts croient."
  • Couvrent le sujet sous tous les angles. Les modèles d'IA préfèrent les sources complètes aux sources étroites. Un guide qui couvre la définition, les mécanismes, les cas d'usage, les critères d'évaluation et la FAQ battra une page plus courte sur n'importe quelle dimension unique.
  • Sont clairement datées. Une étiquette "Mis à jour en avril 2025" signale la fraîcheur. Les modèles d'IA évitent de citer des sources obsolètes sur des sujets en évolution rapide.
  • Lient vers d'autres signaux d'autorité. Les liens internes vers du contenu connexe, les citations externes de données, les accréditations de l'auteur — tout cela augmente le score de confiance de la page dans l'entraînement et l'inférence de l'IA.

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

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