Communitygithub.com

amplitude/builder-skills

Use esta skill sempre que um usuário quiser entender quais fontes externas estão sendo citadas por modelos de IA em tópicos relevantes para sua marca e quiser criar conteúdo que supere essas fontes — seja com frases como "quais fontes os modelos de IA estão citando", "por que [site de terceiros] está sendo citado em vez de nós", "queremos ser a fonte definitiva sobre X", "criar algo que seja mais citado que G2 ou TechRadar", "criar um ativo de autoridade" ou qualquer variação onde o objetivo seja produzir um novo ativo de referência (página de definição, benchmark, metodologia, glossário, hub de comparação) projetado para superar as principais fontes citadas. Esta skill analisa dados de Visibilidade de IA, faz engenharia reversa do que torna as páginas mais citadas autoritativas e produz um ativo de fonte superior — e o envia para o CMS como rascunho. Ative em qualquer menção a "fontes", "citações de terceiros", "conteúdo autoritativo", "páginas definitivas" ou "superar".

O que é builder-skills?

Esta skill, chamada Source Outranker, foi projetada para equipes de conteúdo que desejam se tornar a fonte primária citada por modelos de IA — não apenas para consultas de marca, mas para perguntas que definem uma categoria. Ela funciona identificando quais páginas externas estão sendo citadas pelos modelos de IA em tópicos relevantes para a marca do usuário, analisando por que essas páginas são consideradas autoritárias e criando um ativo de conteúdo superior para superá-las. A skill é compatível com os principais CMS, incluindo Sanity, Contentful, HubSpot, WordPress, Ghost e Webflow, e é acionada por comandos como "quais fontes os modelos de IA estão citando" ou "criar um ativo de autoridade". O fluxo de trabalho envolve detectar o CMS disponível, extrair as principais fontes terceiras citadas, auditar sua estrutura e conteúdo para identificar padrões de autoridade, selecionar o tipo de ativo mais estratégico (guia definitiva, relatório de benchmark, hub de comparação, etc.), gerar o conteúdo completo e enviá-lo como rascunho para o CMS. A skill enfatiza que modelos de IA favorecem fontes que respondem perguntas específicas de forma direta, incluem dados com metodologia transparente, cobrem o tópico de forma abrangente, exibem sinais de atualização e possuem links para outros sinais de autoridade.

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

Perguntar na sua IA favorita

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

Documentação

Source Outranker

Você está ajudando uma equipe de conteúdo a se tornar a fonte primária que os modelos de IA citam — não apenas para consultas de marca, mas para perguntas que definem uma categoria. Quando uma IA é questionada "o que é analytics de produto" ou "como funcionam as ferramentas de analytics digital", ela cita a página que considera mais autoritativa. Esta skill encontra essas páginas, descobre o que as torna vencedoras e cria algo melhor.


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

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

Verifique se já existem ferramentas de CMS conectadas

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

CMSPadrões de nomes de ferramentas a serem procurados
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: "Vejo que [CMS] está conectado — vou enviar o novo ativo de fonte para lá como rascunho quando terminarmos. Tudo bem?" 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 diretamente para lá como rascunho, em vez de te entregar um bloco de texto para colar."

Ofereça: Sanity · Contentful · HubSpot · WordPress · Webflow · Ghost · Outro · "Apenas me dê o conteúdo"

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


Etapa 1 — Identifique a Marca e Extraia as Principais Fontes Citadas

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

Em seguida, chame get_ai_visibility_sources com o orgBrandId selecionado, ordenado por citationCount decrescente. Isso retorna todos os domínios sendo citados por modelos de IA em tópicos relevantes para a marca, com campos incluindo: domain, citationCount, responseCount, url, title.

Separe os resultados em dois grupos:

  • Fontes próprias: páginas no domínio da própria marca (ex.: amplitude.com)
  • Fontes de terceiros: todo o resto — sites de avaliação, mídia, documentação, blogs de concorrentes

As fontes de terceiros que superam o domínio da própria marca são os alvos. Estas são as páginas que você precisa superar.

Identifique as 10 principais fontes de terceiros por contagem de citações. Apresente um resumo:

Domínio da fonteCitaçõesTipo
g2.com340Agregador de avaliações
contentsquare.com/blog180Blog de concorrente
techradar.com150Mídia
...

Além disso, chame get_ai_visibility_topics para entender quais tópicos estão gerando essas citações — você usará isso para escolher qual ativo de fonte construir.


Etapa 2 — Audite o Que Torna as Principais Fontes Vencedoras

Para cada uma das 5 principais fontes de terceiros, busque o conteúdo real da página usando web_fetch. Leia cada uma com atenção. Você está procurando os padrões estruturais e de conteúdo que tornam essas páginas autoritativas para os modelos de IA.

Avalie cada fonte em:

Estrutura da resposta: A página responde a uma pergunta clara diretamente? Ela tem uma hierarquia de H2s e H3s que mapeiam subperguntas? Páginas com estrutura clara são extraídas de forma mais confiável.

Dados e especificidade: A página cita estatísticas, benchmarks, resultados de pesquisas ou outros dados verificáveis? Modelos de IA citam desproporcionalmente páginas com dados concretos em vez de opiniões.

Abrangência: Ela cobre o tópico exaustivamente — histórico, mecânica, casos de uso, comparação, FAQs? Cobertura superficial perde para cobertura aprofundada.

Sinais de atualização: A página exibe proeminentemente uma data, "Atualizado para [ano]" ou faz referência a eventos recentes? Modelos de IA favorecem fontes que parecem atuais.

Sinais de autoridade: Credenciais do autor, reputação da empresa, divulgações de metodologia, citações de pesquisa, referências a pares.

Tipo de ativo: Qual formato torna esta página autoritativa? Formatos vencedores comuns:

  • Guias definitivas ("O que é analytics de produto")
  • Relatórios de benchmark ("Estado do analytics de produto 2025")
  • Explicadores de metodologia ("Como funciona a gravação de sessão")
  • Glossários ("Termos de analytics de produto explicados")
  • Hubs de comparação ("Ferramentas de analytics de produto comparadas")

Resuma a auditoria como um padrão: "As fontes mais citadas sobre este tópico compartilham: [3–4 padrões]. O conteúdo existente da marca carece de: [2–3 lacunas]."


Etapa 3 — Identifique a Oportunidade do Ativo de Fonte

Com base na auditoria, identifique o ativo de fonte de maior alavancagem para construir. Pontue as oportunidades por:

Lacuna de citação: quantas citações a mais a fonte externa principal tem em relação à melhor página própria da marca sobre o mesmo tópico? Uma lacuna de 200+ citações é um alvo de alto valor.

Importância estratégica do tópico: cruze referência com get_ai_visibility_topics — este é um tópico onde a marca tem alta relevância, mas baixa visibilidade? Se sim, possuir a fonte teria impacto composto.

Facilidade de construção: a marca pode possuir este tipo de ativo com credibilidade? Um relatório de benchmark requer dados; um guia definitivo requer apenas conhecimento especializado. Prefira ativos que a marca possa produzir com autoridade.

Guia de seleção do tipo de ativo:

  • Se as principais fontes forem páginas definitivas → construa um guia abrangente que vá mais fundo
  • Se as principais fontes forem agregadores de avaliação (G2, Capterra) → construa uma página de metodologia/transparência que os modelos de IA citem como fonte primária para critérios de comparação
  • Se as principais fontes forem blogs de concorrentes → construa um ativo neutro e rico em dados que seja mais autoritativo do que a versão autocentrada do concorrente
  • Se as principais fontes forem relatórios de mídia/analistas → construa um benchmark proprietário ou relatório de pesquisa

Apresente 2–3 opções de ativos com recomendação:

#Tipo de ativoTópico alvoLacuna de citação estimadaRecomendação
1Guia definitiva"O que é analytics de produto"−280Construir primeiro: definitivo, alto volume
2Relatório de benchmark"Adoção de analytics de produto 2025"−140Construir em segundo: requer dados
3Hub de comparação"Ferramentas de analytics de produto comparadas"−95Bom, mas espaço competitivo

Pergunte: "Qual ativo você quer construir?" Aguarde a escolha.


Etapa 4 — Gere o Ativo de Fonte

Escreva o ativo completo. Não um esqueleto — conteúdo completo, pronto para publicação, que seja genuinamente mais útil, específico e abrangente do que as fontes que ele foi projetado para superar.

Modelos de tipo de ativo

Guia Definitiva ("O que é X", "Como X funciona", "O guia completo de X")

  • H1: responde à pergunta definitiva diretamente
  • Abertura (2–3 parágrafos): definição direta na frase 1; por que isso importa; o que o guia cobre
  • Seções principais (5–8 H2s): definição → como funciona → componentes principais → casos de uso por tipo de empresa → como avaliar → considerações de implementação → FAQs
  • Pontos de dados: inclua pelo menos 5 estatísticas ou benchmarks concretos (cite fontes ou observe que são de pesquisa da Amplitude se proprietários)
  • Auxílios visuais descritos: mencione quais diagramas, capturas de tela ou tabelas reforçariam cada seção — mesmo que as imagens não sejam incluídas, a estrutura descrita sinaliza autoridade
  • Bloco de FAQ: 6–8 perguntas e respostas usando a linguagem exata dos prompts de Visibilidade de IA sobre este tópico
  • Links internos: 4–5 links para conteúdo relacionado da Amplitude
  • Nota de última atualização: inclua um "Última atualização: [mês/ano atual]" nos metadados

