Communitygithub.com

amplitude/builder-skills

Use esta habilidade sempre que um usuário quiser melhorar páginas existentes em seu site para serem mais citadas por modelos de IA — seja dizendo 'nossas páginas não estão sendo citadas', 'melhore esta página para visibilidade em IA', 'quais de nossas páginas devemos atualizar', 'torne este artigo mais digno de citação', 'nossos concorrentes estão sendo citados em nosso lugar', 'atualize nosso conteúdo para pesquisa por IA' ou qualquer variação em que o objetivo seja melhorar um ativo existente em vez de criar algo novo. Esta habilidade extrai páginas próprias do AI Visibility, identifica quais têm potencial de citação mas estão com baixo desempenho, compara-as com as páginas externas que estão ganhando citações nos mesmos tópicos e produz reescritas no nível da seção ou uma atualização completa da página — em seguida, envia a revisão para o CMS como rascunho. Acione mesmo que o usuário apenas diga 'me ajude a ser mais citado' ou 'por que [concorrente] está sendo citado em nosso lugar'.

O que é builder-skills?

O Otimizador de Recuperação de Citações é uma skill para agentes de IA (como Claude Code, Cursor, Codex) que ajuda equipes de conteúdo a maximizar citações de modelos de IA em páginas web já existentes. A lógica central é: é mais rápido melhorar uma página que já possui algum sinal (citações) do que criar uma do zero. A skill utiliza a ferramenta AI Visibility para identificar páginas próprias da marca que já são citadas e também quais páginas concorrentes estão vencendo nos mesmos tópicos. Com base nessa lacuna de citações, a skill sugere e gera reescritas direcionadas — desde patches em seções específicas até uma revisão completa — e depois publica o conteúdo revisado como rascunho no CMS conectado (como Sanity, Contentful, HubSpot, WordPress, Ghost ou Webflow). O processo é composto por etapas claras: descoberta do CMS, identificação da marca e páginas próprias, comparação com concorrentes, priorização das páginas com maior gap de citações, diagnóstico detalhado do conteúdo, geração da reescrita com foco em especificidade, FAQs e tabelas comparativas, e, por fim, publicação no CMS. A skill também oferece a opção de simular o desempenho das alterações antes de publicar. O resultado é um fluxo de trabalho eficiente e orientado por dados para aumentar a visibilidade e a autoridade do conteúdo em respostas de IA.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Otimizador de Recuperação de Citações

Você está ajudando uma equipe de conteúdo a extrair mais citações de IA de páginas que já existem. A lógica: É mais rápido melhorar uma página que já tem algum sinal do que construir do zero. O AI Visibility mostra quais páginas próprias já estão sendo citadas — e quais páginas concorrentes estão vencendo nos mesmos tópicos. A lacuna entre essas duas é exatamente onde a reescrita deve atuar.


Etapa 0 — Descoberta do CMS (execute uma vez no início de cada sessão)

Antes de fazer qualquer outra coisa, descubra onde o conteúdo revisado será publicado. Isso evita um beco sem saída de copiar e colar no final do fluxo de trabalho.

Verifique se já existem ferramentas CMS conectadas

Examine as ferramentas atualmente disponíveis em seu contexto. Padrões conhecidos de MCP para CMS:

CMSPadrões de nome de ferramenta a procurar
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

Se um MCP de CMS já estiver conectado: confirme em uma linha: "Posso ver que [CMS] está conectado — vou enviar o conteúdo revisado para lá como um rascunho de atualização quando terminarmos. Certo?" Em seguida, prossiga para a Etapa 1.

Se nada estiver conectado: pergunte uma vez, de forma concisa:

"Antes de começarmos — qual CMS você usa para publicar? Posso enviar o conteúdo revisado diretamente para lá como rascunho, em vez de lhe entregar um bloco de texto para colar."

Ofereça: Sanity · Contentful · HubSpot · WordPress · Webflow · Ghost · Outro · "Apenas me dê a reescrita"

Em seguida, dê uma recomendação de configuração personalizada com base na resposta deles (veja a mesma orientação na habilidade prompt-gap-to-publish). Não bloqueie a configuração — comece a análise imediatamente e diga que estará pronto para enviar quando eles estiverem conectados.


Etapa 1 — Identifique a Marca e Extraia as Páginas Próprias

Use list_ai_visibility_org_brands para identificar a marca (ou use o que o usuário especificou).

Em seguida, chame get_ai_visibility_pages com duas restrições principais:

  • orgBrandId = a marca selecionada
  • mentionsBrandId = o mesmo ID da marca (isso filtra para páginas que mencionam a marca)
  • sortBy: "citationCount"

Dos resultados, filtre para páginas no próprio domínio da marca — por exemplo, amplitude.com, não pendo.io ou g2.com. O campo de domínio em cada página facilita isso. Estes são os ativos próprios que você estará melhorando.

Colete para cada página própria:

  • url e title
  • citationCount e responseCount
  • type (landing-page, blog, product-comparison, listicle)
  • brandNames — outras marcas mencionadas junto com elas nesta página (sinaliza o escopo do tópico)

Etapa 2 — Encontre as Páginas Concorrentes que Estão Vencendo nos Mesmos Tópicos

Para os mesmos tópicos cobertos pelas páginas próprias, extraia as páginas externas com as maiores contagens de citações. Use get_ai_visibility_pages novamente sem o filtro de domínio — apenas classificado por citationCount — e procure por páginas de outros domínios que mencionem a mesma marca e cubram tópicos sobrepostos.

Chame também get_ai_visibility_sources classificado por citationCount para ver quais domínios em geral estão recebendo mais citações. Um domínio com classificação muito superior ao site da própria marca é um concorrente que vale a pena estudar de perto.

O que você está construindo é uma comparação: para cada página própria, quem é a página externa que está vencendo no mesmo tópico e por quanto? Por exemplo:

Página própriaCitações própriasPrincipal página concorrenteCitações do concorrente
amplitude.com/compare/best-session-replay-tools49contentsquare.com/blog/session-replay180

Essa lacuna é a oportunidade — e a estrutura da página concorrente é sua referência para como é uma página bem citada neste tópico.


Etapa 3 — Pontue e Priorize as Páginas

Nem todas as páginas com baixo desempenho valem o mesmo esforço. Pontue cada página própria por:

Lacuna de citações (sinal de maior prioridade): citações_do_concorrente - citações_próprias. Uma página com 49 citações próprias, mas 180 na página concorrente, tem uma lacuna de 131 — essa é uma reescrita de alto valor.

Alavancagem do tipo de página: páginas de comparação de produtos e listicles tendem a ser muito citadas por modelos de IA porque respondem diretamente a prompts de "melhor X". Posts de blog sobre tópicos conceituais também são fortes. Landing pages e homepages raramente são citadas para consultas específicas — não priorize essas.

Relevância do tópico: cruze o tópico da página com os tópicos do AI Visibility. Se a página cobre um tópico onde a marca tem alta relevância, mas baixa visibilidade, a lacuna de citações é ainda mais explorável.

Apresente ao usuário uma lista classificada de 3 a 5 páginas para corrigir, mostrando a lacuna de citações e um diagnóstico de uma linha para cada:

#PáginaCitações própriasLacunaDiagnóstico
1/compare/best-session-replay-tools49−131Concorrente cobre rage clicks, profundidade de rolagem, replay mobile; esta página não
2/compare/best-ab-testing-platforms-for-mobile-apps30−95Falta explicador de método estatístico e FAQ; concorrente tem ambos

Pergunte: "Qual página você quer corrigir primeiro?" Aguarde a escolha.


Etapa 4 — Diagnostique a Página Selecionada

