Communitygithub.com

amplitude/builder-skills

Use esta habilidade sempre que um usuário quiser testar variantes de conteúdo antes de publicar para descobrir qual será mais citada por modelos de IA — seja

O que é builder-skills?

Esta habilidade transforma o processo de publicação de conteúdo em uma decisão orientada por dados, em vez de um palpite. Ao receber uma oportunidade de conteúdo, ela gera 2 a 3 variantes distintas com diferentes ângulos e estruturas, em seguida, pontua cada uma delas com base nas respostas reais de modelos de IA coletadas pela plataforma AI Visibility da Amplitude. O fluxo de trabalho identifica lacunas no que a IA atualmente cita, recomenda a variante vencedora e, após validação opcional via o recurso 'Simulate Changes', publica o conteúdo diretamente no CMS conectado (como Sanity, Contentful, HubSpot, WordPress, Ghost ou Webflow). É especialmente útil para equipes de conteúdo que desejam maximizar a visibilidade e a taxa de citação em respostas de IA generativa, substituindo a adivinhação por simulações e análises comparativas. Plataformas suportadas: Claude Code, Cursor, Codex e outros agentes de IA com acesso a ferramentas CMS.

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

Perguntar na sua IA favorita

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

Documentação

Publicação com Simulação

Você está ajudando uma equipe de conteúdo a parar de adivinhar. Em vez de publicar um único conteúdo e torcer para que seja citado, esta habilidade gera 2 a 3 variantes distintas, pontua cada uma contra o que os modelos de IA estão realmente dizendo sobre este tópico e recomenda aquele com maior probabilidade de ganhar citações — antes que uma única palavra vá ao ar.


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 vencedor será publicado. Isso evita um beco sem saída no final do fluxo de trabalho.

Verifique se já existem ferramentas CMS conectadas

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

CMSPadrões de nome de ferramenta para 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: "Vejo que [CMS] está conectado — vou enviar a variante vencedora como rascunho para lá quando terminarmos. Tudo bem?" Em seguida, vá 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 a variante vencedora diretamente para lá como rascunho em vez de entregar um bloco de texto para copiar e colar."

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

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


Etapa 1 — Identifique a Oportunidade para Simular

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

O usuário pode chegar aqui com uma oportunidade já em mãos (por exemplo, de executar prompt-gap-to-publish ou competitor-prompt-hijacker). Se for o caso, use essa oportunidade diretamente.

Se não, use get_ai_visibility_topics com o orgBrandId selecionado para mostrar as 3 a 5 principais oportunidades usando a heurística de pontuação padrão: tópicos com relevância > 60% e visibilidade < 40%. Apresente-as brevemente e pergunte qual simular.

Confirme a oportunidade com o usuário antes de construir as variantes:

"Vou gerar variantes para: [título da oportunidade]. Os prompts alvo são: [2 a 3 exemplos de prompts]. Isso corresponde ao que você deseja testar?"


Etapa 2 — Carregue o Contexto das Respostas do LLM

Para a oportunidade selecionada, obtenha as respostas reais dos modelos de IA usando:

  • get_ai_visibility_prompts com o topicId relevante para obter a lista de prompts
  • get_ai_visibility_prompt_responses para os 5 a 8 prompts com maior responseCount

Leia cada resposta com cuidado. Esta é a verdade fundamental — é exatamente o que os modelos de IA dizem atualmente quando questionados neste espaço. Suas variantes serão pontuadas em relação a esse contexto.

Extraia das respostas:

  • Qual linguagem e enquadramento os modelos de IA usam? (vocabulário, formato da pergunta, termos-chave)
  • Quais afirmações eles fazem? (estatísticas, capacidades do produto, ferramentas nomeadas)
  • O que está faltando ou é superficial? (áreas onde a resposta da IA é vaga, hesitante ou cita fontes fracas)
  • Quais marcas aparecem nas respostas? (concorrentes sendo citados que não deveriam)
  • Qual formato as respostas usam? (listas, prosa, tabelas — seu conteúdo deve corresponder)

Esse contexto é a rubrica de pontuação para as variantes que você construirá.

Também chame get_ai_visibility_sentiment para entender o tom: o sentimento da IA em relação à marca é positivo, neutro ou negativo neste tópico? As variantes devem ser projetadas para reforçar o sentimento positivo ou neutralizar o enquadramento negativo.


Etapa 3 — Gere 2 a 3 Variantes

Construa 2 a 3 variantes distintas do conteúdo. Cada variante deve adotar um ângulo ou estrutura significativamente diferente — não apenas o mesmo conteúdo com introduções diferentes. Pequenas reescritas não ajudam a aprender nada; alternativas genuínas sim.

Eixos de diferenciação de variantes

Escolha os eixos mais relevantes para a oportunidade:

Ângulo: Educacional ("Como funciona X") vs. Competitivo ("Amplitude vs alternativas") vs. Caso de uso ("Melhor X para [segmento específico]")

Abertura: Dados primeiro (comece com um benchmark ou estatística) vs. Problema primeiro (comece com o ponto de dor) vs. Resposta primeiro (comece com a resposta direta à pergunta central)

Profundidade: Guia abrangente (formato longo, cobre tudo) vs. Afiado e específico (resposta focada em uma pergunta) vs. Interativo/estruturado (uso intenso de tabelas, matrizes de comparação, FAQs)

Enquadramento: Foco na marca ("Aqui está como a Amplitude faz X") vs. Neutro em relação à categoria ("Aqui está como a análise de produto funciona — e onde a Amplitude se encaixa") vs. Competitivo ("O guia honesto sobre ferramentas X")

Formato da variante

Para cada variante, escreva:

  1. H1 completo e parágrafo de abertura (a parte que os modelos de IA mais pesam)
  2. Esboço dos H2 com uma descrição de 1 a 2 frases do conteúdo de cada seção
  3. Uma seção totalmente escrita — o H2 mais importante, escrito completamente
  4. Bloco de FAQ completo — 4 a 6 perguntas e respostas usando a linguagem exata dos prompts da Etapa 2
  5. Campos de metadados: metaTitle, metaDescription, slug

Identifique-os claramente: Variante A, Variante B, Variante C.


Etapa 4 — Pontue Cada Variante em Relação ao Contexto do LLM

Agora avalie cada variante em relação às respostas reais do modelo de IA da Etapa 2. Esta é a simulação. Pontue cada variante em uma escala de 1 a 5 nas seguintes dimensões:

Alinhamento com o prompt (1-5): O H1, a abertura e o FAQ da variante correspondem diretamente à linguagem e ao formato de pergunta usados nos prompts do AI Visibility? Pontuação 5 se a variante espelhar a linguagem do prompt de perto; pontuação 1 se usar terminologia diferente ou enterrar a resposta.

Direcionamento da resposta (1-5): A variante responde à pergunta central nas primeiras 2 frases? Pontuação 5 se sim; pontuação 3 se a resposta aparecer dentro do parágrafo de abertura; pontuação 1 se o leitor precisar rolar.

Especificidade (1-5): A variante faz afirmações concretas e verificáveis ("A Amplitude captura rage clicks, profundidade de rolagem e mapas de calor em sessões abaixo de 100ms") em vez de genéricas? Pontuação 5 se cada afirmação importante for específica; pontuação 1 se as afirmações forem principalmente genéricas.

Cobertura de lacunas (1-5): A variante cobre as áreas onde as respostas atuais da IA são superficiais ou ausentes? Pontuação 5 se preencher todas as lacunas identificadas; pontuação 1 se repetir em grande parte o que os modelos de IA já dizem.

Correspondência estrutural (1-5): O formato da variante corresponde a como os modelos de IA já estão apresentando este tópico? Pontuação 5 se a estrutura espelhar o formato da resposta (por exemplo, se os modelos de IA usam listas, a variante as usa de forma proeminente).

Apresente as pontuações como uma tabela:

DimensãoVariante AVariante BVariante C
Alinhamento com o prompt453
Direcionamento da resposta345
Especificidade534
Cobertura de lacunas443
Correspondência estrutural354
Total192119

Declare a recomendação claramente: "A Variante B obteve a pontuação mais alta (21/25). Seu bloco de FAQ espelha a linguagem exata dos prompts do AI Visibility e responde à pergunta central na primeira frase. Recomendo publicar a Variante B."


Etapa 5 — Ponto de Verificação de Simulação de Mudanças

Antes de enviar para o CMS, faça referência ao recurso integrado Simulate Changes do AI Visibility:

"O AI Visibility possui um recurso 'Simulate Changes' que executa seu conteúdo em prompts de modelos de IA ao vivo e projeta a melhoria na citação antes de você publicar. Aqui está o que colar: [o texto completo da abertura + bloco de FAQ da variante vencedora]

Para executar: abra o AI Visibility → selecione sua marca → vá para Simulate Changes → cole o conteúdo → execute a simulação. Aguardo, ou envie o rascunho agora e você pode simular em paralelo."

Deixe o usuário decidir. Se ele quiser simular primeiro, pause e forneça o texto exato para colar. Se ele estiver pronto para enviar, vá para a Etapa 6.

Se a simulação retornar e mudar a opinião deles sobre qual variante usar, gere a variante revisada por completo antes de enviar.


Etapa 6 — Construa o Vencedor por Completo

Assim que a variante for selecionada (com ou sem resultados da simulação), escreva o artigo completo:

  • H1 completo até o CTA final — sem placeholders, sem "[adicione seção aqui]"
  • Todas as seções H2 do esboço, escritas completamente
  • Bloco de FAQ completo (4 a 6 perguntas e respostas)
  • Campos de metadados: metaTitle, metaDescription, slug
  • Nota "Última atualização: [mês/ano atual]" nos metadados

Também salve as variantes vice-campeãs como um bloco Markdown no final — identifique-as claramente como alternativas. Elas podem ser usadas para testes A/B após o lançamento ou adaptadas para diferentes canais.


Etapa 7 — Envie para o CMS

Use o que descobriu na Etapa 0. Isso é um novo documento (operação de criar, não de atualizar), a menos que o usuário especifique que está atualizando uma página existente.

Sanity — use create_documents_from_markdown com a variante vencedora. Defina _type para corresponder ao esquema de blog/artigo. Pergunte se não tiver certeza: "Qual é o tipo de documento para artigos 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 direcionando 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 for óbvio).

Após enviar, confirme: "Pronto — [título do artigo] foi salvo como rascunho no [CMS]. Aqui está o ID/URL: [link]. As variantes vice-campeãs estão abaixo em Markdown — salve-as para uso futuro ou testes A/B."

Sempre produza um fallback em Markdown da variante vencedora, além das alternativas vice-campeãs, mesmo quando o envio para o CMS for bem-sucedido.


Por que simular antes de publicar

Cada conteúdo é uma aposta. A publicação com simulação transforma essa aposta em uma escolha fundamentada:

  • O alinhamento com o prompt é o preditor mais forte de citação. Conteúdo que espelha a linguagem exata que os modelos de IA usam em prompts será recuperado e citado de forma muito mais confiável do que conteúdo escrito em linguagem SEO genérica.
  • O direcionamento da resposta se acumula ao longo do tempo. A primeira frase de uma página tem peso desproporcional na recuperação pela IA. Uma variante que responde na frase 1 superará consistentemente uma que leva três parágrafos para chegar lá.
  • A cobertura de lacunas é a vitória de citação mais rápida. Se as respostas da IA sobre um tópico forem superficiais ou vagas em uma subpergunta específica, a primeira página a respondê-la de forma concreta se torna a citação de referência.
  • As variantes expõem suposições. Escrever 3 versões do mesmo conteúdo força a equipe a articular o que realmente acredita que o público precisa — e a pontuação muitas vezes as surpreende.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

amplitude/builder-skills

Performs deep analysis of a specific Amplitude chart to explain trends, anomalies, and likely drivers. Use when a metric looks unusual, investigating a spike or drop, or understanding the "why" behind numbers.

amplitude/builder-skills

Deeply analyze Amplitude dashboards by analyzing key charts, surfacing top areas for concern and takeaways, identify anomalies, then explain changes using customer feedback trends.

amplitude/builder-skills

Designs A/B tests with proper metrics and variants, analyzes running or completed experiments, and interprets results with statistical rigor. Use when setting up experiments, checking experiment status, analyzing results, or making ship decisions.

amplitude/builder-skills

Synthesizes customer feedback into actionable themes including feature requests, bugs, pain points, and praise. Use when planning product roadmap, understanding user sentiment, investigating specific issues, or preparing voice-of-customer reports.

amplitude/builder-skills

Analyze MCP server usage instrumented with Amplitude's MCP Analytics SDK: break usage and errors down by tool, read the rationales within each tool to see what callers are trying to do, and produce a prioritized write-up of actionable fixes. Use this skill whenever the user asks to understand how their MCP server is being used, what agents/users are trying to do with it, why tool calls are failing, what to fix or improve in their MCP server, or asks for an "MCP usage report", "tool error analysis", "intent analysis", "rationale clustering", or "MCP insights". Also trigger when the user mentions [MCP]-prefixed events, tool rationale, tool call errors, or just finished instrumenting their MCP server and wants to see what the data says. Requires the Amplitude MCP connector.

amplitude/builder-skills

Read lost deals and churned accounts from your CRM, extract reasons clustered by theme (missing features, pricing, competitors, UX), and write a prioritized weekly analysis with product improvement recommendations. Use before roadmap planning or to build the case for prioritizing retention work.

amplitude/builder-skills

Creates Amplitude charts from natural language descriptions, handling event selection, filters, groupings, and visualization choices. Use when you know what you want to measure but prefer not to build the chart manually.

amplitude/builder-skills

Guide an Amplitude user through building a custom agent by suggesting use cases grounded in their role and data, shaping the idea into a well-formed spec, and generating a ready-to-run Global Agent deeplink that creates it. Use to create, build, or set up a custom agent, automate a recurring analysis, or put a repeated report on a schedule.

amplitude/builder-skills

Builds comprehensive Amplitude dashboards from requirements or goals, organizing charts into logical sections with appropriate layouts. Use when creating a complete dashboard from scratch or assembling existing charts into a cohesive view.

amplitude/builder-skills

Monitors all active and recently completed experiments across Amplitude projects, triages them by importance, then runs deep analysis and reporting on the most impactful ones. Use when the user asks to "check on experiments", "experiment status", "experiment review", "what experiments are running", or wants a periodic experiment health report.

amplitude/builder-skills

Pull Intercom tickets and Slack support messages from the past 7 days, classify each signal, enrich with CRM data (ARR, plan, renewal), score by customer value and churn risk, and output a tiered priority report saved to Drive. Use when you need a fast, data-driven view of what support signals matter most.

amplitude/builder-skills

Use this skill whenever a user wants to improve existing pages on their website to get cited more by AI models — whether they say "our pages aren't getting cited", "improve this page for AI visibility", "which of our pages should we update", "make this article more cite-worthy", "our competitors are getting cited instead of us", "update our content for AI search", or any variation where the goal is improving an existing asset rather than creating something new. This skill pulls owned pages from AI Visibility, identifies which ones have citation potential but are underperforming, compares them against the external pages that are winning citations on the same topics, and produces section-level rewrites or a full-page update — then pushes the revision to the CMS as a draft. Trigger even if the user just says "help me get cited more" or "why is [competitor] getting cited instead of us".

amplitude/builder-skills

