Ir para o guia de uso
wcag-audit-patternspor Seth Hobson

WCAG Audit Patterns Skill.

Uma skill Claude Code e Codex para revisão de design: auditorias WCAG 2.2 com testes automatizados, verificações manuais e orientação de correção.

  • Design Review & Accessibility
  • Relatório de revisão
wshobson/agents · plugins/accessibility-compliance/skills/wcag-audit-patterns/SKILL.mdSKILL.md
--- name: wcag-audit-patterns description: Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns. --- ## When to Use This Skill ## Core Concepts ## Detailed patterns and worked examples ## Best Practices
Metadados e títulos de seção lidos do arquivo upstream em 14/09/2026 · 2.439 caracteres no total

01 O que faz

O que a skill wcag-audit-patterns 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

Esta skill realiza auditorias de acessibilidade WCAG 2.2 combinando testes automatizados, verificação manual e orientação de correção. Ela categoriza violações por impacto (Crítico/Bloqueadores, Grave, Moderado), abrange três níveis de conformidade (A para o mínimo legal, AA para a maioria das regulamentações, AAA para necessidades específicas) e aplica os princípios POUR (Perceptível, Operável, Compreensível, Robusto).

A skill aborda violações comuns, incluindo texto alternativo ausente, problemas de acesso via teclado, contraste de cor insuficiente e hierarquia de títulos inadequada. Ela enfatiza HTML semântico, testes com usuários reais com deficiência e a construção de bibliotecas de componentes acessíveis, reconhecendo que apenas 30-50% dos problemas são detectáveis por automação.

O que ele produz

  • Estratégias práticas de correção para as violações identificadas
  • Documentação de biblioteca de componentes acessível
Veja o exemplo de prompt ↗

Como funciona

  1. 01
    Categorizar Violações por Impacto

    Os problemas são classificados como Críticos (bloqueadores como texto alternativo ausente e falta de acesso via teclado), Graves (contraste insuficiente, links de pular conteúdo ausentes) ou Moderados (atributo de idioma ausente, texto de link pouco claro).

  2. 02
    Aplicar os Princípios POUR

    Auditar com base em quatro princípios: Perceptível (os usuários conseguem perceber o conteúdo), Operável (os usuários conseguem operar a interface), Compreensível (os usuários conseguem entender o conteúdo) e Robusto (funciona com tecnologia assistiva).

  3. 03
    Combinar Testes Automatizados e Manuais

    Ferramentas automatizadas detectam 30-50% dos problemas, mas o teste manual é necessário para uma cobertura completa.

  4. 04
    Consultar Documentação Detalhada de Padrões

    Quando os conceitos principais não são suficientes, a skill direciona para references/details.md para exemplos resolvidos e orientação detalhada sobre padrões.

02 Encontre o ideal para você

Quando Usar a Skill wcag-audit-patterns

Use a skill wcag-audit-patterns no Claude Code ou Codex quando o trabalho for revisão de design desse tipo. Adequação e limites abaixo são retirados do próprio arquivo da skill.

Boa Combinação

  • Realizar auditorias de acessibilidade de conteúdo web
  • Corrigir violações WCAG em interfaces existentes
  • Atender requisitos regulatórios da ADA ou da Seção 508
  • Preparando-se para processos judiciais de acessibilidade
  • Obter documentação de conformidade VPAT

    03 Dentro da skill

    Regras que a Skill wcag-audit-patterns Passa ao Claude Code e ao Codex

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

    1. Iniciar a Acessibilidade na Fase de Design

      A acessibilidade deve ser incorporada desde o início da fase de design, em vez de adicionada posteriormente como retrofit.

    2. Usar HTML Semântico Primeiro

      Elementos HTML nativos devem ser a escolha padrão, pois reduzem a necessidade de ARIA e oferecem melhor suporte de acessibilidade.

    3. Nunca Confiar Apenas em Testes Automatizados

      O teste manual é necessário porque ferramentas automatizadas conseguem detectar apenas 30-50% dos problemas de acessibilidade.

    4. HTML Nativo Antes de ARIA

      ARIA não deve ser usada como primeira solução; prefira elementos HTML nativos sempre que possível.

    5. Preservar os Contornos de Foco

      Os contornos de foco não devem ser ocultados, pois usuários de teclado dependem deles para navegação.

    6. Nunca Desativar o Zoom

      Os usuários devem conseguir redimensionar o conteúdo, portanto a funcionalidade de zoom não pode ser desativada.

    7. Múltiplos Indicadores Além da Cor

      A cor isolada não pode ser usada para transmitir informação; são necessários múltiplos indicadores.

    8. Testar com Usuários com Deficiência

      Usuários reais com deficiência oferecem o melhor feedback e devem ser incluídos nos testes.

    04 Coloque em prática

    Instale wcag-audit-patterns no Claude Code ou Codex

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

    Adicione wcag-audit-patterns 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/wshobson/agents --skill wcag-audit-patterns

    Formulário genérico da CLI skills para plugins/accessibility-compliance/skills/wcag-audit-patterns/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 [website URL or component name] against WCAG 2.2 AA standards. Identify all Critical and Serious violations including missing alt text, keyboard access issues, and color contrast failures. For each violation, provide the specific WCAG success criterion, the impact on users with disabilities, and concrete remediation code. Prioritize issues that would block screen reader users.

    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:

    • Verifique a compatibilidade com tecnologia assistiva para uma implementação robusta

    No OpenDesign importe wcag-audit-patterns a partir do 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.

    Repository
    github.com/wshobson/agents Branch main
    Arquivo da skill
    plugins/accessibility-compliance/skills/wcag-audit-patterns/SKILL.md Checksum de conteúdo registrado na verificação; commit 4236bb9
    License
    MIT Do LICENSE.
    Estrelas do repositório
    39.635 Snapshot do GitHub tirado em 14/09/2026 para todo o repositório wshobson/agents, que contém 18 skills neste catálogo. Não é uma classificação ou contagem de uso para wcag-audit-patterns.
    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.

    Dentro do SKILL.md

    1. Quando Usar Este SkillLista seis cenários, incluindo auditorias, correção de violações e atendimento a exigências regulatórias
    2. Conceitos FundamentaisDefine três níveis de conformidade, os princípios POUR e violações comuns por impacto
    3. Níveis de Conformidade WCAGO Nível A é a base legal, o AA é o padrão para regulamentações e o AAA é para necessidades especializadas
    4. Princípios POURQuatro princípios: Perceptível, Operável, Compreensível e Robusto, com perguntas orientadoras
    5. Violações Comuns por ImpactoCategoriza problemas como Bloqueadores Críticos, Graves ou Moderados, com exemplos específicos
    6. Padrões detalhados e exemplos práticosAponta para references/details.md para documentação detalhada de padrões
    7. Boas PráticasLista cinco recomendações e cinco proibições para o desenvolvimento acessível
    A Descrição da Própria Skill
    "Realize auditorias de acessibilidade WCAG 2.2 com testes automatizados, verificação manual e orientação para correção. Use ao auditar sites para acessibilidade, corrigir violações WCAG ou implementar padrões de design acessível."

    Descrição do cabeçalho de SKILL.md. O arquivo completo tem cerca de 2.439 caracteres. Leia o arquivo completo no GitHub.

    06 Antes de instalar

    Perguntas Sobre o Skill wcag-audit-patterns

    As respostas vêm do SKILL.md conforme lido em 2026-09-14, e não de uma execução registrada.

    Qual nível de conformidade WCAG devo buscar?

    O Nível AA é o nível de conformidade padrão exigido pela maioria das regulamentações. O Nível A é a base legal mínima, enquanto o Nível AAA só é necessário para necessidades especializadas. A maioria das exigências da ADA e da Seção 508 é atendida com conformidade AA.

    WCAG Audit Patterns

    Execute wcag-audit-patterns em uma tarefa real de revisão de design.

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

    Terminal
    npx skills add https://github.com/wshobson/agents --skill wcag-audit-patterns

    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