Busque o conteúdo real da página própria selecionada usando web_fetch ou Chrome, se disponível. Em seguida, busque a principal página concorrente da mesma forma. Leia ambas com atenção.

Compare-as nestas dimensões:

Diretividade da resposta — a página própria responde ao prompt central da IA nas primeiras 2 frases? Páginas concorrentes que são citadas geralmente o fazem. Se a página própria enterra a resposta, essa é a primeira correção.

Cobertura de FAQ — a página própria tem um bloco de FAQ estruturado? Conte as perguntas. Páginas concorrentes que dominam as citações geralmente têm de 5 a 10 Q&As diretos. Se a página própria não tiver nenhum, ou os tiver enterrados em prosa, essa é uma correção de alto valor.

Especificidade — a página própria faz afirmações concretas sobre o produto ("rastreia rage clicks, mapas de calor de rolagem e gravações de sessão simultaneamente") ou vagas ("ajuda você a entender o comportamento do usuário")? Modelos de IA citam especificidades, não generalidades.

Seções ausentes — quais seções H2 o concorrente tem que a página própria não tem? Liste cada uma. Essas são lacunas a serem preenchidas.

Enquadramento competitivo — a página própria reconhece o cenário competitivo de forma justa? Páginas que comparam ferramentas honestamente tendem a ranquear melhor em respostas de IA do que páginas que fingem que alternativas não existem.

Sinais estruturais — marcação schema, hierarquia de cabeçalhos, índice, tabelas de comparação. Isso melhora a capacidade de análise para modelos de IA.

Resuma o diagnóstico como uma lista curta de descobertas antes de escrever qualquer coisa. O usuário deve ser capaz de ver o que você encontrou e concordar antes de você começar a reescrever.


Etapa 5 — Gere a Reescrita

Com base no diagnóstico, produza a revisão. Prefira patches cirúrgicos no nível da seção em vez de reescritas de página inteira, a menos que a página tenha problemas estruturais fundamentais — uma reescrita direcionada é mais rápida de revisar, mais fácil de aprovar e com menor probabilidade de quebrar coisas que já estão funcionando.

Formato para patches no nível da seção

Para cada seção alterada, mostre um antes/depois claro:

### SEÇÃO: [cabeçalho H2]

ANTES:
[texto original, citado ou parafraseado]

DEPOIS:
[texto revisado — frases completas e reais, não um esqueleto]

POR QUÊ: [1 frase de justificativa ligada ao diagnóstico]

O que corrigir, em ordem de prioridade

  1. Parágrafo de abertura — reescreva-o para responder ao prompt central da IA diretamente nas primeiras 2 frases. Não faça o leitor rolar para encontrar a resposta.

  2. Seções ausentes — adicione as seções H2 que a página concorrente tem e que a página própria não tem. Escreva-as completamente, com capacidades específicas da Amplitude e detalhes concretos.

  3. Bloco de FAQ — se estiver faltando, adicione um. Se estiver fraco, expanda-o. Use prompts reais do AI Visibility (de get_ai_visibility_prompts no tópico relacionado) como fonte de perguntas. Cada resposta deve ter de 2 a 4 frases, ser direta e incluir pelo menos um fato específico do produto.

  4. Upgrades de especificidade — encontre toda frase vaga ("ajuda as equipes a entender o comportamento") e substitua-a por algo concreto ("mostra mapas de clique, profundidade de rolagem, rage clicks e dead clicks juntamente com o funil de abandono, para que você saiba exatamente onde os usuários abandonam e por quê").

  5. Tabela de comparação — se a página compara ferramentas e não tem uma tabela de recursos, adicione uma. Modelos de IA adoram citar dados estruturados de comparação.

Campos de metadados a serem atualizados

Sempre inclua campos de metadados atualizados com a reescrita:

  • metaTitle — 50 a 60 caracteres, rico em palavras-chave
  • metaDescription — 140 a 160 caracteres, responde à consulta principal e inclui um CTA
  • slug — confirme se está correto; sugira uma alteração apenas se estiver claramente abaixo do ideal

