Communitygithub.com

Accesibilidad

Revisa y mejora la accesibilidad web para usuarios de teclado, lectores de pantalla, contraste, semántica, formularios e interfaces responsivas. Úsalo cuando el usuario solicite una auditoría de accesibilidad, revisión WCAG o quiera que una interfaz sea utilizable por más personas.

¿Qué es Accesibilidad?

Esta habilidad está diseñada para ayudar a desarrolladores y agentes de IA a realizar auditorías de accesibilidad web completas. Se centra en garantizar que las interfaces sean utilizables sin mouse, sin visión perfecta y sin paciencia para la ambigüedad. La habilidad guía al usuario a través de un proceso estructurado que incluye la definición del ámbito, la verificación de fundamentos como semántica, navegación por teclado, formularios, imágenes, contraste y contenido dinámico, y finalmente la realización de pruebas. Es compatible con plataformas como Claude Code, Cursor y Codex, y se activa mediante palabras clave como "accesibilidad", "a11y", "WCAG", "доступность", "скринридер", "клавиатура" y "контраст". La habilidad proporciona un formato de salida claro y reglas estrictas para evitar errores comunes, como afirmar cumplimiento total de WCAG solo con escaneos automatizados o usar `aria-*` para corregir una mala semántica.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hydroimperium/ai-skills/tree/HEAD/skills/design/accessibility

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Accesibilidad?

Haz que la interfaz sea utilizable sin mouse, sin visión perfecta y sin paciencia para la ambigüedad.

Cuándo usar

Úsalo cuando el usuario:

  • quiera una revisión de accesibilidad;
  • esté construyendo formularios, navegación, modales o componentes interactivos;
  • necesite orientación sobre WCAG;
  • quiera soporte para teclado o lector de pantalla;
  • pregunte sobre contraste o estados de enfoque.

1. Definir el ámbito

  • ¿Qué páginas o componentes?
  • ¿Qué grupos de usuarios y tecnologías de asistencia importan?
  • ¿Qué estándar aplica: WCAG 2.2 AA, política interna, requisito legal?
  • ¿Qué queda fuera del alcance?

2. Verificar lo básico

Semántica

  • Utiliza elementos nativos: button, a, input, label, nav, main.
  • No uses un div como botón.
  • Usa encabezados en orden.
  • Proporciona nombres accesibles a puntos de referencia y secciones.

Teclado

  • Cada elemento interactivo es accesible con Tab.
  • El orden de enfoque coincide con el orden visual.
  • El enfoque es visible.
  • No hay trampas de teclado.
  • Escape cierra los modales.
  • Las teclas de flecha funcionan en menús, pestañas y rejillas donde se espera.

Formularios

  • Cada entrada tiene una etiqueta.
  • Los errores se anuncian y se vinculan al campo.
  • Los campos obligatorios están marcados en texto, no solo con color.
  • Se usa autocompletar cuando corresponda.
  • Las instrucciones vienen antes del campo.

Imágenes y medios

  • Las imágenes significativas tienen texto alternativo.
  • Las imágenes decorativas tienen texto alternativo vacío.
  • El video tiene subtítulos.
  • El audio tiene una transcripción.
  • Ninguna información se transmite solo mediante color.

Contraste y texto

  • El contraste del texto cumple con WCAG AA.
  • El texto se puede redimensionar al 200% sin pérdida.
  • La longitud de línea y el espaciado son legibles.
  • El contenido se reajusta a 320 píxeles.

Contenido dinámico

  • Los estados de carga se anuncian.
  • Los mensajes y alertas utilizan regiones activas adecuadas.
  • Los modales gestionan el enfoque.
  • Los cambios de ruta del lado del cliente actualizan el título y el enfoque.

3. Probar

  • Recorrido solo con teclado.
  • Prueba rápida con lector de pantalla si está disponible.
  • Zoom al 200%.
  • Modo de alto contraste.
  • Movimiento reducido.
  • Verificaciones automatizadas, con la comprensión de que solo detectan parte del problema.

Formato de salida

## Ámbito

## Hallazgos

### <severidad>: <problema>

- **Ubicación:** `<ruta o componente>`
- **WCAG:** <criterio>
- **Impacto:** <quién está bloqueado y cómo>
- **Solución:** <cambio específico>
- **Verificación:** <cómo probar>

## Lo que funciona

## No probado

## Prioridad

1. ...

Reglas

  • No afirmar cumplimiento total de WCAG con un escaneo automatizado.
  • No usar aria-* para corregir mala semántica.
  • No eliminar contornos de enfoque sin un reemplazo visible.
  • No depender solo del color.
  • No añadir una clase solo para lectores de pantalla como sustituto de una etiqueta.
  • Si la revisión es parcial, indicar qué no se probó.

Verificaciones de calidad

  • Se utilizan semánticas nativas.
  • El acceso por teclado funciona.
  • El enfoque es visible.
  • Los formularios tienen etiquetas y errores.
  • El contraste es suficiente.
  • El contenido dinámico se anuncia.
  • La revisión indica qué no se probó.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills relacionados