aelena/seo-geo-audit

O que seo-geo-audit faz?

Audite um repositório frontend para SEO clássico (as coisas que o rastreador do Google se importa) e GEO — Otimização para Motores Generativos, as coisas que os LLMs se importam ao ler seu conteúdo. Gera um boletim em markdown com severidades, citações arquivo:linha e correções concretas.

O valor inovador está no GEO. Scanners de SEO clássicos existem há anos. Mas a pergunta "seu site é fácil para um modelo de linguagem extrair, citar e raciocinar?" é algo que só o Claude pode realmente responder — porque o Claude é o consumidor.

Invocação

Gatilho	Comportamento
/audit ou /seo-geo ou /seo-geo-audit	Auditoria padrão: SEO + GEO, nível raiz + rotas-chave, ~30 arquivos no máximo
/audit deep	Percorre todas as rotas/páginas descobertas no repositório. Mais lento, mais completo
/audit seo	Apenas SEO clássico
/audit geo	Apenas GEO
/audit fix	Auditoria seguida de propostas de edições concretas para cada achado de alta severidade (pede confirmação antes de cada edição)
/audit report.md	Escreve o relatório em um arquivo em vez de exibi-lo inline
Linguagem natural: "audite este site para SEO", "isto é amigável para LLMs?", "verifique meus dados estruturados"	Mesmo comportamento

Parar / desabilitar

Não é baseado em sessão. Execução única. Basta não invocá-la.

Fluxo de execução

1. Detectar framework lendo package.json. Procure por next, astro, nuxt, svelte-kit, remix, gatsby, vite, vue, ou use HTML puro como fallback. O framework determina os padrões de arquivos e onde as páginas residem (pages/, app/, src/routes/, src/pages/, content/, etc.).
2. Descobrir fontes de conteúdo via scripts/discover.sh <framework>.
3. Extrair o conteúdo <head> e dados estruturados via scripts/extract-head.sh e scripts/find-jsonld.sh. Para JSX/TSX, procure por <Head>, <Helmet>, <Metadata> ou padrões específicos do framework (exportações metadata do Next.js, frontmatter do Astro, useHead do Nuxt).
4. Executar verificações. Cada verificação de checks/seo.md e checks/geo.md é uma peça de raciocínio do Claude sobre os dados extraídos — não uma regex. Essa é a essência: scanners clássicos podem dizer se a meta tag existe; só o Claude pode dizer se a descrição é boa.
5. Pontuar por categoria usando checks/scoring.md. Nota com letra + pontuação numérica por categoria.
6. Renderizar o relatório a partir de templates/report-card.md, preenchendo os achados com citações arquivo:linha, severidades e sugestões de correção.
7. Se modo fix: para cada achado de alta severidade, proponha uma edição concreta usando o padrão de pré-visualização-e-depois-aplicação. Nunca aplique sem confirmação do usuário.

Consciência entre skills

Se a skill llms-txt estiver instalada, recomende executá-la quando os achados GEO incluírem "llms.txt ausente". Se a skill a11y-audit existir, aponte para ela no final de cada relatório ("Esta auditoria cobre SEO e GEO. Para acessibilidade, execute /a11y-audit.").

Salvaguardas de segurança

• Somente leitura por padrão. Apenas o modo fix propõe edições, e cada edição precisa de confirmação.
• Não acesse o site ativo. Audite o repositório fonte. Auditoria de site ativo é território do Lighthouse / PageSpeed — ferramentas diferentes, preocupações diferentes.
• Não presuma convenções de framework. Verifique package.json primeiro. Uma pasta pages/ significa coisas diferentes em Next vs Nuxt vs Gatsby vs vanilla.
• Nunca modifique arquivos de política (robots.txt, meta tags noai, llms.txt) sem solicitação explícita do usuário — essas são decisões das partes interessadas, não técnicas.
• Ignore artefatos gerados/build. Não audite dist/, build/, .next/, out/, .nuxt/. Audite a fonte.
• Limite auditorias profundas. Mesmo no modo deep, recuse escanear mais de ~500 arquivos sem uma confirmação --no-limit.

Arquivos desta skill

• SKILL.md — este arquivo
• checks/seo.md — checklist de SEO clássico com severidades
• checks/geo.md — checklist GEO (as verificações inovadoras)
• checks/scoring.md — como os achados se mapeiam para uma nota de 0 a 100 por categoria
• templates/report-card.md — modelo markdown para o relatório final
• scripts/discover.sh — encontra arquivos fonte frontend por framework
• scripts/extract-head.sh — extrai conteúdo <head> de HTML/JSX/MDX
• scripts/find-jsonld.sh — extrai blocos <script type="application/ld+json">
• scripts/check-llms-txt.sh — verifica se o repositório possui um llms.txt
• examples/good-site-report.md — exemplo de relatório de um site bem otimizado
• examples/bad-site-report.md — exemplo de relatório de um site típico greenfield