convez.ai
SkillDesenvolvimento WebIntermediário
masuP9

A11y Specialist Skills

masuP9/a11y-specialist-skills

Análise e auditoria de acessibilidade web com padrões WCAG 2.2

Ver no GitHub
BomPluginScore · de 0 a 100

Suite de skills para análise de acessibilidade web baseada em WCAG 2.2 e WAI-ARIA APG. Fornece revisão de acessibilidade, auditoria sistemática de conformidade, planejamento de auditorias e roadmaps de melhoria com avaliação de maturidade.

Instalação

$npx convez-ai masuP9/a11y-specialist-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
61
Forks
3
Acompanhando
1
Saúde
42%
Último commit
há 1 semana
Versão
—
Issues abertas
4
Contribuidores
3

Casos de uso

  • Revisar acessibilidade de páginas web, componentes e mockups de design
  • Auditar conformidade WCAG 2.2 AA com testes automatizados e manuais
  • Planejar roadmaps de melhoria de acessibilidade com KPIs

Veredito

Plugin sólido e bem estruturado para times que levam acessibilidade a sério. Baseia-se em padrões consolidados (WCAG 2.2 AA, WAI-ARIA APG) e oferece tanto análises rápidas quanto auditorias sistemáticas. Recomendado para projetos que precisam evidenciar conformidade e implementar melhorias estruturadas.

README

A tradução para o português deste README ainda está na fila.

a11y-specialist-skills

日本語版 (Japanese)

Accessibility specialist skills plugin for Claude Code and Codex.

Provides accessibility review skills based on WCAG 2.2 & WAI-ARIA APG.

Skills

SkillDescription
reviewing-a11yAccessibility review for web pages, component implementations, design mockups, and specifications
auditing-wcagSystematic WCAG 2.2 AA conformance auditing with automated test scripts
planning-wcag-auditWCAG audit planning based on WAIC guidelines (page selection, test methods)
planning-a11y-improvementAccessibility improvement planning with maturity assessment, roadmap, KPI design

Installation

As a Claude Code Plugin

# Add marketplace
/plugin marketplace add masuP9/a11y-specialist-skills

# Install plugin
/plugin install a11y-specialist-skills@a11y-specialist-skills

As a Standalone Skill (Symlink)

# Clone the repository
git clone https://github.com/masuP9/a11y-specialist-skills.git

# Create symlink to your skills directory
ln -s /path/to/a11y-specialist-skills/skills/reviewing-a11y ~/.claude/skills/reviewing-a11y

For Development

# Test locally with --plugin-dir
claude --plugin-dir /path/to/a11y-specialist-skills

As a Codex Plugin (Recommended)

# Add the marketplace
codex plugin marketplace add masuP9/a11y-specialist-skills

# Start Codex and install a11y-specialist-skills from /plugins
codex

As a Standalone Codex Skill

# Clone the repository
git clone https://github.com/masuP9/a11y-specialist-skills.git

# Link the required skill into the Codex user skill directory
ln -s /path/to/a11y-specialist-skills/skills/reviewing-a11y ~/.agents/skills/reviewing-a11y

Usage

reviewing-a11y (Accessibility Review)

Claude Code and Codex automatically detect when to use the skill:

# Examples
Review accessibility
Check a11y
Accessibility review please

You can also provide specific targets:

# URL
Review a11y for https://example.com

# Local file
Check accessibility of src/components/Button.tsx

# Design spec
Review this design mockup from a11y perspective

You can also invoke it explicitly:

# Claude Code
/reviewing-a11y

# Codex
$reviewing-a11y

Review Output

The skill provides structured feedback including:

  • Positive Findings: What's done well from an accessibility perspective
  • Issues: Problems categorized by severity (Critical / Major / Minor)
    • Location in code/page
    • Description of the issue
    • Related WCAG success criterion
    • Suggested fix
  • Manual Checks: Items that require human verification

auditing-wcag (WCAG Conformance Audit)

Perform systematic WCAG 2.2 AA conformance audits:

# Examples
Audit this page for WCAG compliance
Run WCAG audit on https://example.com
Check WCAG 2.2 AA conformance

You can also invoke it explicitly:

# Claude Code
/auditing-wcag

# Codex
$auditing-wcag

Audit Process

The skill guides through a 4-phase audit:

  1. Automated Checks: axe-core + custom Playwright scripts
  2. Interactive Checks: Keyboard, focus, pointer operations
  3. Manual Checks: Human verification items
  4. Content Review: Alt text, labels, headings quality

Includes automated test scripts for:

  • Focus indicators (2.4.7, 2.4.12, 3.2.1)
  • Reflow at 320px (1.4.10)
  • Text spacing (1.4.12)
  • Target size (2.5.5, 2.5.8)
  • And more...

npm package. The automated checks are published as @a11y-skills/audit (this repo is a monorepo). The auditing-wcag skill's scripts are thin wrappers around it, and you can use the checks directly in your own Playwright project: npm install -D @a11y-skills/audit. See the package README.

planning-wcag-audit (Audit Planning)

Plan WCAG audits based on WAIC guidelines:

# Examples
Help me plan a WCAG audit
Create audit plan for our website
Select pages for accessibility testing

You can also invoke it explicitly:

# Claude Code
/planning-wcag-audit

# Codex
$planning-wcag-audit

Planning Output

  • Page Selection: Representative pages based on WAIC methodology
  • Test Methods: Automated vs manual test allocation
  • Audit Plan Document: Formal audit plan template

planning-a11y-improvement (Improvement Planning)

Create organizational accessibility improvement plans:

# Examples
Help me plan accessibility improvements
Create an a11y strategy
Assess our organization's a11y maturity

You can also invoke it explicitly:

# Claude Code
/planning-a11y-improvement

# Codex
$planning-a11y-improvement

Planning Output

Collects information through interview format and generates:

  • Maturity Assessment: Current level (L1-L4) with rationale
  • Roadmap: Phased initiatives with owners
  • KPI Design: Leading and lagging indicators
  • Stakeholder Materials: Business impact and ROI

You can also load documents such as accessibility test results or initiative history for more accurate planning.

Development and Compatibility

Each skill uses one shared SKILL.md in Claude Code and Codex. The frontmatter keeps argument-hint and allowed-tools to preserve Claude Code input guidance and permissions. The supported Codex runtime tolerates these extensions and loads the same skill.

npm ci
npm run validate:skills

This repository uses the shared compatibility validator above as its CI gate. The general Codex quick_validate.py is not used because it rejects the Claude Code argument-hint extension.

References

License

MIT

Ver o original no GitHub

Bom para

Relacionados