Skip to content

Instantly share code, notes, and snippets.

@suissa
Created June 28, 2026 03:00
Show Gist options
  • Select an option

  • Save suissa/3c1062812e6238d2f75b60932fa08e49 to your computer and use it in GitHub Desktop.

Select an option

Save suissa/3c1062812e6238d2f75b60932fa08e49 to your computer and use it in GitHub Desktop.
ChatGPT Findability Refactor - Transformar um site comum em um site mais fácil de ser encontrado, lido, entendido, citado e usado por ChatGPT, mecanismos de busca com IA, agentes web e crawlers semânticos.

SKILL.md — ChatGPT Findability Refactor

Nome

ChatGPT Findability Refactor

Objetivo

Transformar um site comum em um site mais fácil de ser encontrado, lido, entendido, citado e usado por ChatGPT, mecanismos de busca com IA, agentes web e crawlers semânticos.

A skill não promete “rankear no ChatGPT”. Ela melhora a probabilidade de o site ser:

  1. descoberto;
  2. rastreado;
  3. compreendido;
  4. usado como fonte factual;
  5. citado quando sustenta uma afirmação específica;
  6. acessível para agentes que precisam navegar, comparar, preencher formulários ou extrair dados.

Princípio central

Um site achável por IA precisa ser:

  • crawlable;
  • legível sem JavaScript obrigatório;
  • semanticamente explícito;
  • factual;
  • verificável;
  • atualizado;
  • bem estruturado;
  • fácil de citar;
  • acessível por humanos e agentes.

A regra prática é:

Se o fato importante não aparece em HTML textual limpo, com URL própria, título claro, data, contexto e relação semântica, trate como se a IA provavelmente não fosse enxergá-lo de forma confiável.

Quando usar esta skill

Use esta skill quando o usuário pedir para:

  • melhorar um site para aparecer no ChatGPT;
  • otimizar um site para AI Search, GEO, AEO ou LLM discovery;
  • tornar um site mais citável;
  • preparar landing pages para agentes;
  • transformar um site comum em site agent-readable;
  • melhorar páginas de preço, produto, serviço, documentação ou empresa;
  • criar robots.txt, sitemap.xml, llms.txt, schema.org ou páginas canônicas;
  • auditar se um site é fácil de ser lido por ChatGPT.

Entradas esperadas

Solicite ou use, se já estiverem disponíveis:

  • URL do site;
  • objetivo principal do site;
  • público-alvo;
  • principais produtos, serviços ou conceitos;
  • cidade/região, se for negócio local;
  • páginas críticas: home, pricing, produto, serviços, docs, blog, sobre, contato;
  • claims que o usuário quer que a IA entenda;
  • concorrentes diretos;
  • termos pelos quais o site deveria ser encontrado;
  • se o site é estático, SSR, SPA, WordPress, Next.js, Nuxt, Astro, Laravel, etc.

Resultado esperado

A skill deve entregar:

  1. Diagnóstico de achabilidade por IA;
  2. Mapa de claims;
  3. Correções técnicas;
  4. Estrutura de páginas recomendada;
  5. Arquivos auxiliares;
  6. Schema JSON-LD;
  7. Checklist de publicação;
  8. Testes de validação;
  9. Relatório final em Markdown.

Definições operacionais

Fetched

A página foi encontrada e lida pelo mecanismo, mas não necessariamente apareceu para o usuário.

Cited

A página foi usada como fonte clicável para sustentar uma frase específica.

Mentioned

A marca, produto ou site foi mencionado na resposta, mas sem necessariamente ser usado como fonte.

Claim

Uma afirmação objetiva que a página quer sustentar.

Exemplos:

  • “O produto custa R$ 99 por mês.”
  • “A empresa atende Itararé-SP.”
  • “O sistema usa passkey passwordless.”
  • “A pizzaria entrega no bairro X.”
  • “A API possui endpoint REST para pedidos.”

Claim page

Página forte, canônica e textual criada para sustentar um claim ou grupo pequeno de claims.

Postura crítica obrigatória

Antes de sugerir otimizações, identifique:

Suposições do usuário

  • O usuário pode estar assumindo que basta criar llms.txt.
  • Pode estar assumindo que ChatGPT funciona como Google clássico.
  • Pode estar assumindo que aparecer em IA depende apenas de SEO on-page.
  • Pode estar assumindo que a própria página será citada em comparações opinativas.
  • Pode estar ignorando a importância de fontes externas.

Desculpas comuns

  • “Meu site é bonito, então a IA vai entender.”
  • “O preço aparece no card renderizado, então está bom.”
  • “Está em PDF, então está documentado.”
  • “Está no vídeo, então a IA vai saber.”
  • “O conteúdo carrega depois via API, mas o usuário vê.”
  • “Depois eu faço schema.”

Zonas de estagnação

  • Site SPA sem SSR ou HTML inicial útil;
  • Dados importantes em imagem;
  • Preço escondido em toggle JavaScript;
  • Conteúdo institucional genérico;
  • Páginas sem data de atualização;
  • Falta de páginas canônicas por produto, serviço ou localidade;
  • Falta de menções externas reais;
  • Blog sem claims objetivos;
  • Documentação feita só para humanos, não para agentes.

Workflow

Etapa 1 — Auditoria de rastreabilidade

Verifique:

  • robots.txt;
  • sitemap.xml;
  • status HTTP das páginas principais;
  • canonical tags;
  • redirects;
  • páginas bloqueadas;
  • uso excessivo de JavaScript;
  • renderização sem JS;
  • conteúdo em imagem;
  • conteúdo em PDF;
  • páginas órfãs;
  • dados estruturados;
  • tempo de carregamento;
  • HTML inicial;
  • headings;
  • links internos.

Critérios mínimos:

  • páginas críticas devem responder 200;
  • conteúdo principal deve aparecer no HTML inicial ou SSR;
  • cada página importante deve ter URL própria;
  • links internos devem ser rastreáveis por <a href="">;
  • não depender apenas de botões JS para navegação;
  • não esconder preço, endereço, telefone, specs ou políticas em imagem.

Etapa 2 — Configurar acesso de crawlers

Criar ou revisar robots.txt.

Modelo recomendado:

User-agent: OAI-SearchBot
Allow: /

User-agent: ChatGPT-User
Allow: /

User-agent: GPTBot
Allow: /

User-agent: *
Allow: /

Sitemap: https://example.com/sitemap.xml
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment