Communitygithub.com

amplitude/builder-skills

Use esta skill sempre que um usuário quiser transformar dados de Visibilidade de IA em conteúdo publicado — seja para encontrar lacunas de conteúdo, criar artigos, páginas de destino ou FAQs. Ela se conecta diretamente aos dados de Visibilidade de IA da Amplitude (tópicos, prompts, pontuações de visibilidade, citações, dados de concorrentes, respostas completas de LLMs e fontes) e produz um brief de conteúdo pronto para publicação, além de um rascunho completo do artigo. Se o usuário mencionar um CMS (WordPress, Webflow, Contentful, Sanity, HubSpot, Ghost, Shopify), acione esta skill também para enviar o rascunho diretamente. Acione mesmo que eles digam algo vago como

O que é builder-skills?

Esta skill capacita agentes de IA a transformar dados de Visibilidade de IA da Amplitude em conteúdo editorial completo e pronto para publicação. Ela identifica lacunas de conteúdo onde a marca tem baixa visibilidade nos resultados de modelos de linguagem (LLMs), mas alta relevância no segmento — um indicador claro de oportunidade. Com base nesses gaps, a skill gera um brief de conteúdo detalhado e um rascunho completo do artigo, incluindo slug, meta descrição, corpo, bloco de FAQ e chamada para ação. Além disso, a skill suporta publicação direta em CMS populares como WordPress, Webflow, Contentful, Sanity, HubSpot, Ghost e Shopify, via MCP, bem como fallback para Markdown. O fluxo de trabalho inclui: detecção de CMS, identificação da marca, extração de dados de tópicos e prompts do relatório mais recente, ranqueamento de oportunidades, geração do conteúdo e, finalmente, envio do rascunho para o CMS ou formatação Markdown. As instruções dentro da SKILL.md orientam o agente a priorizar tópicos com relevância > 60% e visibilidade < 40%, a analisar os prompts mais fracos e a produzir conteúdo otimizado para citação por modelos de IA, com dicas como responder diretamente à pergunta nos primeiros parágrafos e usar blocos de FAQ.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/content-marketing-skills/skills/prompt-gap-to-publish

Perguntar na sua IA favorita

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

Documentação

Lacuna de Prompt para Publicação

Você está ajudando uma equipe de marketing ou conteúdo a transformar lacunas de Visibilidade de IA em conteúdo real publicado. A percepção central: quando modelos de IA respondem a perguntas na sua categoria de produto, a presença da sua marca é mensurável — % de visibilidade, classificação média, número de citações. Onde você está fraco é onde deve escrever. Esta skill encontra essas lacunas e produz um rascunho de artigo pronto para publicação — e o envia diretamente para o CMS do usuário como rascunho.


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

Antes de puxar qualquer dado, descubra onde o conteúdo será publicado. Isso evita que o usuário termine em um beco sem saída de copiar e colar.

Verificar ferramentas CMS já conectadas

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

CMSPadrões de nomes de ferramentas MCP a verificar
Sanitysanity, create_documents_from_markdown, publish_documents
Contentfulcontentful, create_entry, publish_entry
HubSpot CMShubspot, create_blog_post, update_blog_post
WordPresswordpress, wp_create_post
Ghostghost, create_post
Webflowwebflow, create_cms_item

Se um MCP de CMS já estiver conectado: Ótimo — confirme com o usuário em uma frase: "Vejo que você tem o [CMS] conectado — enviarei o artigo como rascunho quando terminarmos. Tudo bem?" Em seguida, prossiga para o Passo 1.

Se nenhum MCP de CMS for detectado: Pergunte diretamente ao usuário. Seja breve e amigável — é um momento de configuração única:

"Antes de começarmos — qual CMS você usa para publicar? Quando eu souber, posso enviar o artigo diretamente como rascunho, em vez de entregar um bloco de Markdown para colar."

Ofereça estas opções (ou deixe o usuário digitar a sua):

  • Sanity
  • Contentful
  • HubSpot CMS
  • WordPress
  • Webflow
  • Ghost / Shopify / Outro
  • "Apenas me dê o Markdown por enquanto"

Recomendar a integração com base na resposta

Assim que souber o CMS, dê uma recomendação curta e específica — e ofereça para continuar enquanto eles configuram:

Sanity:

"O conector MCP do Sanity está disponível no marketplace do Cowork. Vá em Configurações → Plugins → pesquise 'Sanity' e conecte-o com seu ID de projeto e token. Leva cerca de 2 minutos. Quer que eu continue encontrando suas lacunas de conteúdo enquanto você faz isso? Estarei pronto para enviar o rascunho quando você estiver conectado."

Contentful:

"Há um conector MCP do Contentful disponível. Vá em Configurações → Plugins → pesquise 'Contentful' e adicione seu ID de Espaço e token da API de Gerenciamento de Conteúdo. Continuar encontrando lacunas agora?"

HubSpot CMS:

"O HubSpot pode já estar conectado via Glean. Se não, pesquise 'HubSpot' em Configurações → Plugins. Criarei um rascunho de postagem de blog lá quando terminarmos."

WordPress:

"O WordPress pode se conectar via MCP (pesquise 'WordPress' em Configurações → Plugins — você precisará da URL do seu site e de uma Senha de Aplicativo do admin do WordPress). Alternativamente, posso usar o Chrome para criar o rascunho diretamente no seu admin do WordPress — basta compartilhar a URL. Qual funciona melhor?"

Webflow:

"A API do CMS do Webflow é o caminho mais limpo — pesquise 'Webflow' em Configurações → Plugins e conecte-se com sua chave de API e ID da Coleção. Também posso automatizar via Chrome se preferir não configurar um plugin."

Ghost:

"O Ghost tem uma API Admin bem documentada. Pesquise 'Ghost' em Configurações → Plugins e adicione sua chave de API Admin e URL do site. Rápido de configurar."

"Apenas Markdown por enquanto":

"Sem problema — no final, darei a você um arquivo Markdown limpo, formatado para colar diretamente em qualquer CMS. Você pode conectar seu CMS mais tarde e enviaremos diretamente."

Após dar a recomendação, não espere que o usuário termine a configuração — diga algo como: "Começarei a puxar suas lacunas de conteúdo agora. Quando eu tiver o artigo pronto, você estará tudo certo." Em seguida, prossiga para o Passo 1.

Armazene qual CMS eles nomearam e se está conectado — você usará isso no Passo 6.


Passo 1 — Identificar a Marca

Use list_ai_visibility_org_brands para buscar as marcas disponíveis e, em seguida:

  • Se o usuário mencionou um nome de marca específico, faça a correspondência.
  • Se houver apenas uma marca na lista, use-a sem perguntar.
  • Caso contrário, apresente a lista e peça ao usuário para escolher.

Anote o orgBrandId — você precisará dele ao longo de todo o processo.


Passo 2 — Puxar os Dados de Tópicos do Relatório Mais Recente

Use get_ai_visibility_topics com o orgBrandId selecionado (omitir reportId para obter o mais recente). Para cada tópico, capture: topicId, topicName, visibilityPercentage, averageRank, relevancyScore e contagens de citações.

Heurística de oportunidade: tópicos com relevância > 60% e visibilidade < 40% são sua mina de ouro — os modelos de IA os consideram centrais para a categoria da marca, mas mal mencionam a marca. Sinalize também tópicos onde um concorrente lidera por 20+ pontos.


Passo 3 — Aprofundar em Prompts

Para os 3–5 principais tópicos de oportunidade, use get_ai_visibility_prompts com o topicId. Procure por:

  • Prompts onde a marca tem 0% ou visibilidade muito baixa
  • Prompts onde os concorrentes dominam a resposta
  • Prompts com altas contagens de respostas (mais respostas de IA = mais oportunidade de citação)

Se disponível, use get_ai_visibility_prompt_responses para ler as respostas geradas pelos LLMs reais para os prompts mais fracos — isso mostra exatamente o que os modelos de IA dizem atualmente. É o melhor brief possível para escrever uma resposta melhor.


Passo 4 — Classificar e Apresentar as Oportunidades

Apresente uma lista classificada de 3–5 oportunidades de conteúdo:

#TópicoPrompt representativoVisibilidade AmplitudePrincipal concorrenteTipo de conteúdo
1..."..."X%Concorrente Y%Página de destino

Guia de tipo de conteúdo:

  • Postagem de blog — consultas informacionais / de comparação ("O que é X?", "X vs Y", "Como o X funciona?")
  • Página de destino — consultas de alta intenção ("Melhor ferramenta X", "X para [caso de uso]")
  • Página de FAQ — clusters de perguntas relacionadas sobre um tópico
  • Descrição de produto — consultas específicas de recursos onde a marca deve ser a fonte definitiva

Pergunte: "Qual destes você quer escrever primeiro?" Aguarde a escolha.


Passo 5 — Gerar o Rascunho de Conteúdo

Escreva um rascunho completo e pronto para publicação para a oportunidade escolhida. Não um esqueleto — frases reais, conteúdo real. O usuário deve poder colar isso em um CMS hoje.

Sempre incluir

Brief de conteúdo (no início):

  • Prompt / pergunta alvo
  • Intenção de busca: informacional / navegacional / comercial
  • Público primário
  • Lacuna do concorrente: o que os concorrentes dizem que a marca não diz?
  • Insight do LLM: citação ou paráfrase do que os modelos de IA dizem atualmente sobre este tópico

Campos do artigo:

  • slug — amigável para URL, rico em palavras-chave
  • metaTitle — 50–60 caracteres, contém a palavra-chave principal
  • metaDescription — 140–160 caracteres, resume o artigo com um CTA

Corpo do artigo:

  • H1 — corresponde de perto ao prompt alvo
  • Introdução (2–3 parágrafos) — gancho, autoridade da marca, prévia do artigo
  • Corpo (3–6 seções H2) — resposta abrangente; cite capacidades específicas do produto com detalhes concretos; inclua dados ou exemplos; cada seção deve ensinar algo independentemente útil
  • Bloco de FAQ (3–5 perguntas e respostas) — puxe prompts intimamente relacionados do Passo 3; 2–4 frases por resposta; estes são os formatos que os modelos de IA citam com mais confiabilidade
  • Links internos (3–5 sugestões) — faça referência a nomes de páginas ou padrões de URL prováveis
  • CTA — um próximo passo claro

Dicas para conteúdo que é citado por modelos de IA

  • Responda à pergunta exata nas primeiras 2 frases. Modelos de IA citam fontes que respondem diretamente.
  • Seja específico sobre as capacidades do produto. "A Amplitude rastreia X" supera "ajudamos empresas a crescer."
  • Cubra os concorrentes de forma justa. Artigos que reconhecem a concorrência classificam melhor do que aqueles que fingem que ela não existe.
  • Use as frases exatas que os modelos de IA usam. Espelhe a linguagem do prompt no seu H1 e primeiro parágrafo.
  • O bloco de FAQ é seu ímã de citação mais poderoso — formate-o como perguntas e respostas diretas, não como prosa fluida.

Passo 6 — Publicar no CMS

Use o que aprendeu no Passo 0.

Se um MCP de CMS estiver conectado

Crie um rascunho diretamente. Siga esta sequência:

  1. Mostre ao usuário o slug, título e as primeiras 100 palavras — pergunte "Pronto para enviar isso para o [CMS] como rascunho?"
  2. Uma vez confirmado, crie o rascunho com status draft (nunca published sem instrução explícita).
  3. Informe de volta com a URL do rascunho ou ID do documento para que o usuário possa encontrá-lo imediatamente.

Sanity — use create_documents_from_markdown com o conteúdo do artigo. Defina _type para corresponder ao esquema de postagem de blog do usuário (pergunte se não tiver certeza: "Qual é o tipo de documento para postagens de blog no seu esquema do Sanity?"). Use publish_documents apenas se o usuário pedir explicitamente para publicar.

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

HubSpot — use a ferramenta de criação de postagem de blog com state: DRAFT. Inclua meta description e slug na chamada da API.

WordPress — use wp_create_post com status: draft. Mapeie o H1 para title e o corpo do artigo para content.

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

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

Se nenhum CMS estiver conectado ainda

Se o usuário disse "apenas Markdown" ou ainda não conectou um CMS:

"Aqui está seu artigo completo em Markdown — pronto para colar no [CMS]. Quando estiver pronto para conectar o [CMS], posso enviar artigos futuros automaticamente."

Gere o artigo completo como um bloco Markdown limpo e bem estruturado.

Também diga: "Quer que eu ajude a configurar a conexão com o [CMS] agora? Leva cerca de 2 minutos." Se sim, guie o usuário pela configuração do plugin do Passo 0.

Sempre gere o fallback Markdown — mesmo quando a criação no CMS for bem-sucedida — para que o usuário tenha uma cópia local de sua propriedade.

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