Communitygithub.com

ComeOnOliver/skillshub

Audita componentes de UI quanto à conformidade WCAG, atributos ARIA, navegação por teclado e suporte a leitores de tela. Use ao construir componentes frontend ou quando o usuário solicitar melhorias de acessibilidade.

O que é skillshub?

Esta skill, chamada 'Accessibility Auditor', é um assistente especializado que audita aplicações web quanto à conformidade com as diretrizes WCAG 2.1 Nível AA. Ela fornece instruções detalhadas e exemplos práticos para garantir que componentes de interface sejam acessíveis a todos os usuários, incluindo aqueles que utilizam tecnologias assistivas. A skill cobre desde verificações de HTML semântico, uso correto de atributos ARIA, navegação por teclado, textos alternativos para imagens, contraste de cores, até testes automatizados com ferramentas como axe-core, Lighthouse e pa11y. É ideal para desenvolvedores que precisam revisar ou construir componentes frontend (React, HTML, etc.) e desejam incorporar boas práticas de acessibilidade desde o início do desenvolvimento, ou responder a solicitações de melhoria de acessibilidade de usuários.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/crazydubya/accessibility-auditor

Perguntar na sua IA favorita

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

Prévia

Do README da skill

skillshub preview
skillshub preview
skillshub preview

Documentação

Auditor de Acessibilidade

Audita aplicações web quanto à conformidade com requisitos de acessibilidade (WCAG 2.1 Nível AA) e sugere melhorias.

Quando Usar

  • Ao construir ou revisar componentes de UI
  • Quando o usuário solicitar melhorias de acessibilidade
  • Ao se preparar para uma auditoria de acessibilidade
  • Quando o usuário mencionar "acessibilidade", "a11y", "WCAG", "leitor de tela" ou "navegação por teclado"

Instruções

1. Verificação de HTML Semântico

Use elementos HTML adequados:

<!-- Ruim -->
<div onclick="submit()">Enviar</div>

<!-- Bom -->
<button onclick="submit()">Enviar</button>

Estrutura semântica:

  • <header>, <nav>, <main>, <footer>
  • <article>, <section>, <aside>
  • <h1> a <h6> em hierarquia adequada
  • <button> para ações, <a> para navegação

2. Atributos ARIA

Quando usar ARIA:

  • Widgets personalizados (abas, accordions, modais)
  • Atualizações de conteúdo dinâmico
  • Interações complexas
  • Quando o HTML semântico não é suficiente

Atributos ARIA comuns:

<!-- Funções de referência (landmark) -->
<nav role="navigation" aria-label="Principal">

<!-- Funções de widget -->
<div role="button" tabindex="0" aria-pressed="false">

<!-- Regiões ativas -->
<div role="alert" aria-live="assertive">Ocorreu um erro</div>

<!-- Rótulos e descrições -->
<button aria-label="Fechar diálogo">×</button>
<input aria-describedby="ajuda-senha" />

Primeira regra do ARIA: Não use ARIA se o HTML semântico funcionar

3. Navegação por Teclado

Todos os elementos interativos devem ser acessíveis por teclado:

// Adicionar suporte de teclado a elementos personalizados
element.addEventListener('keydown', (e) => {
  if (e.key === 'Enter' || e.key === ' ') {
    executarAcao();
  }
});

Ordem de tabulação:

  • Use tabindex="0" para elementos interativos personalizados
  • Evite tabindex > 0 (cria ordem confusa)
  • Use tabindex="-1" apenas para foco programático

Gerenciamento de foco:

  • Indicadores de foco visíveis
  • Foco preso dentro de modais
  • Retorno de foco ao fechar diálogos
  • Links de salto para o conteúdo principal

4. Texto Alternativo e Imagens

Imagens informativas:

<img src="grafico.png" alt="As vendas aumentaram 25% no 3º trimestre" />

Imagens decorativas:

<img src="decoracao.png" alt="" />
<!-- ou -->
<img src="decoracao.png" role="presentation" />

Imagens complexas:

<figure>
  <img src="grafico-complexo.png" alt="Gráfico de vendas trimestrais" />
  <figcaption>
    Descrição detalhada dos dados do gráfico...
  </figcaption>
</figure>

5. Cor e Contraste

Taxas de contraste (WCAG AA):

  • Texto normal: mínimo 4,5:1
  • Texto grande (18pt+): mínimo 3:1
  • Componentes de UI: mínimo 3:1

Não dependa apenas de cor:

<!-- Ruim: Apenas cor -->
<span style="color: red;">Erro</span>

