NenadZivotic/lite-agent-skills

Auditoria SEO off-line de um arquivo HTML local — qualidade do título e meta descrição, canonical, robots meta, viewport, tags Open Graph, estrutura h1, cobertura de alt em imagens, lang/charset. Zero acesso à rede. Use quando o usuário pedir para verificar o SEO básico de uma página a partir de HTML salvo ou arquivo de template.

O que é lite-agent-skills?

Esta skill realiza uma auditoria SEO on-page básica em um arquivo HTML local fornecido pelo usuário, sem qualquer acesso à rede. Ela executa um script Node.js (scripts/audit.mjs) que analisa elementos cruciais para SEO, como título, meta descrição, canonical, robots meta, viewport, tags Open Graph, estrutura de h1, cobertura de alt em imagens, idioma e codificação de caracteres. O resultado é um relatório JSON com status de pass/warn/fail para cada verificação, permitindo que desenvolvedores corrijam rapidamente problemas comuns de otimização em páginas estáticas ou templates. A skill é útil para quem deseja validar as práticas recomendadas de SEO sem depender de serviços online, sendo compatível com ambientes de desenvolvimento que usam Node.js 18+. Ela não substitui uma auditoria completa que incluiria a verificação de robots.txt ou sitemap.xml, mas oferece uma verificação rápida e confiável para arquivos locais.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/NenadZivotic/lite-agent-skills/tree/HEAD/seo-quick-audit-lite

Documentação

Auditoria SEO Rápida (Lite)

Executa scripts/audit.mjs em um arquivo HTML local fornecido pelo usuário e reporta pass/warn/fail para verificações principais de SEO on-page. Completamente offline — o script lê um único arquivo e emite JSON.

Escopo e regras

Auditar apenas arquivos fornecidos pelo usuário. Esta versão lite NÃO busca URLs, robots.txt ou sitemap.xml — informe isso ao reportar.
Pass/fail baseia-se em convenções comuns, não em garantias de mecanismos de busca.
Nunca modificar o arquivo. Somente leitura.

1. Execução

Requer Node 18+, zero dependências.

node <skill-dir>/scripts/audit.mjs pagina.html

JSON na saída padrão; código de saída 1 quando houver algum warn/fail (integrável a CI), 2 em erro de leitura/uso.

2. Ler o relatório

summary: contagens de pass/warn/fail/info.
checks[]: {id, status, detail} para: title, meta-description, canonical, robots-meta, viewport, open-graph, h1, img-alt, lang, charset.

3. Orientações de correção

title/meta-description warn → reescrever para ~30-65 / 50-160 caracteres.
robots-meta: noindex em uma página que deve ser indexada → remover a diretiva.
canonical ausente → adicionar <link rel="canonical">.
h1 fail → exatamente um h1 descritivo por página.
open-graph warn → adicionar og:title/og:description/og:image para prévias de links.

Lite vs completa

A versão completa seo-quick-audit adicionalmente busca URLs ativas, incluindo status de /robots.txt e /sitemap.xml, verificação de twitter-card e tratamento de redirecionamentos.