¿Qué hace wcag-audit-patterns?
Realiza auditorías de accesibilidad WCAG 2.2 con pruebas automatizadas, verificación manual y orientación para la remediación. Útil al auditar sitios web por accesibilidad, corregir violaciones WCAG o implementar patrones de diseño accesibles.
Descripción General
Este skill permite ejecutar auditorías completas de accesibilidad web siguiendo los estándares WCAG 2.2. Incluye:
- Pruebas automatizadas: Ejecución de herramientas como Axe, Lighthouse o pa11y para detectar violaciones comunes.
- Verificación manual: Pasos para comprobar aspectos como navegación con teclado, enfoque visible, contraste de color y semántica ARIA.
- Guía de remediación: Instrucciones detalladas para corregir cada tipo de violación, incluyendo ejemplos de código.
- Generación de informes: Creación de resúmenes estructurados con prioridad, gravedad y pasos de corrección.
Compatibilidad
- Plataformas: Agentes de IA compatibles con SKILL.md (Claude Code, Cursor, Codex, etc.).
- Marcos de trabajo: React, Vue, Angular, HTML/CSS puro.
- Herramientas automatizadas: Axe-core, Lighthouse, pa11y (requiere instalación externa).
- Entornos: Integración en CI/CD (GitHub Actions, GitLab CI) y desarrollo local.
Cómo Usarlo
- Configuración inicial: Asegúrate de tener las herramientas de auditoría instaladas (por ejemplo,
npm install axe-core --save-dev). - Ejecutar escaneo automatizado: Solicita al agente que ejecute un escaneo en una URL o archivo local.
- Revisar resultados: El agente interpretará las violaciones y las clasificará por criterio WCAG 2.2 (A, AA, AAA).
- Verificación manual: Sigue las indicaciones para comprobar puntos no automatizables (por ejemplo, orden lógico de tabulación, etiquetas descriptivas).
- Remediación: El agente proporcionará correcciones de código sugeridas (atributos ARIA, etiquetas HTML semánticas, ajustes de CSS).
- Informe final: Recibe un resumen en formato markdown con todas las violaciones, su gravedad y los pasos para solucionarlas.
Ejemplo de Comandos
# Escanear una URL específica
npx axe https://ejemplo.com --save report.json
# Usar Lighthouse desde CLI
lighthouse https://ejemplo.com --output json --output-path ./report.json
Notas Importantes
- Las pruebas automatizadas no cubren todos los criterios WCAG 2.2; la verificación manual es esencial.
- Siempre prioriza correcciones de nivel A y AA antes que AAA para cumplir con requisitos legales.
- Las correcciones sugeridas deben probarse con usuarios reales cuando sea posible.