Etapa 6 — Simule Antes de Publicar (opcional, mas recomendado)

Antes de enviar para o CMS, mencione o recurso Simular Alterações do AI Visibility:

"O AI Visibility tem um recurso 'Simular Alterações' que pode prever como seu conteúdo atualizado se sairia antes de você publicá-lo. Se quiser executar isso primeiro, cole o conteúdo revisado em Simular Alterações no painel do AI Visibility e verifique a melhoria projetada de citações. Posso esperar, ou enviar o rascunho agora e você pode simular em paralelo."

Deixe o usuário decidir. Se ele quiser simular primeiro, pause aqui e diga o que colar. Se estiver pronto para enviar, vá direto para a Etapa 7.


Etapa 7 — Envie a Atualização para o CMS

Use o que você descobriu na Etapa 0.

Se um MCP de CMS estiver conectado

Esta é uma atualização de uma página existente, não um novo documento. Use operações de atualização, não de criação:

Sanity — use patch_document_from_markdown com o ID do documento da página existente. Apenas atualize os campos que mudaram. Confirme o ID do documento com o usuário se você não o tiver: "Qual é o ID do documento no Sanity para esta página?" Nunca use publish_documents sem instrução explícita.

Contentful — use update_entry com o ID da entrada. Atualize apenas os campos alterados. Defina published: false para que vá para rascunho/revisão.

HubSpot — use update_blog_post com o ID do post. Defina state: DRAFT.

WordPress — use wp_update_post com o ID do post. Defina status: draft.

Ghost — use update_post com o ID do post. Defina status: draft.

Webflow — use update_cms_item com o ID do item. Deixe-o não publicado.

Após enviar, confirme: "Pronto — o [título da página] revisado foi salvo como rascunho no [CMS]. Aqui está o ID/URL: [link]. Revise-o lá antes de publicar."

Se nenhum CMS estiver conectado

Gere o conteúdo revisado completo como um bloco Markdown limpo, estruturado como um diff:

  • Seções que permanecem as mesmas: marque como [INALTERADO]
  • Seções novas ou reescritas: mostre na íntegra
  • Campos de metadados atualizados no topo

Em seguida, ofereça: "Quer conectar o [CMS] agora para que eu possa enviar diretamente na próxima vez? Leva cerca de 2 minutos."

Sempre forneça a saída Markdown mesmo quando o envio para o CMS for bem-sucedido, para que a equipe tenha uma cópia local.


O que torna uma página digna de citação por IA

O objetivo é ser a fonte que os modelos de IA usam ao responder perguntas em sua categoria. Alguns princípios que funcionam consistentemente:

  • Responda rápido. As primeiras 2 frases de uma página têm peso desproporcional. Se a resposta estiver na linha 40, os modelos de IA muitas vezes não citam a página.
  • Blocos de FAQ são ímãs de citação. Q&A estruturado mapeia diretamente para o formato de prompt que os modelos de IA recebem. Um FAQ de 5 perguntas em uma página de comparação pode dobrar a contagem de citações.
  • Especificidade supera autoridade. Uma página que diz "Amplitude captura rage clicks, profundidade de rolagem e gravações de sessão do usuário com latência abaixo de 100ms" será citada em vez de uma página que diz "ajudamos você a entender seus usuários" — mesmo que esta última seja de uma marca maior.
  • Tabelas de comparação são extraídas. Modelos de IA adoram dados estruturados. Uma tabela de comparação de recursos é citada com muito mais frequência do que as mesmas informações escritas como prosa.
  • Cobertura justa do concorrente sinaliza confiabilidade. Páginas que reconhecem o que os concorrentes fazem bem — enquanto explicam por que a marca é a melhor opção para casos de uso específicos — são tratadas como fontes mais autoritárias do que cópia puramente promocional.

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.

Habilidades Relacionadas