accessibility-compliance

Visão Geral

O que é accessibility-compliance?

accessibility-compliance é uma skill prática para desenvolvedores frontend que precisam implementar, auditar ou manter interfaces acessíveis. Ela foca nas diretrizes WCAG 2.2, padrões ARIA, navegação por teclado, suporte a leitores de tela e acessibilidade móvel. Essa skill ajuda a garantir que seus projetos web ou React sejam utilizáveis por todos, incluindo pessoas com deficiência.

Quem deve usar esta skill?

• Engenheiros frontend que constroem ou refatoram componentes de UI
• Equipes que buscam conformidade com WCAG 2.2 Nível AA ou AAA
• Desenvolvedores que adicionam papéis, estados e propriedades ARIA
• Qualquer pessoa responsável por auditorias de acessibilidade ou design inclusivo

Problemas resolvidos

• Garante que as interfaces sejam perceptíveis, operáveis, compreensíveis e robustas
• Fornece padrões ARIA práticos e técnicas de acessibilidade móvel
• Ajuda a construir para usuários de teclado, leitores de tela e toque
• Suporta conformidade com normas legais e organizacionais de acessibilidade

Como Usar

Passos para Instalação

1. Adicione a skill ao seu agente ou projeto com:

   npx skills add https://github.com/wshobson/agents --skill accessibility-compliance
   

2. Comece pelo arquivo SKILL.md para uma visão geral das funcionalidades e fluxo do accessibility-compliance.

3. Revise os arquivos de suporte para detalhes de implementação:

   • references/aria-patterns.md: papéis, estados e propriedades ARIA com exemplos em React
   • references/mobile-accessibility.md: dimensionamento e espaçamento de alvos de toque móvel e suporte a leitores de tela
   • references/wcag-guidelines.md: princípios WCAG 2.2, níveis de conformidade e exemplos de código

Adaptando ao Seu Projeto

• Use os padrões fornecidos como referência, não como solução pronta. Adapte ARIA, navegação por teclado e técnicas de acessibilidade móvel ao seu código e framework de UI.
• Integre verificações de acessibilidade no seu fluxo de desenvolvimento, especialmente ao criar componentes ou formulários personalizados.
• Teste com tecnologias assistivas reais (ex.: VoiceOver, TalkBack, NVDA) e navegação por teclado.

Quando Usar accessibility-compliance

• Para auditar ou corrigir problemas de acessibilidade
• Ao construir novos componentes de UI com design inclusivo
• Para garantir paridade de acessibilidade entre mobile e desktop
• Para atender a requisitos organizacionais ou legais de acessibilidade

Perguntas Frequentes

O que o accessibility-compliance cobre?

Esta skill aborda diretrizes WCAG 2.2, padrões ARIA, navegação por teclado, gerenciamento de foco, formulários acessíveis, alvos de toque móvel e suporte a leitores de tela. Oferece exemplos de código e boas práticas para projetos React e web.

Por onde devo começar?

Comece pelo SKILL.md para uma visão geral, depois explore a pasta references/ para padrões detalhados e exemplos de código. Os arquivos references/aria-patterns.md e references/mobile-accessibility.md são especialmente úteis para implementação prática.

Esta skill é só para React?

Embora muitos exemplos usem React, os princípios e padrões se aplicam a qualquer framework frontend ou projetos em HTML/JS puro.

Esta skill garante conformidade com WCAG?

Não. accessibility-compliance oferece orientações e padrões, mas você deve adaptá-los e testá-los no seu contexto. Sempre valide com usuários reais e tecnologias assistivas.

Onde encontro mais recursos?

Confira a pasta references/ para guias selecionados e exemplos de código. Para a lista completa de arquivos, abra a aba Files no Agent Skills Finder.