CommunityEscrita e Ediçãogithub.com

alchemyleads-seo/agent-pass-titles

Regras e um método de teste para escrever títulos, meta descrições, excertos e H1s que agentes de IA escolhem e citam ao responder a pergunta de um usuário. Cabeçalhos em formato de resposta superam os criativos, focados em problema, credenciais ou com ano, e os agentes priorizam uma página por tópico por site. Use ao escrever ou atualizar um título ou meta descrição, auditar títulos para busca por IA ou escolher qual postagem deve dominar um tópico. Acione com "title and meta", "rewrite the headline", "agent pass", "why isn't this post cited", "which post should own this topic".

O que é agent-pass-titles?

Esta skill, `agent-pass-titles`, fornece um conjunto de regras baseado em evidências para criar títulos e meta descrições que agentes de IA (como o Claude) citam com mais frequência ao responder perguntas de usuários. Derivada de um experimento real onde um autor testou 38 posts no Claude, ela revela que o formato mais eficaz é aquele em que o título e a descrição leem-se como a própria resposta à pergunta, superando abordagens tradicionais como focar no problema ou em credenciais. A skill também ensina a escolher uma única página vencedora por tópico e a adaptar a linguagem para o público-alvo, seja um usuário final ou o próprio agente. Inclui um padrão de reescrita prático, uma checklist de verificação e um método opcional de teste A/B para validar variantes antes de publicar alterações importantes.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alchemyleads-seo/ai-seo-skills/tree/HEAD/skills/agent-pass-titles

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Agent pass: títulos e descrições que agentes citam

De AlchemyLeads · ai-seo-skills · Licença MIT

Fonte: Mike Taylor (head of evals, Every), newsletter de outubro de 2026. Ele executou agentes Claude em perguntas reais de usuários com seus 38 posts como candidatos e contou quantas vezes cada um foi citado. Um autor, um site e uma configuração onde o agente escolhe de uma lista — portanto, trate os números como indicativos. O padrão se repetiu em todas as perguntas testadas.

Os agentes escolhem a partir do título + descrição (meta description, excerto, subtítulo). O corpo do texto só importa após a seleção.

As regras

  1. A descrição parece a resposta para a pergunta. Quando dois posts eram igualmente relevantes, o que tinha formato de resposta venceu: 94% vs 1%, 100% vs 8%, 71% vs 0%. Frases de efeito e opiniões ("Avaliações geralmente são tudo que você precisa") perdem para "Escolha o melhor modelo para o trabalho que você realiza".
  2. Comece com o que o leitor ganha. "Guia de Engenharia de Prompt: Cinco Princípios com Exemplos" marcou 100%. Os mesmos cinco princípios começando pelo problema ("Por que suas respostas de IA são superficiais, e…") marcaram 54%, e começando por credenciais ("…Do coautor do livro da O'Reilly…") marcaram 50%. Coloque a entrega nas primeiras palavras: guia, checklist, custo, etapas, comparação, número de itens.
  3. Sem ano ou "definitivo". "O Guia Definitivo para Engenharia de Prompt" foi de 2% para 0% com a adição de "(Atualizado 2026)". Mantenha a atualização no corpo e no byline (wp-last-updated-dates), nunca no título.
  4. Um vencedor por tópico por site. Os agentes apoiaram um post por pergunta e ignoraram a maioria dos irmãos (92% vs 12% / 8% / 0%). Transformar um post em formato de resposta reduziu a citação de um irmão de 65% para 19%. Antes de reescrever, escolha qual URL deve dominar a pergunta. Torne esse o mais óbvio, direcione os outros para perguntas diferentes e aponte-os para o vencedor com links internos.
  5. Escreva para um leitor específico. Os agentes citaram um site com mais frequência quando sabiam quem estavam ajudando e essa pessoa correspondia ao público do site (42% sem usuário, 50% com uma persona detalhada). Nomeie o ICP na descrição quando fizer sentido ("para fabricantes", "para equipes B2B").
  6. Duas audiências de agente. Um agente respondendo para um usuário quer a resposta mais clara (guias, custos, comparações). Um agente navegando por conta própria prefere experimentos originais e dados sobre comportamento e confiabilidade da IA. Tráfego de leitores e escolhas de agentes não tiveram correlação alguma. Resultados de testes originais (seus próprios dados de citação, experimentos) funcionam bem com ambos.

Padrão de reescrita

<O que eles ganham>: <escopo específico ou número> <para quem, se couber> + descrição: uma frase que responde à pergunta, uma segunda com a recompensa concreta.

  • Antes: "Por que Trabalhamos com Empresas de Hard Tech Industrial" (uma opinião do tipo "por que nós")
  • Depois: "Marketing de Busca com IA para Indústrias e Hard Tech: O Que Funciona" + "Como fabricantes são citados pelo ChatGPT e AI Overviews do Google, com as etapas e resultados de clientes industriais."

Em seguida, aplique suas regras internas. As nossas: apenas números aprovados, sem enquadramento de contraste ("não X, mas sim Y"), sem travessões, título meta ≤60 caracteres para posts (≤70 para páginas), descrição ≤155–160 caracteres. As reescritas devem ser fiéis ao corpo do texto. Não prometa uma checklist que o post não contém.

Checklist por título + descrição

  • Um agente com a pergunta alvo leria isso como a resposta?
  • As primeiras 5 palavras dizem o que o leitor ganha?
  • Sem abertura focada no problema ou em credenciais, sem frase de efeito, sem pergunta retórica
  • Sem ano, "definitivo", "completo" ou "absoluto"
  • É a única URL que queremos que vença esta pergunta, e os irmãos estão direcionados para outros lugares
  • Excerto, descrição OG e meta descrição do plugin de SEO estão alinhados (agentes podem ler qualquer um deles)

Testando variantes (opcional, para páginas pilares)

Reproduza a configuração de Taylor antes de publicar uma grande reescrita:

  1. Escreva de 3 a 5 perguntas reais de compradores (a partir de consultas longas do Search Console ou prompts rastreados de uma ferramenta de visibilidade em IA) e de 1 a 2 personas do ICP do cliente.
  2. Monte uma lista de candidatos: os títulos + descrições variantes misturados com 10 a 20 resultados concorrentes para a mesma pergunta (título + descrição como aparecem na busca), embaralhados por execução.
  3. Pergunte a um modelo Claude (por padrão, o Sonnet mais recente) com as ferramentas web desativadas: "Seu usuário pergunta: . . Qual destes você leria e citaria? Retorne os IDs." Execute de 30 a 50 sessões por variante e conte a participação de citações.
  4. Publique o vencedor e registre a participação antes/depois nas notas do site. Taylor empacotou sua versão como uma skill do Claude Code chamada agent-pass. Consulte seus termos antes de pegar algo emprestado.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas