Ir a la guía de uso
accessibilitypor Addy Osmani

Accessibility Skill.

Una skill para Claude Code y Codex para revisión de diseño: audita y mejora la accesibilidad web siguiendo WCAG 2.2.

  • Revisión de Diseño y Accesibilidad
  • Informe de revisión
addyosmani/web-quality-skills · skills/accessibility/SKILL.mdSKILL.md
--- name: accessibility description: Audit and improve web accessibility following WCAG 2.2 guidelines. Use when asked to "improve accessibility", "a11y audit", "WCAG compliance", "screen reader support", "keyboard navigation", or "make accessible". --- ## Evidence-led audit workflow ## WCAG Principles: POUR ## Conformance levels ## Perceivable ## Operable ## Understandable
Encabezado y títulos de sección leídos del archivo fuente el 14/09/2026 · 14 265 caracteres en total

01 Qué hace

Qué hace el Skill de accesibilidad en Claude Code y Codex

Resumen, flujo de trabajo y resultados, todo leído del SKILL.md del skill.

Del SKILL.mdLeído 2026-09-14 · no es una ejecución registrada

En los propios términos del Skill

Este skill audita y corrige la accesibilidad web conforme a WCAG 2.2, organizada en torno a POUR — Perceivable, Operable, Understandable, Robust — y los niveles de conformidad A, AA y AAA. Ejecuta un flujo de trabajo basado en evidencia: cuando hay una página renderizada disponible, ejecute una auditoría de accesibilidad Lighthouse en vivo (lighthouse_audit con Chrome DevTools MCP), use los nodos fallidos para localizar el componente, inspeccione el árbol de accesibilidad con take_snapshot y, después, corrija el código fuente y vuelva a ejecutar.

Si faltan las herramientas en vivo, Lighthouse CLI o axe cubren la mitad automatizada y siguen aplicándose las mismas comprobaciones manuales. Incluye reglas a nivel de código para texto alternativo, ratios de contraste, visibilidad del foco, tamaño del objetivo, movimiento reducido, errores de formulario y autenticación accesible, además de una lista de triaje ordenada en crítico, grave y moderado.

Qué produce

  • Una lista de problemas priorizada, agrupada en niveles Crítico (corregir de inmediato), Grave (corregir antes del lanzamiento) y Moderado (corregir pronto), con ejemplos concretos.
  • Marcado corregido y fragmentos listos para pegar, incluida una utilidad de ocultación visual para exponer a las tecnologías de asistencia las etiquetas de los botones de icono.
  • Implementaciones de referencia completas en references/A11Y-PATTERNS.md que cubren etiquetas de formulario, trampa de foco en modales, enlace de salto, pestañas ARIA, regiones dinámicas, gestión de errores y comandos de lectores de pantalla.
Ver el ejemplo de prompt ↗

Cómo funciona

  1. 01
    Ejecutar una auditoría de accesibilidad en vivo

    Comience con una página renderizada y ejecute una auditoría Lighthouse de accesibilidad en vivo, usando el modo de navegación móvil para páginas públicas generales o el modo snapshot cuando recargar perdería el estado autenticado.

  2. 02
    Localizar el componente que falla

    Use los nodos fallidos de la auditoría para señalar el componente o la plantilla concretos, en lugar de hacer grep en todo el repositorio en busca de patrones genéricos.

  3. 03
    Inspeccionar el árbol de accesibilidad

    Lea una instantánea renderizada del árbol de accesibilidad para comprobar nombres, roles, estados, landmarks y estructura de encabezados, y después recorra el flujo afectado con el teclado.

  4. 04
    Corregir el código fuente y volver a verificar

    Cambie el código fuente y no el resultado renderizado, y luego repita la misma auditoría y la misma interacción manual para confirmar la corrección.

  5. 05
    Recurrir a las herramientas de CLI

    Cuando no haya herramientas de navegador en vivo disponibles, combine la salida de Lighthouse CLI o axe con las mismas comprobaciones manuales, porque la automatización por sí sola solo cubre parte de las barreras.

02 Encuentra tu caso de uso

Cuándo usar el Skill accessibility

Use el skill de accessibility en Claude Code o Codex cuando el trabajo sea una revisión de diseño de este tipo. La idoneidad y los límites a continuación se toman del propio archivo del skill.

Buen caso de uso

  • Una solicitud formulada como auditoría de a11y, trabajo de cumplimiento de WCAG, compatibilidad con lectores de pantalla, navegación por teclado o «hacer accesible».
  • Equipos que apuntan al nivel AA, que el archivo trata como objetivo estándar y requisito legal en muchas jurisdicciones.
  • Páginas en las que los encabezados o pies de página fijos se tragan el anillo de foco del teclado, un criterio nuevo en WCAG 2.2.
  • Interfaces que deben ser totalmente operables sin ratón, incluidos los widgets personalizados construidos a partir de elementos no interactivos.

Conozca los límites

  • Los enlaces de texto en línea, el dimensionado controlado por el navegador y los objetivos cuyo círculo de 24px no se superpone a otro objetivo quedan exentos de la regla de tamaño mínimo de objetivo.
  • El nivel AAA se trata como opcional en lugar de como un requisito.
  • Antipatrón que el archivo señala: añadir activación manual por teclado a un botón nativo, lo que provoca una doble activación porque Enter y Espacio ya disparan el clic.

Qué proporcionar

  • Una página renderizadaEl flujo en vivo comienza cuando hay una página renderizada disponible, ya que la auditoría, la lista de nodos y el árbol de accesibilidad proceden de ella.
  • El modo de navegación de la páginaIndique al agente si se trata de una página pública general o de un flujo en el que recargar perdería el estado autenticado o creado por el usuario, porque eso determina el modo de navegación móvil o de instantánea.
  • El flujo de teclado que hay que ejercitarPrepárese para recorrer con el teclado la interacción afectada durante la auditoría, junto con la inspección del árbol de accesibilidad.

