Agent skill

A11y Audit

by ricneves-ai in ricneves-ai/flowgrammers-skills

Skill de auditoria de acessibilidade para escanear, corrigir e verificar a conformidade WCAG 2.2 Nível A e AA em codebases React, Next.js, Vue, Angular, Svelte e HTML puro.

MITAuto-check passedFrontend & Design

Install A11y Audit

skills CLI
$ npx skills add ricneves-ai/flowgrammers-skills --skill a11y-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ricneves-ai/flowgrammers-skills a11y-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ricneves-ai/flowgrammers-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering-team/a11y-audit .claude/skills/a11y-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
a11y-audit
GitHub stars
115
Token cost
~2.7k tokens
SKILL.md length
819 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Skill de auditoria de acessibilidade para escanear, corrigir e verificar a conformidade WCAG 2.2 Nível A e AA em codebases React, Next.js, Vue, Angular, Svelte e HTML puro.

  • Works in 5 steps: Escaneia seu codebase em busca de todas… → Corrige cada violação com padrões de… → Verifica que as correções resolvem as… → …
  • Tasks that involve Accessibility
  • SKILL.md covers Descrição, Funcionalidades, Uso and Exemplo: Auditoria de…, plus 5 more sections
  • Calls python

What it does

A11y Audit is an agent skill from ricneves-ai/flowgrammers-skills. Skill de auditoria de acessibilidade para escanear, corrigir e verificar a conformidade WCAG 2.2 Nível A e AA em codebases React, Next.js, Vue, Angular, Svelte e HTML puro. Use ao auditar acessibilidade, corrigir violações de a11y, verificar contraste de cores, gerar relatórios de conformidade ou integrar verificações de acessibilidade em pipelines CI/CD.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Accessibility. It works with React, Angular, Next.js and Svelte. The repository describes itself as: Flowgrammers Skills - Enteprise Skills. The licence is MIT.

When your agent uses it

  • Tasks that involve Accessibility

Example prompts

  • “/a11y-audit”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Escaneia seu codebase em busca de todas as violações WCAG 2.2 Nível A e AA, categorizadas por severidade (Crítica, Maior, Menor)
  2. Corrige cada violação com padrões de código antes/depois específicos para o framework
  3. Verifica que as correções resolvem as violações originais e não introduzem regressões
  4. Reporta os resultados em formato estruturado adequado para desenvolvedores, PMs e partes interessadas em conformidade
  5. Integra em pipelines CI/CD para prevenir regressões de acessibilidade

What it can do on your machine

Read from SKILL.md and the folder at commit 1ae2d4a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • w3.org
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

A11y Audit loads about 2.7k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 819 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ricneves-ai/flowgrammers-skills at commit 1ae2d4a, republished under its MIT licence (© ricneves-ai). 819 words, ~2,684 tokens.

Download SKILL.mdSave it as .claude/skills/a11y-audit/SKILL.md (or your agent's skills folder).
name
a11y-audit
description
Skill de auditoria de acessibilidade para escanear, corrigir e verificar a conformidade WCAG 2.2 Nível A e AA em codebases React, Next.js, Vue, Angular, Svelte e HTML puro. Use ao auditar acessibilidade, corrigir violações de a11y, verificar contraste de cores, gerar relatórios de conformidade ou integrar verificações de acessibilidade em pipelines CI/CD.
agents
claude-code

Auditoria de Acessibilidade

Skill de Auditoria e Remediação de Acessibilidade WCAG 2.2

Descrição

A skill a11y-audit fornece um pipeline completo de auditoria de acessibilidade para aplicações web modernas. Implementa um fluxo de trabalho em três fases — Escanear, Corrigir, Verificar — que identifica violações WCAG 2.2 Nível A e AA, gera código de correção preciso por framework e produz relatórios de conformidade prontos para partes interessadas.

Para cada violação encontrada, fornece o código de correção preciso antes/depois, adaptado ao seu framework (React, Next.js, Vue, Angular, Svelte ou HTML puro).

O que esta skill faz:

  1. Escaneia seu codebase em busca de todas as violações WCAG 2.2 Nível A e AA, categorizadas por severidade (Crítica, Maior, Menor)
  2. Corrige cada violação com padrões de código antes/depois específicos para o framework
  3. Verifica que as correções resolvem as violações originais e não introduzem regressões
  4. Reporta os resultados em formato estruturado adequado para desenvolvedores, PMs e partes interessadas em conformidade
  5. Integra em pipelines CI/CD para prevenir regressões de acessibilidade

Funcionalidades

FuncionalidadeDescrição
Escaneamento WCAG 2.2 CompletoVerifica todos os critérios de sucesso Nível A e AA em seu codebase
Detecção de FrameworkDetecta automaticamente React, Next.js, Vue, Angular, Svelte ou HTML puro
Classificação de SeveridadeCategoriza cada violação como Crítica, Maior ou Menor
Geração de Código de CorreçãoProduz diffs de código antes/depois para cada problema
Verificador de Contraste de CoresValida pares de cores de primeiro e segundo plano contra as proporções AA e AAA
Relatórios de ConformidadeGera relatórios para partes interessadas com resumos de aprovação/reprovação
Integração CI/CDConfigurações de pipeline para GitHub Actions, GitLab CI, Azure DevOps
Auditoria de Navegação por TecladoDetecta gerenciamento de foco ausente e problemas de ordem de tabulação
Validação ARIAVerifica atributos ARIA incorretos, redundantes ou ausentes
Definições de Severidade
SeveridadeDefiniçãoExemploSLA
CríticaBloqueia o acesso para grupos inteiros de usuáriosTexto alternativo ausente, sem acesso por teclado à navegaçãoCorrigir antes do lançamento
MaiorBarreira significativa que degrada a experiênciaContraste de cores insuficiente, rótulos de formulário ausentesCorrigir dentro do sprint atual
MenorProblema de usabilidade que causa atritoFunções ARIA redundantes, hierarquia de cabeçalhos subótimaCorrigir nos próximos 2 sprints

Uso

Início Rápido
bash
# Escanear projeto inteiro
python scripts/a11y_scanner.py /path/to/project

# Escanear com saída JSON para ferramentas
python scripts/a11y_scanner.py /path/to/project --json

# Verificar contraste de cores para valores específicos
python scripts/contrast_checker.py --fg "#777777" --bg "#ffffff"

# Verificar contraste em um arquivo CSS/Tailwind
python scripts/contrast_checker.py --file /path/to/styles.css
Slash Command
/a11y-audit                    # Auditar o projeto atual
/a11y-audit --scope src/       # Auditar diretório específico
/a11y-audit --fix              # Auditar e aplicar correções automaticamente
/a11y-audit --report           # Gerar relatório para partes interessadas
/a11y-audit --ci               # Saída de resultados compatível com CI
Fluxo de Trabalho em Três Fases

Fase 1: Escanear — Percorrer a árvore de código-fonte, detectar framework, aplicar conjunto de regras.

bash
python scripts/a11y_scanner.py /path/to/project --format table

Fase 2: Corrigir — Aplicar correções específicas para o framework em cada violação.

Veja references/framework-a11y-patterns.md para o catálogo completo de padrões de correção.

Fase 3: Verificar — Executar novamente o scanner para confirmar as correções e verificar regressões.

bash
python scripts/a11y_scanner.py /path/to/project --baseline audit-baseline.json

Exemplo: Auditoria de Componente React

tsx
// ANTES: src/components/ProductCard.tsx
function ProductCard({ product }) {
  return (
    <div onClick={() => navigate(`/product/${product.id}`)}>
      <img src={product.image} />
      <div style={{ color: '#aaa', fontSize: '12px' }}>{product.name}</div>
      <span style={{ color: '#999' }}>${product.price}</span>
    </div>
  );
}
#WCAGSeveridadeProblema
11.1.1Crítica<img> sem atributo alt
22.1.1Crítica<div onClick> não acessível por teclado
31.4.3MaiorCor #aaa no branco falha no contraste (2.32:1, necessita 4.5:1)
41.4.3MaiorCor #999 no branco falha no contraste (2.85:1, necessita 4.5:1)
54.1.2MaiorElemento interativo sem role e nome acessível
tsx
// DEPOIS: src/components/ProductCard.tsx
function ProductCard({ product }) {
  return (
    <a href={`/product/${product.id}`} className="product-card"
       aria-label={`View ${product.name} - $${product.price}`}>
      <img src={product.image} alt={product.imageAlt || product.name} />
      <div style={{ color: '#595959', fontSize: '12px' }}>{product.name}</div>
      <span style={{ color: '#767676' }}>${product.price}</span>
    </a>
  );
}

Veja references/examples-by-framework.md para exemplos em Vue, Angular, Next.js e Svelte.

Show full SKILL.md (328 more words)Show less

Referência de Ferramentas

a11y_scanner.py
Uso: python scripts/a11y_scanner.py <caminho> [opções]

Opções:
  --json                  Saída dos resultados como JSON
  --format {table,csv}    Formato de saída (padrão: table)
  --severity {critical,major,minor}  Filtrar por severidade mínima
  --framework {react,vue,angular,svelte,html,auto}  Forçar framework (padrão: auto)
  --baseline FILE         Comparar com resultados de escaneamento anteriores
  --report                Gerar relatório para partes interessadas
  --output FILE           Escrever resultados em arquivo
  --quiet                 Suprimir saída, apenas código de saída
  --ci                    Modo CI: saída não-zero em problemas críticos
contrast_checker.py
Uso: python scripts/contrast_checker.py [opções]

Opções:
  --fg COLOR              Cor de primeiro plano (hex)
  --bg COLOR              Cor de segundo plano (hex)
  --file FILE             Escanear arquivo CSS para pares de cores
  --tailwind DIR          Escanear diretório para classes de cores Tailwind
  --json                  Saída dos resultados como JSON
  --suggest               Sugerir alternativas acessíveis para falhas
  --level {aa,aaa}        Nível de conformidade alvo (padrão: aa)

Armadilhas Comuns

ArmadilhaAbordagem Correta
role="button" em um <div>Use <button> nativo — inclui tratamento de teclado gratuitamente
tabindex="0" em tudoApenas elementos interativos precisam de foco; use elementos nativos
aria-label em elementos não-interativosUse aria-labelledby apontando para texto visível
display: none para ocultar de leitores de telaUse a classe .sr-only
Cor apenas para transmitir significadoAdicione ícones, rótulos de texto ou padrões junto com a cor
Placeholder como único rótuloSempre forneça um <label> visível
outline: none sem substituiçãoSempre forneça um indicador de foco visível via focus-visible
alt="" vazio em imagens informacionaisImagens informacionais precisam de texto alternativo descritivo
Pular níveis de cabeçalho (h1 -> h3)Níveis de cabeçalho devem ser sequenciais
onClick sem onKeyDownAdicione suporte a teclado ou prefira elementos nativos
Ignorar prefers-reduced-motionEnvolva animações em @media (prefers-reduced-motion: no-preference)

Skills Relacionadas

SkillRelação
senior-frontendPadrões de frontend usados em correções de a11y
code-reviewerIncluir verificações de a11y em fluxos de trabalho de revisão de código
senior-qaIntegração de testes de a11y em processos de QA
playwright-proTestes automatizados de navegador com asserções de acessibilidade
epic-designAnimações e scroll storytelling em conformidade com WCAG 2.1 AA
tdd-guidePadrões de desenvolvimento orientado a testes para casos de teste de a11y

Documentação de Referência

ReferênciaDescrição
wcag-quick-ref.mdReferência rápida dos critérios WCAG 2.2 Nível A e AA
wcag-22-new-criteria.mdNovos critérios de sucesso WCAG 2.2 (Aparência de Foco, Tamanho Meta, etc.)
aria-patterns.mdPadrões ARIA, interação por teclado e regiões ao vivo
framework-a11y-patterns.mdPadrões de correção específicos por framework (React, Vue, Angular, Svelte, HTML)
color-contrast-guide.mdDetalhes do verificador de contraste de cores, mapeamento de paleta Tailwind, classe sr-only
ci-cd-integration.mdConfigurações de GitHub Actions, GitLab CI, Azure DevOps, pre-commit hook
audit-report-template.mdModelo de relatório de auditoria pronto para partes interessadas
testing-checklist.mdLista de verificação de testes manuais (teclado, leitor de tela, visual, formulários)
examples-by-framework.mdExemplos completos de auditoria para Vue, Angular, Next.js e Svelte

Recursos

© ricneves-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in engineering-team/a11y-audit of ricneves-ai/flowgrammers-skills.

Open the folder on GitHubat commit 1ae2d4a

Compare with similar skills

A11y Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

A11y Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
A11y Audit this skillricneves-ai/flowgrammers-skills115—~2.7kAutomated safety check: PassMIT
A11y Auditalirezarezvani/claude-skills28k—~2.4kAutomated safety check: PassMIT
Kb Framework AccessibilityCommunity-Access/accessibility-agents423—~1.8kAutomated safety check: PassMIT
UI/UX Design System AdvisorGalaxy-Dawn/claude-scholar5.7k1 repos~1.1kAutomated safety check: PassMIT
Kb Web ScanningCommunity-Access/accessibility-agents423—~1.2kAutomated safety check: PassMIT
Markstream Installsickn33/agentic-awesome-skills47k1 repos~2kAutomated safety check: PassMIT

Similar skills

  • A11y Audit

    alirezarezvani/claude-skills

    Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases.

    28k GitHub stars~2.4k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Kb Framework Accessibility

    Community-Access/accessibility-agents

    Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.

    423 GitHub stars~1.8k tokensUpdated 18 days ago
    Frontend & DesignAuto-check passed
  • UI/UX Design System Advisor

    Galaxy-Dawn/claude-scholar

    Turns a vague UI request into a concrete design system with style, palette, typography and layout guidance from a search script, plus stack-specific implementation advice.

    5.7k GitHub starsUsed in 1 repo~1.1k tokens
    Frontend & DesignAuto-check passed
  • Kb Web Scanning

    Community-Access/accessibility-agents

    Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.

    423 GitHub stars~1.2k tokensUpdated 18 days ago
    Frontend & DesignAuto-check passed
  • Markstream Install

    sickn33/agentic-awesome-skills

    Install and configure Markstream streaming Markdown renderers for Vue, React, Svelte, Angular, Nuxt, Next.js, and Vue 2 applications.

    47k GitHub starsUsed in 1 repo~2k tokens
    Frontend & DesignAuto-check passed
  • Add Shader Cursor Trail

    nirholas/three.ws

    Add the Shaders WebGPU mouse effect used for the Tidal Commons hero: a white twinkling halftone cursor trail driven by ChromaFlow, masked through a DotGrid, finished with chromatic ripples and film…

    230 GitHub starsUsed in 1 repo~760 tokens
    Game DevelopmentAuto-check passed

More from ricneves-ai/flowgrammers-skills

All 10 skills in this repo
  • Prd Generator

    ricneves-ai/flowgrammers-skills

    Gerador de PRD (Product Requirements Document) em portugues-BR a partir de um Product Brief.

    115 GitHub stars~2k tokensUpdated 15 days ago
    Auto-check passed
  • Sdd Generator

    ricneves-ai/flowgrammers-skills

    Especialista em SDD (Software Design Document) — transforma um PRD completo numa estrutura de specs quebrada por pasta no formato .specs/NNN-nome/, com contextos isolados por feature, arquivo…

    115 GitHub stars~1.1k tokensUpdated 15 days ago
    Auto-check passed
  • Codigo Automacao

    ricneves-ai/flowgrammers-skills

    Skills para desenvolvimento de software, debug, APIs, automações no-code e uso avançado de ferramentas de IA para desenvolvimento.

    115 GitHub stars~2.3k tokensUpdated 15 days ago
    Auto-check: notes
  • Conteudo Copy

    ricneves-ai/flowgrammers-skills

    Skills para criação de conteúdo escrito, copy persuasivo, headlines, emails e artigos em português BR.

    115 GitHub stars~3k tokensUpdated 15 days ago
    Auto-check passed
  • Marketing Vendas

    ricneves-ai/flowgrammers-skills

    Skills para funis de vendas, propostas comerciais, tratamento de objeções e publicidade digital com contexto do mercado brasileiro.

    115 GitHub stars~2.9k tokensUpdated 15 days ago
    Auto-check passed
  • Rotina Organizacao

    ricneves-ai/flowgrammers-skills

    Skills de produtividade pessoal com metodologias GTD, time blocking, gestão de energia e organização de projetos pessoais.

    115 GitHub stars~2.5k tokensUpdated 15 days ago
    Auto-check passed

Questions about A11y Audit

What does A11y Audit do?

Skill de auditoria de acessibilidade para escanear, corrigir e verificar a conformidade WCAG 2.2 Nível A e AA em codebases React, Next.js, Vue, Angular, Svelte e HTML puro. A11y Audit is an agent skill from ricneves-ai/flowgrammers-skills.js, Vue, Angular, Svelte e HTML puro.

When should I use A11y Audit?

A11y Audit fits situations like: tasks that involve Accessibility.

How do I install A11y Audit in Claude Code?

Run `npx skills add ricneves-ai/flowgrammers-skills --skill a11y-audit -a claude-code`. Or copy the skill folder (engineering-team/a11y-audit in ricneves-ai/flowgrammers-skills) into .claude/skills/a11y-audit in your project. Claude Code loads it when a task matches its description.

How do I install A11y Audit in Codex?

Run `npx skills add ricneves-ai/flowgrammers-skills --skill a11y-audit -a codex`. Or copy the skill folder (engineering-team/a11y-audit in ricneves-ai/flowgrammers-skills) into .agents/skills/a11y-audit in your project. Codex loads it when a task matches its description.

Can I use A11y Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ricneves-ai/flowgrammers-skills --skill a11y-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/a11y-audit, .gemini/skills/a11y-audit, .github/skills/a11y-audit and .opencode/skills/a11y-audit in your project.

What does A11y Audit need to run?

Going by SKILL.md and its folder, A11y Audit needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does A11y Audit access the network?

SKILL.md names 2 domains. As links in the text: w3.org and github.com. This is read from the text; nothing was executed.

Is A11y Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does A11y Audit use?

A11y Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does A11y Audit use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to A11y Audit?

Skills that share tags, products or a category with A11y Audit: A11y Audit (alirezarezvani/claude-skills, 28k stars), Kb Framework Accessibility (Community-Access/accessibility-agents, 423 stars), UI/UX Design System Advisor (Galaxy-Dawn/claude-scholar, 5.7k stars) and Kb Web Scanning (Community-Access/accessibility-agents, 423 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains A11y Audit?

ricneves-ai (a GitHub user) maintains it in ricneves-ai/flowgrammers-skills, which has 115 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 25, 2026.

Source: ricneves-ai/flowgrammers-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.