Communitygithub.com

amplitude/builder-skills

Escreva posts técnicos de lançamento otimizados para SEO tradicional e para citação por mecanismos de IA (AEO). Use esta habilidade sempre que alguém pedir para escrever um post de anúncio de lançamento, um post técnico para lançamento de produto, um post estilo changelog ou qualquer conteúdo escrito vinculado a um lançamento de produto que viva em um blog ou site de documentação.

O que é builder-skills?

Esta skill automatiza a criação de posts de blog técnicos de alto impacto para lançamentos de produtos, indo além da simples escrita. Ela é projetada para ser usada em plataformas como Claude Code, Cursor e Codex, garantindo que o conteúdo alcance tanto audiências humanas quanto mecanismos de busca modernos, incluindo buscadores de IA como ChatGPT, Perplexity e Google AI Overviews. A skill estrutura o post de acordo com o tipo de lançamento (anúncio, aprofundamento técnico, tutorial ou changelog) e fornece orientação sobre como escrever com valor, evidências e exemplos funcionais. Um diferencial crítico é a integração de otimização para mecanismos de resposta de IA (AEO), com técnicas para tornar parágrafos auto-contidos, citações diretas e uso de dados quantitativos. Além disso, inclui checklist pós-publicação, sugestões de marcação schema e habilidades complementares para estratégia de lançamento, tweets, e-mails e distribuição, tornando-se uma ferramenta completa para profissionais de marketing técnico e desenvolvedores.

Funciona com✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/amplitude/builder-skills/tree/HEAD/launch-skills/skills/launch-blog-post

Perguntar na sua IA favorita

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

Documentação

Post de Blog de Lançamento

Esta habilidade ajuda a escrever posts de blog que anunciam lançamentos de produtos. Um ótimo post de lançamento faz três coisas: informa seu público sobre o que foi lançado e por que isso importa, ranqueia em buscas para termos que seu público está procurando e é citado por mecanismos de resposta de IA quando as pessoas fazem perguntas que seu produto pode resolver.

Tipos de post

Combine o tipo de post com o nível do lançamento e o público.

Post de anúncio

Melhor para: Lançamentos Tier 1 e Tier 2. Público principal: usuários existentes e prospects.

Estrutura: O que foi lançado → por que isso importa → como funciona → como começar. Mantenha abaixo de 1.500 palavras. O leitor deve entender o que mudou e ser capaz de testar em até 5 minutos após a leitura.

Aprofundamento técnico

Melhor para: Lançamentos Tier 1 de produtos técnicos/para desenvolvedores. Público principal: engenheiros avaliando se devem adotar.

Estrutura: Problema → abordagem → arquitetura/implementação → benchmarks → como começar. Pode ser mais longo (2.000-3.000 palavras). Inclua exemplos de código, diagramas de arquitetura e dados de desempenho. Este é o post que é compartilhado no Hacker News.

Tutorial / "Construa X com Y"

Melhor para: Publicado na primeira semana de qualquer lançamento. Público principal: desenvolvedores que acabaram de ouvir falar de você e querem avaliar na prática.

Estrutura: O que estamos construindo → pré-requisitos → implementação passo a passo → resultado. Deve ser concluível em 15-30 minutos. Inclua código funcional completo, não trechos.

Entrada de changelog

Melhor para: Lançamentos Tier 3 e pequenas melhorias agrupadas. Público principal: usuários existentes.

Estrutura: Parágrafo curto por melhoria. Comece com o que mudou, não por quê. Link para a documentação para detalhes. Agrupe semanal ou quinzenalmente.

Escrevendo o post

Comece com o briefing de mensagens

Se existir um briefing de mensagens da estratégia de lançamento, use-o. A proposta de valor principal se torna a tese do post. Propostas de valor secundárias se tornam seções. Pontos de prova se tornam as evidências que você entrelaça.

Se não houver briefing, defina antes de escrever: Para quem é isso? O que eles podem fazer agora? Por que deveriam se importar?

Comece com valor, não com processo

O primeiro parágrafo deve responder: "O que foi lançado e por que isso importa para mim?" Nunca comece com quanto tempo você trabalhou nisso, quantos engenheiros estavam envolvidos ou a jornada que levou até aqui. O leitor não se importa com seu processo — ele se importa com seus problemas.

Boa abertura: "Você agora pode processar arquivos de áudio em 14 idiomas com uma única chamada de API. A latência é inferior a 200ms para arquivos de até 10 minutos."

