O que a11y-audit-skill faz?
Auditoria de acessibilidade reutilizável e independente de stack (WCAG 2.2 AA) — axe-core + HTML_CodeSniffer + Lighthouse, com confirmação entre mecanismos. Skill para Claude Code + CLI independente.
Visão Geral
Esta skill executa uma auditoria de acessibilidade em um site ou aplicação web, combinando os resultados de três mecanismos diferentes:
- axe-core: Mecanismo de teste de acessibilidade líder do setor, desenvolvido pela Deque Labs.
- HTML_CodeSniffer: Um mecanismo de auditoria de acessibilidade HTML que verifica conformidade com WCAG.
- Lighthouse: Ferramenta automatizada do Google para melhorar a qualidade de páginas web, incluindo auditoria de acessibilidade.
A confirmação entre mecanismos reduz falsos positivos ao exigir que um problema seja detectado por pelo menos dois mecanismos para ser reportado.
Uso
Como Skill do Claude Code
Skill ativada por ferramenta (/a11y-audit). Veja a11y-audit.sh.
Como CLI Independente
./a11y-audit.sh <url>
Saída
A auditoria produz um relatório consolidado no formato JSON com a seguinte estrutura:
[
{
"severity": "critical",
"description": "Itens de contraste de cores falham na proporção de contraste necessária",
"engine": [
"axe-core",
"lighthouse"
],
"source": "color-contrast"
},
{
"severity": "serious",
"description": "Imagens devem ter texto alternativo”,
"engine": [
"axe-core",
"html_codesniffer",
"lighthouse"
]
}
]
Campos de Saída
| Campo | Descrição |
|---|---|
severity | Nível de severidade (critical, serious, moderate, minor) |
description | Descrição legível por humanos do problema de acessibilidade |
engine | Array de mecanismos que detectaram o problema |
source | Identificador único para o tipo de problema |
Problemas Detectados
A skill pode detectar problemas comuns de acessibilidade, tais como:
- Contraste de cor insuficiente
- Imagens sem texto alternativo
- Campos de formulário sem rótulos
- Estrutura de cabeçalhos inadequada
- Conteúdo não textual sem alternativas
- Documentos sem idioma definido
- Links sem texto discernível
Dependências
- Node.js (para executar Lighthouse e ferramentas baseadas em Node)
- Python 3 (para executar HTML_CodeSniffer wrapper)
- Navegador Chromium-based (para Lighthouse)
Licença
MIT
Autores
- bezzamedia
Suporte
Para problemas ou sugestões, abra uma issue no repositório GitHub.