<!-- Bom: Ícone + cor -->
<span style="color: red;">
  <svg aria-hidden="true"><!-- ícone de erro --></svg>
  <span class="sr-only">Erro: </span>
  Entrada inválida
</span>

6. Formulários e Rótulos

Cada entrada precisa de um rótulo:

<!-- Rótulo explícito -->
<label for="email">Email</label>
<input id="email" type="email" />

<!-- Rótulo implícito -->
<label>
  Email
  <input type="email" />
</label>

<!-- aria-label para botões de ícone -->
<button aria-label="Pesquisar">
  <svg><!-- ícone de pesquisa --></svg>
</button>

Mensagens de erro:

<input
  id="senha"
  aria-invalid="true"
  aria-describedby="erro-senha"
/>
<div id="erro-senha" role="alert">
  A senha deve ter pelo menos 8 caracteres
</div>

7. Títulos e Estrutura do Documento

Hierarquia adequada de títulos:

<h1>Título da Página</h1>
  <h2>Seção 1</h2>
    <h3>Subseção 1.1</h3>
    <h3>Subseção 1.2</h3>
  <h2>Seção 2</h2>

Não pule níveis: h1 → h2 → h3 (não h1 → h3)

8. Conteúdo Dinâmico

Anuncie atualizações aos leitores de tela:

<!-- Polido: aguardar pausa do usuário -->
<div role="status" aria-live="polite">
  5 novas mensagens
</div>

<!-- Assertivo: interromper imediatamente -->
<div role="alert" aria-live="assertive">
  Sua sessão expirará em 1 minuto
</div>

Estados de carregamento:

<button aria-busy="true" aria-label="Carregando...">
  <span aria-hidden="true">Carregando</span>
</button>

9. Teste com Leitor de Tela

Texto somente para leitor de tela:

.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border-width: 0;
}

Ocultar elementos decorativos:

<svg aria-hidden="true"><!-- ícone --></svg>

10. Problemas Comuns a Verificar

Ausentes:

  • Texto alternativo em imagens
  • Rótulos em campos de formulário
  • Hierarquia adequada de títulos
  • Indicadores de foco por teclado
  • Rótulos ARIA em botões de ícone

Inadequados:

  • Texto com baixo contraste
  • Marcação não semântica (divs como botões)
  • Gerenciamento de foco ausente em modais
  • Armadilhas de teclado
  • Mídia com reprodução automática

Testes:

  • Navegação apenas por teclado
  • Leitor de tela (NVDA, JAWS, VoiceOver)
  • Simulação de daltonismo
  • Zoom para 200%
  • Ferramentas automatizadas (axe, Lighthouse)

11. Testes Automatizados

Ferramentas:

# Lighthouse
npx lighthouse https://example.com --only-categories=accessibility

# axe-core
npm install --save-dev @axe-core/cli
npx axe https://example.com

# pa11y
npm install --save-dev pa11y
npx pa11y https://example.com

Em testes:

import { axe } from 'jest-axe';

test('não deve ter violações de acessibilidade', async () => {
  const { container } = render(<MeuComponente />);
  const results = await axe(container);
  expect(results).toHaveNoViolations();
});

12. Checklist WCAG 2.1 Nível AA

Perceptível:

  • Alternativas textuais para conteúdo não textual
  • Legendas para áudio/vídeo
  • Conteúdo adaptável (marcação semântica)
  • Contraste de cores suficiente

Operável:

  • Acessível por teclado
  • Sem armadilhas de teclado
  • Limites de tempo adequados (ajustáveis)
  • Sem flashes que induzam convulsões
  • Links de salto para navegação
  • Títulos de página descritivos
  • Ordem de foco faz sentido
  • Propósito do link claro pelo contexto

Compreensível:

  • Idioma da página especificado (<html lang="pt">)
  • Navegação previsível
  • Assistência de entrada (rótulos, instruções, mensagens de erro)

Robusto:

  • HTML válido
  • Nome, função, valor para widgets personalizados
  • Compatível com tecnologias assistivas

Melhores Práticas

  • Incorpore acessibilidade desde o início
  • Teste com tecnologias assistivas reais
  • Use HTML semântico primeiro, ARIA depois
  • Mantenha estrutura documental lógica
  • Forneça múltiplas formas de acessar conteúdo
  • Teste a navegação por teclado minuciosamente
  • Não desabilite o zoom
  • Use marcos de referência e títulos

Arquivos de Apoio

  • reference/wcag-checklist.md: Checklist completo WCAG 2.1 AA
  • reference/aria-patterns.md: Padrões comuns de widgets ARIA

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Habilidades Relacionadas