accessibility
Skill6 starsChanged 2 days agoMITView on GitHub
Auditar e melhorar acessibilidade web seguindo WCAG 2.2 — auditoria com evidência (Lighthouse/axe + teclado + leitor de tela) e padrões para Next.js/Tailwind. Use ao \"melhorar acessibilidade\", fazer \"a11y audit\", garantir \"WCAG compliance\", suporte a screen reader, navegação por teclado ou \"tornar acessível\".
136 other projects use a version of this.
Adopted by
Most recently taken up by
- gaznil/seo-skills-by-gazniltheir own version, first seen Nov 16, 2026
- gaznilmuzammil12-prog/seo-skills-by-gazniltheir own version, first seen Nov 16, 2026
- stu1612/basketball-sitetheir own version, first seen Nov 16, 2026
- Ivan-propio/claude-skillstheir own version, first seen Nov 16, 2026
- keny4nn/claude-skillstheir own version, first seen Nov 16, 2026
- AndresArreguy/ecc-pi-porttheir own version, first seen Nov 16, 2026
Used with
Projects with it also use author-contributions, tool-rename-deprecation and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
MicrosoftSkillauthor-contributions
Identify all files a specific author contributed to on a branch vs its upstream, tracing code through renames. Use when asked who edited what, what code an author contributed, or to audit authorship before a merge. This skill should be run as a subagent — it performs many git operations and returns a concise table.
Also in 7 projects that use this
gitpod-ioSkilltool-rename-deprecation
Ensure renamed built-in tool references preserve backward compatibility. Use when renaming a toolReferenceName, tool set referenceName, or any tool identifier. Run on ANY change to tool registration code. Covers legacyToolReferenceFullNames for tools and legacyFullNames for tool sets.
Also in 5 projects that use this
DepressionCenterSkillproject-preferences
Apply repository-specific preferences when planning, implementing, or reviewing changes in this project.
Also in 6 projects that use this
MicrosoftSkillchat-perf
Run chat perf benchmarks and memory leak checks against the local dev build or any published VS Code version. Use when investigating chat rendering regressions, validating perf-sensitive changes to chat UI, or checking for memory leaks in the chat response pipeline.
Also in 5 projects that use this
DepressionCenterSkillcreate-media-pack
Create a coordinated project branding and media pack with three accessible design options, approved vector artwork, image exports, a branding guide, and README integration. Use when asked for a repository media pack, brand kit, or complete project visual identity.
Also in 5 projects that use this
- +7 more from microsoft
Other versions136 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 136
- microsoft/vscode★ 195ksame name
- elastic/kibana★ 21ksame name
- mozilla-mobile/firefox-ios★ 13ksame name
- midudev/preguntas-entrevista-react★ 7.8ksame name
- gitpod-io/openvscode-server★ 6.2ksame name
- posit-dev/positron★ 4.3ksame name
- legions-developer/evilcharts★ 3.2ksame name
- midudev/la-velada-web-oficial★ 1.9ksame name
- UI5/webcomponents★ 1.8ksame name
- theopenco/llmgateway★ 1.7ksame name
126 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository134 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- ai-ml-data-scienceSkill
- ai-ml-timeseriesSkill
- brand-platformSkill
- brand-researchSkill
- brand-rolloutSkill
- brand-trackingSkill
- brand-verbal-identitySkill
- brand-visual-systemSkill
- copy-humanizeSkill
- core-web-vitalsSkill
- data-analytics-engineeringSkill
- data-lake-platformSkill
- data-sql-optimizationSkill
- data-supabase-patternsSkill
- deep-researchSkill
- dev-api-designSkill
- dev-database-patternsSkill
- dev-debuggingSkill
- dev-defuddleSkill
- dev-error-handlingSkill
- dev-git-workflowSkill
- dev-security-patternsSkill
- dev-technical-writingSkill
- dev-testing-strategySkill
- dev-typescript-patternsSkill
- doc-to-markdownSkill
- finance-bookkeepingSkill
- finance-cash-flowSkill
- finance-receivables-payablesSkill
- finance-reportingSkill
- finance-tax-complianceSkill
- instagram-dm-flowsSkill
- instagram-publishingSkill
- instagram-strategySkill
- legal-clause-librarySkill
- legal-compliance-lgpdSkill
- legal-contract-draftingSkill
- legal-contract-lifecycleSkill
- legal-researchSkill
- linkedin-publishingSkill
- linkedin-strategySkill
- negotiationSkill
- nextjs-react-best-practicesSkill
- presentation-designSkill
- pricingSkill
- robotics-bringup-testingSkill
- robotics-component-researchSkill
- robotics-electrical-safetySkill
- robotics-firmware-patternsSkill
- robotics-iot-connectivitySkill
- robotics-mechanical-buildSkill
- robotics-motion-controlSkill
- robotics-power-batterySkill
- robotics-project-planningSkill
- robotics-ros2-autonomySkill
- sala-de-controleSkill
- sales-deck-productionSkill
- sales-discovery-intakeSkill
- sales-enablementSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 124 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 26
Localize pelos nós que falharam: Use os seletores/nós reprovados na auditoria para achar o componente ou template responsável — não varra o …
“Common” is measured: kept by at least 6 in 10 of the 124 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Acessibilidade (a11y)
Auditar e corrigir acessibilidade com base na WCAG 2.2 e nas auditorias de acessibilidade do Lighthouse. Objetivo: conteúdo utilizável por todo mundo, inclusive pessoas com deficiência. Alvo padrão: nível AA.
Quando usar esta vs. web-design-guidelines: esta audita e corrige acessibilidade contra a WCAG (com evidência de ferramenta e teste manual). Para revisar código de UI contra as guidelines gerais de interface da Vercel (formulários, tipografia, performance, i18n), use web-design-guidelines.
Carregue quando precisar (não leia tudo de saída):
references/A11Y-PATTERNS.md— exemplos de código por critério (alt, contraste, teclado, foco, alvo, formulários, erros, ARIA, live regions, modal, skip link, arrastar, atalhos de leitor de tela).references/NEXTJS-TAILWIND.md— padrões e checklist da stack de sites do CT (Next.js App Router + Tailwind + shadcn/ui).references/WCAG.md— critérios por nível, padrões ARIA comuns, mudanças 2.1 → 2.2, ferramentas.
Fluxo de auditoria com evidência
Quando houver página renderizada:
- Auditoria automática ao vivo. Rode o Lighthouse (categoria Accessibility) na página. Com Chrome DevTools MCP, use
lighthouse_audit; em página pública, modo navegação mobile; em fluxo autenticado ou com estado criado pelo usuário, modo snapshot (recarregar perderia o estado). - Localize pelos nós que falharam. Use os seletores/nós reprovados na auditoria para achar o componente ou template responsável — não varra o repositório inteiro atrás de padrões genéricos.
- Inspecione a árvore de acessibilidade renderizada (nomes, papéis, estados, landmarks, hierarquia de headings) — com Chrome DevTools MCP,
take_snapshot; ou oread_pagedo navegador embutido. Percorra o fluxo afetado só com teclado. - Corrija na fonte e re-audite: rode de novo a mesma auditoria e a mesma interação manual, e registre o antes/depois.
Sem ferramentas ao vivo, use a CLI (abaixo) e faça as mesmas checagens manuais. Ferramenta automática pega só uma parte das barreiras: nota 100 não é conformidade WCAG, e nota baixa não substitui evidência por achado (componente, critério, nó, correção).
# Lighthouse — só acessibilidade
npx lighthouse https://example.com --only-categories=accessibility
# axe-core (sem instalar nada global)
npx @axe-core/cli https://example.comPrincípios WCAG: POUR
| Princípio | O que exige |
| Perceivable — perceptível | O conteúdo pode ser percebido por mais de um sentido (alt, legendas, contraste) |
| Operable — operável | A interface funciona com teclado, sem armadilhas, com tempo e alvos adequados |
| Understandable — compreensível | Linguagem, navegação e erros previsíveis e explicados |
| Robust — robusto | Funciona com tecnologias assistivas (HTML semântico, ARIA correto) |
Níveis: A (mínimo, obrigatório) · AA (padrão — exigência legal em muitas jurisdições; é o nosso alvo) · AAA (reforçado, desejável).
O que checar, por princípio
Os exemplos de código de cada item estão em references/A11Y-PATTERNS.md.
Perceptível
- Texto alternativo (1.1.1): toda imagem informativa com
altdescritivo; decorativa comalt=""(só isso —aria-hiddenourole="presentation"junto é redundante); botão só de ícone com nome acessível (aria-labelou textosr-only) e o SVG comaria-hidden="true". - Contraste (1.4.3): texto normal ≥ 4,5:1; texto grande (≥ 18px, ou ≥ 14px bold) ≥ 3:1.
- Contraste de não-texto (1.4.11): componentes de UI, ícones que carregam sentido e o indicador de foco ≥ 3:1 contra o fundo onde aparecem.
- Não depender só de cor (1.4.1): erro = cor + ícone + texto.
- Mídia (1.2): vídeo com legendas (
<track kind="captions">); áudio com transcrição.
Operável
- Teclado (2.1.1): tudo funciona com teclado. Prefira elementos nativos (
<button>,<a href>, controles de formulário) — eles já tratam Enter/Espaço, foco e semântica. Só adicione tratamento manual de teclado quando não der para usar elemento nativo (ex.:divcomrole="button"precisa detabindex="0"+keydownpara Enter/Espaço). Nunca adicionekeydownde Enter/Espaço a um<button>nativo: ele já disparaclickcom essas teclas, e a ação roda duas vezes. - Sem armadilha de teclado (2.1.2): dá para entrar e sair de todo componente com Tab; foco preso só em modal (o
<dialog>nativo e o RadixDialogjá fazem isso). - Foco visível (2.4.7): nunca
outline: nonesem substituto; use:focus-visiblecomoutline: 2px solid currentColor(herda a cor do texto, que já passou no contraste) eoutline-offset: 2px. Cor de marca no foco só se medir ≥ 3:1 contra todo fundo em que ela cair. - Skip link (2.4.1) para pular a navegação repetida.
- Movimento (2.3): respeitar
prefers-reduced-motion: reduce. - Tempo (2.2.1): limite de tempo com aviso e opção de estender.
Compreensível
- Idioma (3.1.1):
langno<html>(pt-BRnos projetos brasileiros); trecho em outro idioma comlangpróprio. - Navegação consistente (3.2.3) entre páginas, com
aria-current="page"no item atual. - Rótulos (3.3.2): todo campo com label associado programaticamente.
- Erros (3.3.1, 3.3.3):
aria-invalid="true", mensagem ligada poraria-describedby, anúncio porrole="alert"/aria-live, foco no primeiro erro ao enviar, e sugestão de correção.
Robusto
- HTML nativo antes de ARIA (4.1.2):
<button>em vez de<div role="button">; ARIA só quando o nativo não basta, com papéis e estados corretos (aria-expanded,aria-controls,aria-selected…). - Mensagens de status (4.1.3): mudança dinâmica anunciada por
aria-live/role="status"sem mover o foco.
ARIA de uso frequente
| Situação | Marcação correta |
| Botão que abre/fecha um painel ou menu de navegação (disclosure) | aria-expanded + aria-controls="id-do-painel" (sem aria-haspopup) |
| Botão que abre um diálogo | aria-haspopup="dialog" + aria-expanded, e o diálogo com role="dialog" aria-modal="true" aria-labelledby |
| Abas | role="tablist" / tab (aria-selected, aria-controls) / tabpanel |
| Item atual da navegação | aria-current="page" |
Várias <nav> na página | aria-label distinto em cada uma |
| Carregando | aria-busy="true" na região + anúncio em role="status" |
Critérios novos da WCAG 2.2
- 2.4.11 Foco não encoberto (AA): elemento focado não pode ficar totalmente escondido por header/footer fixo ou painel — use
scroll-margin-top/scroll-margin-bottom. - 2.4.12 Foco não encoberto, reforçado (AAA): nenhuma parte do elemento focado escondida.
- 2.4.13 Aparência do foco (AAA): indicador com área e contraste mínimos.
- 2.5.7 Movimentos de arrastar (AA): toda ação de arrastar tem alternativa com um único ponteiro (botões, campo).
- 2.5.8 Tamanho do alvo (AA): alvo interativo ≥ 24×24 px CSS (recomendado 44×44 em toque); exceções: link em texto corrido, controle nativo do navegador, alvo com espaçamento suficiente.
- 3.2.6 Ajuda consistente (A): contato, chat, FAQ repetidos entre páginas ficam na mesma ordem relativa.
- 3.3.7 Entrada redundante (A): não pedir de novo o que o usuário já informou na mesma sessão (preencher automaticamente ou deixar escolher).
- 3.3.8 Autenticação acessível (AA): login sem teste cognitivo, a menos que haja colar/autopreenchimento, método alternativo (passkey, SSO, link por e-mail) ou reconhecimento de objeto/conteúdo pessoal.
- 4.1.1 Parsing foi removido na 2.2.
Next.js/Tailwind — checklist rápido
Padrões completos e exemplos em references/NEXTJS-TAILWIND.md.
lang="pt-BR"(ou o idioma do site) no<html>doapp/layout.tsxraiz- Skip link com
sr-only focus:not-sr-onlyapontando para<main id="main-content"> - Foco visível global em
:focus-visible(outline-2 outline-offset-2 outline-current), semoutline-nonesolto - Interativos acessíveis por teclado — componentes shadcn/Radix já cobrem; não quebrar com wrappers
div onClick - Focus trap só em modal (Radix
Dialoggerencia sozinho) next/imagedecorativa comalt=""; informativa comaltdescritivo- HTML semântico; ARIA só quando o nativo não basta
- Alvos ≥ 24×24 px (botão de ícone
size="icon"do shadcn já cumpre) - Anúncio de loading/erro com
aria-livesem roubar foco
Checagem manual (sempre, além da automática)
- Teclado: percorrer a página com Tab/Shift+Tab, ativar com Enter/Espaço, fechar com Esc
- Ordem de foco lógica e igual à ordem visual; foco nunca escondido por barra fixa
- Leitor de tela: VoiceOver (Mac), NVDA (Windows) ou TalkBack (Android) — atalhos em
references/A11Y-PATTERNS.md#screen-reader-commands - Zoom 200% e reflow em 320 px sem perder conteúdo
- Alto contraste (modo de alto contraste do Windows /
forced-colors) - Movimento reduzido com
prefers-reduced-motion: reduce - Alvos ≥ 24×24 px
Problemas comuns por impacto
Crítico (corrigir já): campo sem label · imagem sem alt · contraste insuficiente · armadilha de teclado · sem indicador de foco.
Sério (corrigir antes de publicar): página sem lang · hierarquia de headings quebrada · link sem texto descritivo ("clique aqui") · mídia com autoplay · sem skip link.
Moderado (corrigir em seguida): ícone sem nome acessível · navegação inconsistente · erro não identificado · tempo limite sem controle · sem landmarks (header, nav, main, footer).
Formato do achado
Para cada problema: critério WCAG (nº e nível) · componente/arquivo · nó ou seletor que falhou · impacto (crítico/sério/moderado) · correção · evidência da re-auditoria.
Referências
- WCAG 2.2 Quick Reference
- WAI-ARIA Authoring Practices
- Regras do axe (Deque)
references/WCAG.md·references/A11Y-PATTERNS.md·references/NEXTJS-TAILWIND.md
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

