Communitygithub.com

Revisão de Acessibilidade

Use ao revisar acessibilidade de teclado, foco, nomes acessíveis, estrutura, contraste e comportamento de movimento na interface.

O que é Revisão de Acessibilidade?

Esta skill orienta a revisão de acessibilidade de componentes de UI, com foco em navegação por teclado, foco visível, nomes acessíveis, contraste de cores e comportamento adaptativo (zoom/reflow e movimento reduzido). Ela é particularmente útil para desenvolvedores e engenheiros de qualidade que utilizam navegadores reais como ambiente de teste (por exemplo, via browser automation). A skill exige que as interações de teclado sejam validadas com ações nativas do navegador, não apenas com APIs de script como dispatchEvent. Além disso, orienta o cálculo de contraste levando em conta opacidade e herança de cores, sugerindo análise de pixels em fundos complexos. A ferramenta também classifica problemas como bloqueadores, maiores ou menores, com evidências e reparos, evitando declarações falsas de conformidade WCAG sem uma auditoria completa.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alty-oss/dev-design/tree/HEAD/skills/accessibility-review

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Revisão de Acessibilidade faz?

Português (Brasil)

Revise o fluxo principal implementado e os estados de recuperação relevantes usando o contrato de validação do navegador.

Verifique marcos/headings semânticos, nomes significativos, associações de rótulo/input e erro, visibilidade do foco, ordem/restauração do foco, ativação por teclado e comportamento de escape, contraste, comportamento de zoom/reflow e movimento reduzido.

Calibre a entrada de teclado nativa suportada com alterações observáveis de foco/ativação. Uma API de pressionar tecla nomeada sem alteração de comportamento é insuficiente. Tente uma alternativa nativa documentada quando disponível; marque como não suportado se falhar; dispatchEvent e foco via script não são evidências confiáveis de teclado. Use ações reais do navegador para reivindicações de teclado. Inspecione sobreposições (overlays) e validação. Uma captura de tela sozinha não pode provar a ordem do foco ou o comportamento da tecnologia assistiva.

Para fundos sólidos, calcule o contraste a partir das cores de primeiro plano e fundo computadas reais, incluindo opacidade/herança/composição; use análise de pixels onde fundos complexos assim exigirem. Registre método, cores, proporção e escopo.

Execute automação de acessibilidade existente quando disponível; registre seu escopo e resultado. Não adicione uma dependência de ferramenta apenas para reivindicar cobertura.

Classifique os problemas como bloqueador/maior/menor com evidências e reparo; reteste o comportamento afetado após as correções.

Registre verificações não suportadas como pendentes. Varreduras automatizadas e verificações manuais limitadas não estabelecem conformidade completa com WCAG. Não declare conformidade global sem o escopo de auditoria necessário.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas