Todo mundo consegue usar. Agora dá pra provar.
A skill confere um site do jeito que pessoas com deficiência usam: no teclado, com leitor de tela, com baixa visão, com zoom, sensíveis a movimento. Cada problema vem recortado da página, ligado à WCAG 2.2 e ao eMAG, com quem ele bloqueia e como corrigir.
npx skills add c0le0ni/skills --skill coleoni-a11y
Este site reprovou na própria auditoria. Depois passou.
Rodamos a skill no skills.coleoni.com. O cinza claro dos textos falhava no contraste em toda página, o botão de idioma escondia o próprio rótulo, e não tinha link de pular conteúdo. Um token, um atributo e um link depois: zero.
skills.coleoni.com, antes da auditoria
color-contrast 268 elementos
#707070 sobre #111111 = 3,81:1 (precisa 4,5)
label-content-name 16
"EN" fora do nome do botão
scrollable-region 4
caixas de código fora do alcance do teclado
link de pular conteúdo nenhum em 16 páginas
depois: 0 problemas · 52 regras ok
O motor de regras, depois o teclado, depois uma pessoa.
Regras automáticas acham parte dos problemas. A skill soma as conferências que um motor de regras pula, e depois faz a revisão manual que nenhum script faz.
-
Roda o axe-core
WCAG 2.0, 2.1 e 2.2, níveis A e AA, mais boas práticas, em cada página do sitemap.
-
Anda pelo teclado
Tab por cada página: o foco aparece, cai em coisa escondida, fica preso, tem link de pular conteúdo.
-
Dá zoom e acalma
Refluxo em 320px, o teste de zoom de 400%, e animações que continuam com o movimento reduzido ligado.
-
Recorta cada problema
Cada elemento com falha cortado da página e destacado, pro time ver sem caçar.
-
Liga à WCAG e ao eMAG
Cada problema com o critério da WCAG 2.2 e a recomendação do eMAG 3.1, em português ou inglês.
-
Corrige, se você pedir
Token antes de componente, elemento nativo antes de ARIA, e a auditoria de novo pra mostrar a contagem nova.
Cada problema, e quem ele bloqueia.
Uma amostra do que o relatório encontra, com os critérios que ele cita.
| Problema | Quem bloqueia · WCAG · eMAG |
|---|---|
| Texto com pouco contraste | Baixa visão, sol forte · 1.4.3 · 4.1 |
| Foco que não aparece | Quem usa teclado · 2.4.7 · 4.4 |
| Botão ou link sem nome | Leitor de tela · 4.1.2 · 2.2, 3.5 |
| Imagem sem texto alternativo | Leitor de tela · 1.1.1 · 3.6 |
| Campo sem rótulo | Leitor de tela, controle por voz · 3.3.2 · 6.2 |
| Página que rola pro lado em 320px | Quem usa zoom · 1.4.10 · 4.3 |
| Sem link de pular conteúdo | Quem usa teclado · 2.4.1 · 1.5 |
| Animação que ignora movimento reduzido | Distúrbio vestibular · 2.3.3 · 5.5 |
Um comando, em qualquer agente.
Os pacotes são o axe-core e o playwright-core, que o agente instala no primeiro uso. Ele usa o Chrome ou o Edge que você já tem.
npx skills add c0le0ni/skills --skill coleoni-a11y
/coleoni-a11y https://seusite.com.br --lang pt
-g-a claude-code-a codexnpx skills add c0le0ni/skillsAntes do lançamento, ou antes do cliente pedir.
Ela mostra o relatório primeiro. O código só muda quando você mandar.
Auditar o site no ar.
/coleoni-a11y https://seusite.com.br --lang pt
Relatório em inglês pra um cliente de fora.
/coleoni-a11y https://site.com --lang en
Corrigir o build antes do deploy.
/coleoni-a11y ./dist, corrige o contraste e o foco
O motor, pelo terminal.
O scripts/a11y.mjs também roda sozinho: node a11y.mjs https://seusite.com.br --lang pt --out a11y-report.
| Opção | Para quê |
|---|---|
<url | pasta> | Um site no ar, um servidor local ou uma pasta de build servida numa porta temporária |
--lang en|pt | Língua do relatório; em português usa os nomes do eMAG e o axe traduzido |
--pages 10 | Máximo de páginas auditadas, pelo sitemap ou pelos links |
--domain site.com | Nome no relatório, pra builds locais |
--no-keyboard | Pula a navegação pelo Tab |
Feito pra todo mundo. Conferido pra todo mundo.
npx skills add c0le0ni/skills --skill coleoni-a11y