Abertura fraca: "Após seis meses de trabalho, nossa equipe tem o prazer de anunciar a próxima evolução de nossa plataforma de processamento de áudio."

Mostre, não apenas conte

Para cada afirmação, forneça evidências:

  • Afirmação de desempenho → dados de benchmark com metodologia
  • "Fácil de usar" → exemplo de código funcional em 5-10 linhas
  • "Clientes adoram" → citação específica com contexto
  • "Melhor que alternativas" → tabela de comparação honesta

Inclua um exemplo funcional

Todo post de lançamento para um produto técnico deve incluir código que o leitor possa executar. Não pseudocódigo, não um trecho conceitual — código funcional real com comandos de instalação, imports e saída esperada. Este é o elemento de maior conversão em um post técnico de blog.

Termine com um próximo passo claro

O post precisa exatamente de um CTA no final. "Teste agora", "Leia a documentação", "Participe do beta". Não três opções — uma.

Otimização para SEO

Segmentação de palavras-chave

Escolha a palavra-chave principal antes de escrever. Ela deve corresponder ao que seu público-alvo pesquisa quando tem o problema que seu produto resolve. O título do post, H1 e primeiro parágrafo devem incluir essa palavra-chave naturalmente.

Para posts de lançamento, a palavra-chave costuma ser o nome do recurso/produto + categoria: "[Produto] [Categoria]" (por exemplo, "API de transcrição em tempo real" ou "feature flags de código aberto").

Noções básicas de on-page

  • Title tag: Palavra-chave principal, com menos de 60 caracteres. O título do post do blog e a tag HTML title devem corresponder de perto.
  • Meta description: 150-160 caracteres resumindo o que o leitor aprenderá ou poderá fazer.
  • URL slug: Curto, rico em palavras-chave, sem datas (para que permaneça perene).
  • Cabeçalhos (H2/H3): Use-os para estruturar o post logicamente. Cada H2 deve ser uma pergunta ou tópico que alguém possa pesquisar.
  • Links internos: Link para sua documentação, posts de blog relacionados e página de destino. Link da documentação de volta para este post.
  • Texto alternativo de imagem: Descreva o que está na imagem, incluindo palavras-chave relevantes onde for natural.

Conteúdo para ranqueamento de cauda longa

As seções abaixo do anúncio principal — como funciona, detalhes técnicos, FAQ, comparação — servem como alvos de palavras-chave de cauda longa. Escreva-as para responder perguntas específicas que seu público faz. Uma seção intitulada "Como [recurso] lida com [caso extremo]?" pode ranquear para essa consulta exata.

AEO: Otimização para Mecanismos de Resposta

Mecanismos de busca de IA (ChatGPT, Perplexity, Claude, Gemini e resumos com IA em buscas tradicionais) estão se tornando uma forma primária de as pessoas descobrirem e avaliarem produtos. AEO é a prática de estruturar o conteúdo para que mecanismos de IA o citem ao gerar respostas.

AEO e SEO são complementares, não concorrentes. A maioria das práticas recomendadas de AEO também ajuda no SEO. Mas existem técnicas específicas que tornam o conteúdo mais citável por IA.

Por que AEO é importante para posts de lançamento

Quando alguém pergunta a um assistente de IA "qual é a melhor ferramenta para [coisa que seu produto faz]?" ou "como faço [tarefa que seu produto permite]?", você quer que seu post de lançamento seja uma das fontes das quais a IA extrai. Uma única citação de IA pode gerar descoberta sustentada muito depois que o tráfego do dia do lançamento desaparece.

Tornando o conteúdo citável por IA

Escreva passagens autocontidas e extraíveis. Mecanismos de IA citam passagens, não artigos inteiros. Cada seção do seu post deve fazer sentido por si só, sem exigir que o leitor tenha lido seções anteriores. Um parágrafo que afirma uma reivindicação clara, a apoia com evidências e nomeia seu produto — essa é uma unidade citável.

Comece as seções com respostas diretas. Quando uma seção aborda uma pergunta (mesmo que implicitamente), coloque a resposta na primeira frase e depois elabore. Mecanismos de IA favorecem conteúdo que responde de forma rápida e específica.

Exemplo — em vez de:

"Existem muitos fatores a considerar ao escolher uma API de transcrição. Latência, precisão, suporte a idiomas e preço desempenham um papel. Após testes extensivos, descobrimos que..."

