Back to list
vjrivmon

wcag-perceivable

by vjrivmon

Sistema de orquestación de agentes para Claude Code - Transforma ideas en MVPs funcionales

1🍴 0📅 Jan 24, 2026

SKILL.md


name: wcag-perceivable description: Principio 1 de WCAG - contenido perceptible por todos los usuarios. Use cuando diseñe contenido multimedia, imágenes, o cualquier información visual o auditiva. metadata: author: ux-ui-skills version: "1.0" category: accessibility

WCAG: Perceptible

Resumen

El primer principio de WCAG establece que la información y los componentes de la interfaz deben ser presentados de manera que los usuarios puedan percibirlos. No puede ser invisible a todos sus sentidos.

Origen

  • Organización: W3C (World Wide Web Consortium)
  • Documento: Web Content Accessibility Guidelines
  • Versión actual: WCAG 2.1 / 2.2
  • Niveles: A (mínimo), AA (recomendado), AAA (óptimo)

Directrices

1.1 Alternativas de Texto

  • Todas las imágenes deben tener alt text
  • Imágenes decorativas: alt=""
  • Imágenes informativas: descripción del contenido
  • Imágenes complejas: descripción extendida
<!-- Informativa -->
<img src="chart.png" alt="Ventas Q1 2024: $1.2M, +15% vs Q1 2023" />

<!-- Decorativa -->
<img src="divider.png" alt="" role="presentation" />

<!-- Compleja -->
<img src="diagram.png" alt="Diagrama de flujo" aria-describedby="desc" />
<div id="desc">Descripción completa del diagrama...</div>

1.2 Medios Basados en Tiempo

  • Video: captions y transcripciones
  • Audio: transcripciones
  • Video en vivo: captions en tiempo real
  • Audio descripción para ciegos

1.3 Adaptable

  • Contenido debe poder presentarse de diferentes formas
  • Estructura semántica correcta (headings, lists, tables)
  • Secuencia de lectura significativa
  • No depender solo de características sensoriales
<!-- Malo -->
<div class="big-text">Título</div>

<!-- Bueno -->
<h1>Título</h1>

1.4 Distinguible

  • Contraste de color suficiente
  • No usar solo color para transmitir información
  • Audio controlable por el usuario
  • Texto redimensionable
  • Texto como texto, no imágenes

Criterios de Éxito Clave

Contraste de Color

  • AA: 4.5:1 para texto normal, 3:1 para texto grande
  • AAA: 7:1 para texto normal, 4.5:1 para texto grande
  • Texto grande: ≥18pt o ≥14pt bold

Herramientas de Verificación

  • WebAIM Contrast Checker
  • axe DevTools
  • WAVE
  • Lighthouse

Aplicación Práctica

Imágenes

  • Alt text descriptivo y conciso
  • Describir función, no apariencia
  • "Botón de búsqueda" no "Lupa azul"
  • Evitar "imagen de..."

Video

  • Captions sincronizados
  • Transcripción completa
  • Audio descripción cuando necesario
  • Controles accesibles

Formularios

  • Labels asociados a inputs
  • Errores no solo por color
  • Instrucciones claras
  • Mensajes de error descriptivos

Color

  • Indicadores adicionales (iconos, texto)
  • Patrones además de colores en gráficos
  • No "haga click en el botón rojo"

Ejemplos

  • YouTube: Captions automáticos y manuales
  • GitHub: Alt text requerido en issues
  • Stripe Docs: Excelente contraste y estructura
  • Gov.uk: Modelo de accesibilidad

Anti-patterns

  • ❌ Imágenes de texto
  • ❌ Videos sin captions
  • ❌ Solo color para indicar estado
  • ❌ Contraste insuficiente
  • ❌ Alt text genérico ("imagen" o vacío incorrecto)

Métricas

  • Automated Audit Score: Lighthouse, axe
  • Manual Review: Checklist WCAG
  • Contrast Ratio: Todas las combinaciones de color
  • Screen Reader Testing: Navegación con NVDA/VoiceOver

Principios Relacionados

  • [[wcag-operable]] - Siguiente principio WCAG
  • [[universal-design]] - Diseño para todos
  • [[inclusive-design]] - Considerar diversidad

Referencias

Score

Total Score

65/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon