Ir a la guía de uso
Accessibility Auditpor Alireza Rezvani

Accessibility Audit Skill.

Mantén cada hallazgo de accesibilidad vinculado al elemento afectado, la corrección propuesta y el resultado de la verificación.

  • Accesibilidad
  • Revisión de diseño
  • Frontend
Revisión del código fuente · Accessibility AuditSKILL.md
Tarea Accesibilidad Produce • Un informe de hallazgos de accesibilidad ordenados por gravedad • Correcciones de código con antes y después, adaptadas al framework del proyecto • Una comparación con los hallazgos iniciales y una lista de comprobaciones manuales pendientes Antes de empezar Python para las herramientas incluidas, acceso al código fuente y un navegador o configuración de tecnología de asistencia para la validación en contexto.
Resumen editorial · fuente revisada 2026-10-07 · no es un ejemplo generado

01 Qué hace

Convierte los hallazgos de accesibilidad en correcciones verificables

Un flujo de accesibilidad de escanear, corregir y verificar con utilidades de Python, referencias por framework y plantillas de informe.

Flujo basado en la fuenteNo es una prueba comparativa de ejecución

Cómo funciona

A11y Audit organiza el trabajo de accesibilidad en fases de escaneo, corrección y verificación. La fuente incluye interfaces de escáner y de comprobación de contraste en Python, categorías de gravedad y referencias de corrección específicas por framework. Puede ayudar a convertir una petición vaga de mejorar la accesibilidad en una lista acotada de elementos y cambios de código.

La fuente describe una amplia cobertura de WCAG, pero un escaneo del código no debe presentarse como una certificación completa de conformidad. Los flujos con teclado, el comportamiento de los lectores de pantalla, el contenido dinámico y la utilidad del texto alternativo siguen requiriendo revisión en contexto. El valor práctico es la trazabilidad: conservar los hallazgos iniciales, aplicar la semántica nativa o los cambios de estilo adecuados, volver a ejecutar las comprobaciones y probar la interacción real.

Entregables previstos

  • Un informe de hallazgos de accesibilidad ordenados por gravedad
  • Correcciones de código con antes y después, adaptadas al framework del proyecto
  • Una comparación con los hallazgos iniciales y una lista de comprobaciones manuales pendientes
Ver el brief de ejemplo

Del brief a la revisión

  1. 01
    Escanea un alcance definido

    Identifica el framework y las rutas de código relevantes. Registra los hallazgos a nivel de elemento y distingue las detecciones del escáner de las observaciones manuales.

  2. 02
    Corrige la interacción de fondo

    Prefiere controles nativos, etiquetas con sentido y foco visible en lugar de añadir atributos ARIA de forma indiscriminada.

  3. 03
    Verifica en contexto

    Compara con la línea base, comprueba el contraste en el estado renderizado y prueba los recorridos con teclado y tecnología de asistencia que el análisis estático no puede establecer.

02 Cuándo usarlo

Cuándo usarla

Python para las herramientas incluidas, acceso al código fuente y un navegador o configuración de tecnología de asistencia para la validación en contexto.

Buen encaje

  • Planificación de correccionesÚtil para convertir un conjunto de problemas a nivel de código en cambios priorizados y revisables.
  • Comprobaciones de regresiónEncaja en un proyecto que añade comprobaciones de accesibilidad repetibles a un proceso de pruebas existente.

Límites que conviene revisar

  • No es un certificado de cumplimientoPasar las herramientas incluidas no demuestra que se cumplan todos los requisitos de accesibilidad aplicables en todo el producto.
  • La gravedad necesita contextoLas etiquetas de gravedad de la fuente son una ayuda de triaje. El impacto real en los usuarios depende del elemento, la tarea y las alternativas disponibles.

Aporta estos datos

  • Alcance de la auditoríaIndica las páginas, los componentes o el directorio de código fuente y el recorrido de usuario que se revisa.
  • Estados renderizadosFacilita acceso a formularios, errores, diálogos y otros estados que no aparecen en una página estática simple.
  • Línea base existenteIncluye hallazgos o resultados de pruebas anteriores para poder separar los problemas resueltos de las regresiones.

03 Decisiones importantes

Decisiones que importan

  1. Las correcciones siguen siendo trazables

    Los ejemplos de antes y después conectan un hallazgo con una implementación concreta en lugar de dejar solo una referencia a un estándar.

  2. La automatización tiene un límite

    Un informe útil indica qué se escaneó, qué se probó manualmente y qué sigue sin verificar.

04 Ejemplo de brief

Prueba un brief concreto

El brief de ejemplo siguiente no se ha probado. Revisa la configuración de la skill antes de usarlo.

Revisa la configuración

Conserva los scripts y los patrones de referencia. Revisa la cobertura del escáner antes de usar sus resultados como criterio de lanzamiento.

Archivo fuente original
https://github.com/alirezarezvani/claude-skills/blob/19392f7a08264ed00486a251f5b2098321771f94/engineering-team/a11y-audit/skills/a11y-audit/SKILL.md

Python para las herramientas incluidas, acceso al código fuente y un navegador o configuración de tecnología de asistencia para la validación en contexto.

Empieza con un solo entregable

Adapta el alcance, el material de partida y las restricciones de este brief antes de ejecutar la skill.

Brief de ejemplo
Usa a11y-audit para revisar nuestro formulario de pago y el modal. Empieza con un informe de hallazgos de solo lectura, que incluya los elementos afectados y el razonamiento de gravedad. Revisa etiquetas, controles nativos, visibilidad del foco y contraste, y después enumera las comprobaciones manuales con teclado y lector de pantalla. No afirmes que la página cumple WCAG basándote solo en el escáner, y no apliques correcciones hasta que yo las apruebe.

Inspecciona el resultado

Comprueba el resultado real con estos criterios observables.

  • Cada hallazgo identifica un elemento real y una corrección aplicable.
  • Los problemas resueltos se vuelven a comprobar con la línea base original.
  • El comportamiento no probado con teclado, lector de pantalla y estados dinámicos queda explícitamente sin verificar.

OpenDesign ofrece un espacio de trabajo de diseño local para agentes de programación. Este listado no significa que la skill esté incluida ni que se incluyan sus herramientas externas, credenciales y dependencias de software.

05 Fuente y licencia

Fuente y licencia

Esta página describe la revisión fijada de la fuente enlazada abajo. El comportamiento y los requisitos originales pueden cambiar.

Propietario de la fuente
Alireza Rezvani
Licencia
MIT
Versión revisada
2026-10-07 · 19392f7a0826
Resumen editorial de la fuente
Un flujo de accesibilidad de escanear, corregir y verificar con utilidades de Python, referencias por framework y plantillas de informe.

Resumen original de OpenDesign, basado en la fuente enlazada. Las estrellas del repositorio son una señal de popularidad fechada, no uso de la skill ni una puntuación de calidad.

06 Preguntas antes de empezar

Preguntas antes de empezar

¿Puede el escáner demostrar la conformidad con WCAG?

No. La skill puede apoyar una auditoría, pero las comprobaciones automáticas del código fuente no cubren todos los requisitos contextuales ni de interacción.

¿Solo es compatible con React?

La fuente incluye patrones para varios frameworks web y para HTML simple. Verifica la compatibilidad real del escáner y de las referencias con la versión del proyecto.

¿Debe recibir un rol ARIA cada elemento en el que se pueda hacer clic?

No automáticamente. La fuente prefiere en general los controles semánticos nativos, que aportan un comportamiento que un rol ARIA por sí solo no añade.

OpenDesign

Deja espacio para la siguiente iteración de diseño.

Mantén tu brief, el material de partida y el trabajo de diseño juntos en un espacio de trabajo local. Revisa la configuración propia de la skill antes de añadirla a tu flujo de trabajo.

Archivo fuente original
https://github.com/alirezarezvani/claude-skills/blob/19392f7a08264ed00486a251f5b2098321771f94/engineering-team/a11y-audit/skills/a11y-audit/SKILL.md