Escreva:

"[Produto] transcreve áudio em 14 idiomas com latência inferior a 200ms a $0,006 por minuto. Veja como os benchmarks se dividem..."

A segunda versão é diretamente citável. Um mecanismo de IA respondendo "qual é a API de transcrição mais rápida?" pode extrair essa frase literalmente.

Use afirmações específicas e quantitativas. Mecanismos de IA citam preferencialmente conteúdo com dados concretos: números, benchmarks, comparações, porcentagens. "API rápida" não é citável. "Latência P99 de 180ms em arquivos de áudio de 10 minutos" é.

Inclua dados estruturados. Tabelas de comparação, matrizes de recursos e tabelas de benchmark são altamente citáveis porque fornecem informações estruturadas e extraíveis. Uma tabela comparando seu produto com alternativas (honestamente) é um dos formatos de conteúdo mais citados por IA.

Escreva seções de FAQ com perguntas genuínas. Seções de FAQ onde cada pergunta corresponde a algo que uma pessoa real perguntaria a um assistente de IA são ímãs de citação. Escreva a pergunta como um H3 natural e responda diretamente na primeira frase.

Marcação Schema para mecanismos de IA

A marcação schema fornece aos mecanismos de IA contexto legível por máquina sobre seu conteúdo. Adicione estes aos seus posts de blog de lançamento:

  • Schema Article / BlogPosting: Informa aos mecanismos de IA que este é um artigo datado com um autor e tópico específicos. Inclua headline, datePublished, dateModified, author e description.
  • Schema FAQPage: Se seu post tiver uma seção de FAQ, marque-a para que os mecanismos de IA possam extrair pares de perguntas e respostas diretamente.
  • Schema HowTo: Se seu post incluir um tutorial ou guia passo a passo, marque as etapas.
  • Schema Product: Se o post anunciar um produto com preço, inclua o schema do produto com name, description e offers.

Você não precisa de todos eles — use os que corresponderem ao conteúdo que você realmente escreveu.

Sinais de atualização de conteúdo

Mecanismos de IA ponderam a atualidade. Páginas que não são atualizadas perdem citações de IA com o tempo. Para posts de lançamento:

  • Inclua um "Última atualização: [data]" visível na página
  • Atualize o dateModified no seu schema Article sempre que fizer alterações
  • Revise os posts de lançamento trimestralmente: atualize benchmarks, adicione novos recursos, atualize exemplos de código
  • Se um post de lançamento se tornar desatualizado, atualize-o ou redirecione para um post mais recente — não deixe conteúdo desatualizado ranqueando

Sinais de entidade e marca

Mecanismos de IA constroem modelos internos de marcas e produtos. Ajude-os sendo consistente:

  • Use o nome exato do seu produto/recurso consistentemente (não alterne entre apelidos)
  • Declare explicitamente a que categoria seu produto pertence ("uma plataforma de feature flags de código aberto")
  • Link para fontes autoritativas sobre sua empresa (homepage, documentação, GitHub, Wikipedia, se aplicável)
  • Certifique-se de que seu produto seja descrito consistentemente em seu blog, documentação, página de destino e perfis sociais

Checklist pós-publicação

Após publicar:

  1. Link de todos os lugares: documentação, página de destino, changelog, posts de blog relacionados, README
  2. Compartilhe nas redes sociais: use a habilidade launch-tweet para criar o texto social
  3. Envie para agregadores: Hacker News, subreddits relevantes, dev.to, Hashnode (para posts técnicos)
  4. Email: inclua no email de lançamento ou no próximo boletim informativo
  5. Monitore perguntas: comentários no post, thread do HN, Reddit — estes geralmente revelam lacunas no post que você deve abordar com atualizações
  6. Atualize após a semana de lançamento: adicione uma história de cliente, atualize benchmarks, corrija quaisquer problemas que os leitores sinalizaram

Habilidades complementares

  • launch-strategy — briefing de mensagens e planejamento de lançamento
  • launch-tweet — texto social para promover o post
  • launch-email — o email que linka para este post
  • launch-video — vídeos de demonstração e GIFs para incorporar no post
  • launch-distribution — onde e como distribuir além do seu blog
  • launch-landing-page — a página para a qual o post do blog linka
  • launch-metrics — configuração de UTM para links do post do blog, rastreamento de desempenho do post ao longo do tempo

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

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

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