03 Dentro del skill

Reglas que el Skill de accesibilidad da a Claude Code y Codex

7 instrucciones concretas, valores predeterminados y límites que el SKILL.md establece para el agente: la parte del archivo que cambia el resultado.

  1. Recurra primero a un elemento nativo

    Los controles nativos de botón, ancla y formulario ya gestionan la activación con Enter/Espacio, el foco y la semántica para tecnologías de asistencia, por lo que la gestión manual del teclado es el último recurso para los elementos que no pueda sustituir.

  2. Mantenga el foco con un estilo visible

    Nunca elimine los contornos.

  3. Respete el mínimo de 24 × 24 en los objetivos

    Los objetivos interactivos deben medir al menos 24 × 24 píxeles CSS en AA, y se recomiendan 44 × 44 como tamaño táctil cómodo para botones, casillas de verificación y etiquetas de botones de opción.

  4. Neutralice la animación cuando se solicite

    Con prefers-reduced-motion, el archivo reduce a 0.01ms las duraciones de animación y transición, limita el recuento de iteraciones a 1 y restablece scroll-behavior a auto.

  5. Nunca transmita información solo con color

    Los estados de error combinan el color con un icono y texto; el marcado empareja aria-invalid="true" con aria-describedby apuntando al elemento del mensaje de error.

  6. Anuncie y enfoque los errores

    Envíe los errores a los lectores de pantalla con role="alert" o aria-live, marque los campos que los provocan y mueva el foco al primer error al enviar.

  7. Mantenga la autenticación con poca carga cognitiva

    Los flujos de inicio de sesión no deben depender de recordar una contraseña ni de resolver un puzle, salvo que funcionen el copiar y pegar o el autorrelleno, exista una alternativa como una clave de acceso o un enlace por correo electrónico, o la prueba utilice reconocimiento de objetos o contenido personal.

04 Ponlo a trabajar

Instalar accessibility en Claude Code o Codex

Un comando npx skills add, luego una primera tarea en tu agente y una lista de verificación para el resultado.

Añadir accessibility a Claude Code, Codex o tu agente

Ejecútelo en su proyecto; el instalador pregunta a qué agente añadirlo.

Terminal
npx skills add https://github.com/addyosmani/web-quality-skills --skill accessibility

Forma genérica del CLI skills para skills/accessibility/SKILL.md; el repositorio puede documentar su propia ruta.

Dale al skill una primera tarea de revisión de diseño

Redactado en los términos del propio skill; sustituya las partes entre corchetes por su material.

Starter prompt
Audit [page URL or route] with Lighthouse and then fix the accessibility problems in the source. The form inputs in [component path] have no programmatically associated labels, the icon buttons have no accessible names, and focus outlines are being removed on [element]. Re-run the same audit afterwards and check keyboard navigation and target sizes.

Fuente: redactado a partir del SKILL.md en los términos del propio skill.

Revisa el primer resultado

Lo que el propio SKILL.md indica que debe ser un resultado correcto:

  • Recorra toda la página con Tab y active los controles con Intro y Espacio.

En OpenDesign, importe accessibility desde el enlace de su SKILL.md: Plugins → Add → Skill → Import from link, y luego selecciónelo en la barra superior.

05 Código abierto, rastreable

Fuente, Licencia y Verificación

De dónde provienen los datos de esta página y cuándo se verificaron por última vez.

Archivo de skill
skills/accessibility/SKILL.md Checksum de contenido registrado en la verificación; commit afa8da9
License
MIT Desde LICENSE; SKILL.md indica "MIT".
Estrellas del repositorio
2.786 Captura de GitHub tomada el 14/09/2026 para todo el repositorio addyosmani/web-quality-skills. No es una calificación ni un recuento de uso para accessibility.
Verificado por OpenDesign
14/09/2026 Se verificaron el archivo fuente, la ruta, el texto de licencia y el recuento de estrellas. No incluido en OpenDesign principal (verificado el 28/08/2026); no se ha registrado una ejecución en vivo en esta página.
La descripción propia del Skill
«Audita y mejora la accesibilidad web siguiendo las pautas WCAG 2.2. Úsalo cuando te pidan "mejorar accesibilidad", "auditoría a11y", "cumplimiento WCAG", "soporte para lectores de pantalla", "navegación por teclado" o "hacer accesible".»

Descripción del front-matter desde SKILL.md. El archivo completo tiene aproximadamente 14.265 caracteres. Lee el archivo completo en GitHub.

Accessibility

Ejecutar accessibility en una tarea real de revisión de diseño.

Descarga OpenDesign, importa accessibility desde su enlace SKILL.md, pega el prompt de arriba y lee el plan antes del resultado.

Terminal
npx skills add https://github.com/addyosmani/web-quality-skills --skill accessibility

OpenDesign Desktop

Un sistema de diseño. Tu marca, coherente en cada resultado

En el Vibe Design Workspace completo, aplica las mismas reglas de marca a sitios web, presentaciones, prototipos interactivos, dashboards, imágenes y vídeo HTML. Conecta Codex, Claude Code, Cursor y otros agentes de código locales y crea gratis.

  • Web, presentaciones, prototipos, dashboards, imágenes y vídeo
  • Más de 140 sistemas de diseño y la biblioteca completa de plantillas y skills
  • Codex local y más de 21 agentes de código · Gratis
Descargar gratis

Disponible para macOS y Windows