Use this skill whenever a user wants to win AI citations on prompts that competitors currently dominate — whether they say "competitors are getting cited instead of us", "we're losing on these prompts", "how do I outrank [competitor] in AI answers", "find prompts where we should be winning", "create content to beat [competitor]", or any variation where the goal is capturing AI share on prompts a competitor currently owns. This skill pulls competitor visibility data from AI Visibility, identifies the specific prompts where competitors win and Amplitude is absent, clusters them by intent, and produces targeted comparison pages, alternatives content, or rebuttal assets — then pushes drafts to CMS. Trigger on any mention of competitor, prompt hijack, outrank, or "why is [competitor] getting cited instead of us".

amplitude/builder-skills

Use this skill whenever a user wants to turn AI Visibility data into published content — whether they say "find content gaps", "what should we write about", "which topics have low visibility", "help me get cited by AI models", "create a blog post from our AI Visibility gaps", "we're losing to competitors on these prompts", or any variation where they want to go from AI visibility weakness to a draft article, landing page, or FAQ. This skill connects directly to Amplitude AI Visibility data (topics, prompts, visibility scores, citations, competitor data, full LLM responses and sources) and produces a publish-ready content brief plus full article draft. If the user mentions CMS (WordPress, Webflow, Contentful, Sanity, HubSpot, Ghost, Shopify), also trigger this skill to push the draft directly. Trigger even if they just say something vague like "what content should we create?" in an AI Visibility context.

amplitude/builder-skills

Use this skill whenever a user wants to understand which external sources are being cited by AI models on topics relevant to their brand, and wants to create content that will outrank those sources — whether they say "what sources are AI models citing", "why is [third-party site] being cited instead of us", "we want to be the definitive source on X", "build something that gets cited more than G2 or TechRadar", "create an authoritative asset", or any variation where the goal is producing a new reference asset (definition page, benchmark, methodology, glossary, comparison hub) designed to beat existing top-cited sources. This skill analyzes AI Visibility source data, reverse-engineers what makes top-cited pages authoritative, and produces a superior source asset — then pushes it to CMS as a draft. Trigger on any mention of "sources", "third-party citations", "authoritative content", "definitional pages", or "outrank".

amplitude/builder-skills

Instrument a Node/TypeScript MCP server with Amplitude's @amplitude/mcp-analytics SDK so tool calls, sessions, and rationale are tracked as Amplitude events. Use this skill whenever the user wants to add Amplitude analytics to their MCP server, mentions "MCP Analytics", "@amplitude/mcp-analytics", "instrument my MCP server", "track MCP tool calls", "add rationale to my MCP tools", or wants agent traffic (Claude, Cursor, ChatGPT) attributed back to Amplitude. Also use for adding UTM tagging to MCP-returned links, or for troubleshooting identity/user_id mismatches between MCP events and web/mobile Amplitude data.

amplitude/builder-skills

Instruments a pull request with Amplitude analytics that conform to the project's existing taxonomy. Reads the tracking plan via the Amplitude MCP server (events, properties, naming conventions), analyzes the PR diff to find the few user actions genuinely worth tracking, detects the codebase's SDK and tracking patterns, and adds instrumentation that matches both. Optionally (opt-in) stages new events and properties on an Amplitude tracking-plan branch for data-governance review. Use when asked to "instrument this PR", "add analytics to this change", "add tracking", "add Amplitude events", "instrument this feature", or "what should I track here".

amplitude/builder-skills

Diagnoses product health by cross-referencing Amplitude analytics (dashboards, charts, funnels, feedback, AI agent analytics), optionally Datadog (errors, latency, stack traces), and optionally Slack (qualitative feedback, bug reports, feature requests). Identifies what's broken, what's working, and what to do about it — with root causes, not just symptoms. Use when asked to "diagnose my product", "what's going on", "product health check", "what's broken", "where are users struggling", "give me a product diagnosis", or "what should I focus on".

amplitude/builder-skills

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

amplitude/builder-skills

Summarizes B2B account health by analyzing usage patterns, engagement trends, risk signals, and expansion opportunities. Use for customer success reviews, renewal preparation, QBRs, or account prioritization.

Habilidades Relacionadas