Ir para o guia de uso
accessibilitypor Addy Osmani

Accessibility Skill.

Uma skill para Claude Code e Codex focada em revisão de design: audita e melhora a acessibilidade web seguindo WCAG 2.2.

  • Design Review & Accessibility
  • Relatório de revisão
addyosmani/web-quality-skills · skills/accessibility/SKILL.mdSKILL.md
--- name: accessibility description: Audit and improve web accessibility following WCAG 2.2 guidelines. Use when asked to "improve accessibility", "a11y audit", "WCAG compliance", "screen reader support", "keyboard navigation", or "make accessible". --- ## Evidence-led audit workflow ## WCAG Principles: POUR ## Conformance levels ## Perceivable ## Operable ## Understandable
Cabeçalho e títulos de seção lidos do arquivo original em 14/09/2026 · 14.265 caracteres no total

01 O que faz

O que o skill de acessibilidade faz no Claude Code e no Codex

Resumo, fluxo de trabalho e resultados, todos lidos do SKILL.md do skill.

Do SKILL.mdLido em 14/09/2026 · não é uma execução registrada

Nos termos do próprio skill

Este skill audita e corrige a acessibilidade web conforme a WCAG 2.2, organizado em torno de POUR — Perceivable, Operable, Understandable, Robust — e dos níveis de conformidade A, AA e AAA. Ele executa um fluxo de trabalho baseado em evidências: quando há uma página renderizada disponível, execute uma auditoria de acessibilidade Lighthouse ao vivo (lighthouse_audit com Chrome DevTools MCP), use os nós com falha para localizar o componente, inspecione a árvore de acessibilidade com take_snapshot e depois corrija o código-fonte e execute tudo de novo.

Se as ferramentas ao vivo não estiverem disponíveis, o Lighthouse CLI ou o axe cobrem a metade automatizada, e as mesmas verificações manuais continuam valendo. Ele traz regras em nível de código para texto alternativo, taxas de contraste, visibilidade do foco, tamanho do alvo, movimento reduzido, erros de formulário e autenticação acessível, além de uma lista de triagem classificada em crítica, séria e moderada.

O que ele produz

  • Uma lista de problemas priorizada, agrupada nos níveis Crítico (corrigir imediatamente), Sério (corrigir antes do lançamento) e Moderado (corrigir em breve), com exemplos nomeados.
  • Marcação corrigida e trechos prontos para colar, incluindo um utilitário visualmente oculto para expor rótulos de botões de ícone às tecnologias assistivas.
  • Implementações de referência completas em references/A11Y-PATTERNS.md, abrangendo rótulos de formulário, aprisionamento de foco em modal, link de salto, abas ARIA, regiões dinâmicas, tratamento de erros e comandos de leitor de tela.
Veja o exemplo de prompt ↗

Como funciona

  1. 01
    Execute uma auditoria de acessibilidade ao vivo

    Comece com uma página renderizada e execute uma auditoria de acessibilidade Lighthouse ao vivo, usando o modo de navegação móvel para páginas públicas em geral ou o modo snapshot quando recarregar faria perder o estado autenticado.

  2. 02
    Localize o componente com falha

    Use os nós com falha da auditoria para apontar o componente ou template específico, em vez de rodar grep no repositório inteiro em busca de padrões genéricos.

  3. 03
    Inspecione a árvore de acessibilidade

    Leia um snapshot renderizado da árvore de acessibilidade para verificar nomes, funções, estados, marcos e estrutura de títulos, e depois percorra o fluxo afetado com o teclado.

  4. 04
    Corrija o código-fonte e verifique novamente

    Altere o código-fonte em vez da saída renderizada, depois repita a mesma auditoria e a mesma interação manual para confirmar a correção.

  5. 05
    Recorra às ferramentas de CLI

    Quando as ferramentas de navegador ao vivo não estiverem disponíveis, combine a saída do Lighthouse CLI ou do axe com as mesmas verificações manuais, porque a automação sozinha cobre apenas parte das barreiras.

02 Encontre o ideal para você

Quando usar a Skill accessibility

Use a skill accessibility no Claude Code ou Codex quando o trabalho for design review deste tipo. Adequação e limites abaixo são do próprio arquivo da skill.

Boa Combinação

  • Um pedido formulado como auditoria de a11y, trabalho de conformidade com a WCAG, suporte a leitor de tela, navegação por teclado ou "tornar acessível".
  • Equipes que buscam o nível AA, que o arquivo trata como alvo padrão e exigência legal em muitas jurisdições.
  • Páginas em que cabeçalhos ou rodapés fixos engolem o anel de foco do teclado, um critério novo na WCAG 2.2.
  • Interfaces que precisam ser totalmente operáveis sem mouse, incluindo widgets personalizados construídos a partir de elementos não interativos.

Conheça os Limites

  • Links de texto em linha, dimensionamentos controlados pelo navegador e alvos cujo círculo de 24px não se sobrepõe a outro alvo estão isentos da regra de tamanho mínimo de alvo.
  • O nível AAA é tratado como opcional, e não como requisito.
  • Antipadrão que o arquivo destaca: adicionar ativação manual por teclado a um botão nativo, o que dispara o evento duas vezes, porque Enter e Space já acionam o clique.

O Que Fornecer

  • Uma página renderizadaO fluxo ao vivo começa quando existe uma página renderizada disponível, já que a auditoria, a lista de nós e a árvore de acessibilidade vêm todas dela.
  • O modo de navegação da páginaDiga ao agente se esta é uma página pública geral ou um fluxo em que recarregar perderia estado autenticado ou criado pelo usuário, pois isso define a navegação móvel ou o modo de snapshot.
  • O fluxo de teclado a exercitarEsteja pronto para percorrer a interação afetada com o teclado durante a auditoria, junto com a inspeção da árvore de acessibilidade.

03 Dentro da skill

Regras que o skill de acessibilidade entrega ao Claude Code e ao Codex

7 instruções concretas, padrões e limites que o SKILL.md define para o agente — a parte do arquivo que muda o resultado.

  1. Prefira um elemento nativo

    Botão nativo, âncora e controles de formulário já cuidam da ativação por Enter/Space, do foco e da semântica para tecnologias assistivas, então o tratamento manual de teclado é o último recurso para elementos que você não pode substituir.

  2. Mantenha o foco com estilo visível

    Nunca remova os contornos.

  3. Respeite o mínimo de 24 × 24 para alvos

    Alvos interativos devem ter no mínimo 24 × 24 pixels CSS em AA, com 44 × 44 recomendado como tamanho de toque confortável para botões, caixas de seleção e rótulos de botões de opção.

  4. Neutralize animações quando solicitado

    Sob prefers-reduced-motion, o arquivo reduz as durações de animação e transição a 0.01ms, limita a contagem de iterações a 1 e redefine scroll-behavior para auto.

  5. Nunca sinalize apenas com cor

    Estados de erro combinam cor com um ícone e texto; a marcação pareia aria-invalid="true" com aria-describedby apontando para o elemento da mensagem de erro.

  6. Anuncie os erros e mova o foco para eles

    Envie os erros para leitores de tela com role="alert" ou aria-live, marque os campos com problema e mova o foco para o primeiro erro no envio.

  7. Mantenha a autenticação com baixa carga cognitiva

    Fluxos de login não podem depender de lembrar uma senha ou resolver um quebra-cabeça, a menos que copiar e colar ou o preenchimento automático funcionem, exista uma alternativa como passkey ou link por e-mail, ou o teste use reconhecimento de objetos ou conteúdo pessoal.

04 Coloque em prática

Instalar accessibility no Claude Code ou Codex

Um comando npx skills add, depois uma primeira tarefa no seu agente e uma checklist para o resultado.

Adicionar accessibility ao Claude Code, Codex ou Seu Agente

Rode no seu projeto; o instalador pergunta a qual agente adicioná-lo.

Terminal
npx skills add https://github.com/addyosmani/web-quality-skills --skill accessibility

Forma genérica da CLI skills para skills/accessibility/SKILL.md; o repositório pode documentar seu próprio caminho.

Dar à Skill uma Primeira Tarefa de Revisão de Design

Escrito nos próprios termos do skill; substitua as partes entre colchetes pelo seu material.

Starter prompt
Audit [page URL or route] with Lighthouse and then fix the accessibility problems in the source. The form inputs in [component path] have no programmatically associated labels, the icon buttons have no accessible names, and focus outlines are being removed on [element]. Re-run the same audit afterwards and check keyboard navigation and target sizes.

Fonte: escrito a partir do SKILL.md nos próprios termos do skill.

Verifique o Primeiro Resultado

O que o próprio SKILL.md diz sobre como é um resultado correto:

  • Percorra a página inteira com Tab e ative os controles com Enter e Espaço.

No OpenDesign, importe accessibility pelo link do SKILL.md: Plugins → Add → Skill → Import from link, depois selecione-o na barra superior.

05 Código aberto, rastreável

Fonte, Licença e Verificação

De onde vêm os fatos desta página e quando foram verificados pela última vez.

Arquivo da skill
skills/accessibility/SKILL.md Checksum do conteúdo registrado na verificação; commit afa8da9
License
MIT De LICENSE; SKILL.md indica "MIT".
Estrelas do repositório
2.786 Snapshot do GitHub tirado em 14/09/2026 para todo o repositório addyosmani/web-quality-skills. Não é uma avaliação ou contagem de uso para accessibility.
Verificado pelo OpenDesign
14/09/2026 Arquivo de origem, caminho, texto da licença e contagem de estrelas foram verificados. Não integrado ao OpenDesign principal (verificado em 28/08/2026); uma execução ao vivo não foi registrada nesta página.
A Descrição da Própria Skill
"Audite e melhore a acessibilidade web seguindo as diretrizes WCAG 2.2. Use quando solicitado "melhorar acessibilidade", "auditoria a11y", "conformidade WCAG", "suporte a leitor de tela", "navegação por teclado" ou "tornar acessível"."

Descrição do front-matter do SKILL.md. O arquivo completo tem cerca de 14.265 caracteres. Leia o arquivo completo no GitHub.

Accessibility

Execute accessibility em uma tarefa real de revisão de design.

Baixe o OpenDesign, importe accessibility a partir do link SKILL.md, cole o prompt acima e leia o plano antes do resultado.

Terminal
npx skills add https://github.com/addyosmani/web-quality-skills --skill accessibility

OpenDesign Desktop

Um design system. Sua marca consistente em tudo

No Vibe Design Workspace completo, aplique as mesmas regras de marca a sites, apresentações, protótipos interativos, dashboards, imagens e vídeos HTML. Conecte Codex, Claude Code, Cursor e outros agentes de código locais e crie de graça.

  • Sites, apresentações, protótipos, dashboards, imagens e vídeo
  • Mais de 140 design systems e a biblioteca completa de templates e skills
  • Codex local e mais de 21 agentes de código · Grátis
Baixar grátis

Disponível para macOS e Windows