O que website-audit faz?
Um comando mede o site; você então confirma o que um script não pode julgar e entrega um relatório que um fundador pode usar. A auditoria é somente leitura: nunca submete um formulário, nunca faz login, nunca clica em nada que altere o estado, respeita robots.txt e pausa entre carregamentos de página.
Entradas
- URL (obrigatório). Peça se o usuário não forneceu uma.
- Limite de páginas (opcional, padrão 10). Use 3–5 para uma olhada rápida, 15–25 para uma linha de base completa pré-reconstrução.
- Idioma do relatório (opcional, padrão = o idioma em que o usuário escreve).
Requisitos
- Node.js 22 ou mais recente (
node --version). Lighthouse adicionalmente precisa de Node ≥ 22.19 e npm (npx). - Google Chrome ou Chromium. Detectado automaticamente no macOS, Linux e Windows, incluindo um Chromium já baixado por
npx playwright install chromium. Caso contrário, definaCHROME_BIN=/caminho/para/chrome. - Acesso de rede ao site auditado, além de um CDN npm público (axe-core) e o registro npm (Lighthouse). Se alguma ferramenta não puder ser obtida, essa área é marcada como ignorada no relatório com o motivo; a execução não falha.
Etapas
1. Executar a auditoria
<diretório-do-skill> é a pasta onde este SKILL.md reside.
node <diretório-do-skill>/scripts/audit.mjs https://exemplo.com --limite 10
Opções: --limite N · --atraso MS (pausa entre páginas, padrão 1000) · --max-links N (verificações de links internos, padrão 150) · --sem-lighthouse · --sem-axe · --max-minutos N (padrão 15) · --saida DIR.
A saída vai para ./website-audit/<domínio>/ relativo à pasta atual (substitua com --saida ou a variável de ambiente WEBSITE_AUDIT_OUT):
website-audit-<domínio>-<data>.md: o relatóriowebsite-audit-<domínio>-<data>.json: medições brutas, descobertas, pontuações, instantâneotelas/: capturas de tela da primeira tela por página, desktop e 390 px
O progresso vai para stderr; a última linha do stdout é um resumo JSON (ok, relatorio, paginas, segundos, geral, contagens, pontuacoes, ignorado). Código de saída 2 significa que a auditoria não pôde ser executada (sem Node 22, sem Chrome, site inacessível): mostre a mensagem ao usuário, ela diz o que instalar ou verificar.
Uma execução de 10 páginas leva cerca de 2–4 minutos; o Lighthouse adiciona 30–60 segundos.
2. Revisão manual
Siga <diretório-do-skill>/references/manual-review.md:
- Confirme cada P0 com sua evidência (o script é literal; proteção contra bots ou um formulário JavaScript podem falsificar um P0).
- Resolva cada item «verificar manualmente» lendo as capturas de tela em
telas/. - Certifique-se de que «Corrigir primeiro» seja lido como o primeiro sprint da reconstrução.
Edite o relatório markdown no local. Não altere o JSON; ele é a linha de base bruta.
3. Idioma
O script escreve em inglês. Se o usuário escrever em outro idioma, traduza os cabeçalhos do relatório, as linhas «Por que isso importa para leads» e «Correção». Mantenha URLs, seletores, nomes de métricas, códigos HTTP e rótulos P0 a P3 como estão.
4. Entrega
Responda com: pontuação geral, contagens P0 / P1, a lista «Corrigir primeiro», quais áreas foram ignoradas e por quê, e o caminho para o relatório. Ofereça-se para reexecutar no novo site mais tarde com o mesmo limite para preencher a coluna «depois» do instantâneo.
Se o usuário quiser re-renderizar após editar limites:
node <diretório-do-skill>/scripts/report.mjs <caminho-para-execucao>.json reescreve o markdown a partir do JSON.
O que cada área cobre
Detalhes, limites e regras de prioridade estão em <diretório-do-skill>/references/checks.md. Resumidamente:
| Área | Como |
|---|---|
| Layout móvel | cada página a 360 / 390 / 768 px: rolagem lateral, elementos além da borda, viewport meta, alvos de toque, texto pequeno |
| Bugs | erros e exceções de console, requisições 4xx/5xx e falhas, conteúdo misto, imagens quebradas, links internos (HEAD/GET), alvos de formulário (apenas HEAD) |
| Acessibilidade | axe-core injetado em cada página, tags WCAG 2.0/2.1 A + AA |
| Desempenho | Lighthouse móvel na página inicial; temporização do navegador (TTFB, LCP, CLS, peso, requisições) em cada página |
| Caminho de conversão | CTA na primeira tela em desktop e celular, cliques até contato, e-mail / telefone / agendamento / formulário de lead, depoimentos, casos, logos, números |
| Fundamentos de SEO | título, descrição, um H1, canônico, Open Graph, noindex, robots.txt, sitemap.xml |
Regras
- Nunca submeter, preencher ou clicar em formulários; nunca fazer login; nunca contornar proteção contra bots ou um CAPTCHA. Se o site exibir uma página de desafio, relate isso e pare.
- Respeitar regras de desautorização do robots.txt; manter o atraso padrão a menos que o usuário seja dono do site e peça uma execução mais rápida.
- Descobertas marcadas como «verificar manualmente» são hipóteses até você olhar a captura de tela.
- Não publique o relatório em lugar nenhum por conta própria; ele pode descrever pontos fracos de um cliente.
Não é este skill
- Crítica de cópia, posicionamento e mensagens →
website-copy-reframe. - Uma marca / sistema de design a partir de um site →
design-system-generator. - Rankings de palavras-chave, backlinks, estimativas de tráfego → uma ferramenta de dados SEO.