Relatório de Benchmark ("Estado de X", "Relatório de tendências de X", "X em números")

  • H1: "Relatório de Benchmark de [Categoria] [Ano]: Principais Métricas e Tendências"
  • Resumo executivo: 5–7 descobertas principais em formato de lista
  • Seção de metodologia: como os dados foram coletados, tamanho da amostra, período — os modelos de IA adoram citar metodologia transparente
  • Seções de dados (4–6 H2s): cada uma com uma descoberta principal, dados de suporte e interpretação
  • Comparação por segmento: empresa vs SMB, verticais da indústria, estágio da empresa
  • Análise de tendências: mudanças ano a ano, se disponível
  • Recomendações: o que os dados significam para as equipes de produto
  • Bloco de FAQ: 4–5 perguntas e respostas

Hub de Comparação ("Ferramentas de X comparadas", "Melhores plataformas de X", "Guia de software de [Categoria]")

  • H1: "Melhores Ferramentas de [Categoria] em [Ano]: Comparadas para Equipes de Produto"
  • Critérios de seleção: como as ferramentas foram avaliadas — isso torna a comparação confiável
  • Tabela de comparação resumida: 8–10 ferramentas, dimensões principais, destaques de melhor uso
  • Análises aprofundadas por ferramenta: 200–300 palavras cada, cobrindo pontos fortes, limitações, modelo de preço, casos de uso ideais
  • Estrutura de decisão: formato "Escolha X se você [condição]" para 5–6 cenários
  • Bloco de FAQ: 5–6 perguntas e respostas

Sempre inclua campos de metadados

  • metaTitle — 50–60 caracteres, contém a palavra-chave principal
  • metaDescription — 140–160 caracteres, sinaliza autoridade e abrangência
  • slug — rico em palavras-chave, específico (ex.: /blog/o-que-e-analytics-de-produto não /blog/analytics)
  • lastUpdated — data atual

Etapa 5 — Envie para o CMS

Use o que descobriu na Etapa 0. Este é um novo documento (operação de criação, não de atualização).

Sanity — use create_documents_from_markdown com o conteúdo completo do ativo. Defina _type para corresponder ao esquema de blog/artigo. Pergunte ao usuário se não tiver certeza: "Qual é o tipo de documento para guias longos no seu esquema do Sanity?" Nunca use publish_documents sem instrução explícita.

Contentful — use create_entry com contentType correspondente ao tipo de artigo deles. Defina fields.title, fields.slug, fields.body. Deixe published: false.

HubSpot — use create_blog_post com state: DRAFT. Inclua meta descrição e slug.

WordPress — use wp_create_post com status: draft. Mapeie H1 para title, corpo para content.

Ghost — use create_post com status: draft. Inclua slug, title, html ou lexical, e meta_description.

Webflow — use create_cms_item visando a Coleção do blog. Mapeie os campos para o esquema da Coleção (pergunte ao usuário os nomes dos campos se não estiver óbvio pelo contexto).

Após o envio, confirme: "Pronto — [título do ativo] foi salvo como rascunho em [CMS]. Aqui está o ID/URL: [link]. Revise-o lá antes de publicar."

Sempre forneça um fallback em Markdown do conteúdo completo, mesmo quando o envio para o CMS for bem-sucedido.


O que torna uma fonte autoritativa para modelos de IA

Os modelos de IA não citam fontes porque são de uma grande marca. Eles citam fontes que:

  • Respondem a uma pergunta específica melhor do que ninguém. A melhor fonte para "o que é analytics de produto" é a página que o define de forma mais clara, mais completa e mais direta.
  • Incluem dados com metodologia transparente. Um benchmark que diz "pesquisamos 500 equipes de produto" é citado em vez de um que diz "principais especialistas acreditam".
  • Cobrem o tópico de todos os ângulos. Modelos de IA preferem fontes abrangentes a fontes estreitas. Um guia que cobre definição, mecânica, casos de uso, critérios de avaliação e FAQs superará uma página mais curta em qualquer dimensão única.
  • Estão claramente datadas. Uma tag "Atualizado em abril de 2025" sinaliza atualização. Modelos de IA evitam citar fontes desatualizadas em tópicos que mudam rapidamente.
  • Linkam para outros sinais de autoridade. Links internos para conteúdo relacionado, citações externas de dados, credenciais do autor — todos aumentam a pontuação de confiança da página no treinamento e na inferência da 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.

Habilidades Relacionadas