Communitygithub.com

ComeOnOliver/skillshub

Revisa componentes de UI para cumplimiento con WCAG, atributos ARIA, navegación por teclado y soporte para lectores de pantalla. Úsalo al construir componentes frontend o cuando un usuario solicite mejoras de accesibilidad.

¿Qué es skillshub?

Esta habilidad, llamada 'Accessibility Auditor', está diseñada para auditar aplicaciones web en busca de cumplimiento con las pautas de accesibilidad WCAG 2.1 Nivel AA y sugerir mejoras. Es útil para desarrolladores frontend, diseñadores de UI y QA que necesitan garantizar que sus componentes sean accesibles para personas con discapacidades. La habilidad cubre desde revisiones de semántica HTML y atributos ARIA hasta navegación por teclado, texto alternativo en imágenes, contraste de color, etiquetado de formularios, estructura de encabezados, contenido dinámico, pruebas con lectores de pantalla y herramientas automatizadas como axe, Lighthouse y pa11y. Se activa cuando se construyen o revisan componentes de UI, o cuando el usuario menciona términos como 'accesibilidad', 'a11y', 'WCAG', 'lector de pantalla' o 'navegación por teclado'. La habilidad proporciona instrucciones detalladas y ejemplos de código en HTML, CSS y JavaScript, así como una lista de verificación completa de WCAG 2.1 AA, lo que la convierte en una guía práctica y completa para integrar la accesibilidad desde el inicio del desarrollo.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/crazydubya/accessibility-auditor

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

skillshub preview
skillshub preview
skillshub preview

Documentación

Auditor de Accesibilidad

Audita aplicaciones web para verificar el cumplimiento con las pautas de accesibilidad (WCAG 2.1 Nivel AA) y sugiere mejoras.

Cuándo Usarlo

  • Al construir o revisar componentes de UI
  • Cuando un usuario solicita mejoras de accesibilidad
  • Al prepararse para una auditoría de accesibilidad
  • Cuando el usuario menciona "accesibilidad", "a11y", "WCAG", "lector de pantalla" o "navegación por teclado"

Instrucciones

1. Verificación de HTML Semántico

Usa elementos HTML adecuados:

<!-- Malo -->
<div onclick="submit()">Enviar</div>

<!-- Bueno -->
<button onclick="submit()">Enviar</button>

Estructura semántica:

  • <header>, <nav>, <main>, <footer>
  • <article>, <section>, <aside>
  • <h1> a <h6> en jerarquía adecuada
  • <button> para acciones, <a> para navegación

2. Atributos ARIA

Cuándo usar ARIA:

  • Widgets personalizados (pestañas, acordeones, modales)
  • Actualizaciones de contenido dinámico
  • Interacciones complejas
  • Cuando el HTML semántico no es suficiente

Atributos ARIA comunes:

<!-- Roles de punto de referencia -->
<nav role="navigation" aria-label="Principal">

<!-- Roles de widget -->
<div role="button" tabindex="0" aria-pressed="false">

<!-- Regiones vivas -->
<div role="alert" aria-live="assertive">Ocurrió un error</div>

<!-- Etiquetas y descripciones -->
<button aria-label="Cerrar diálogo">×</button>
<input aria-describedby="ayuda-contraseña" />

Primera regla de ARIA: No uses ARIA si el HTML semántico funciona

3. Navegación por Teclado

Todos los elementos interactivos deben ser accesibles por teclado:

// Agregar soporte de teclado a elementos personalizados
<div
  role="button"
  tabindex="0"
  onClick={handleClick}
  onKeyDown={(e) => {
    if (e.key === 'Enter' || e.key === ' ') {
      handleClick();
    }
  }}
>
  Haz clic aquí
</div>

Orden de tabulación:

  • Usa tabindex="0" para elementos interactivos personalizados
  • Evita tabindex > 0 (crea un orden de tabulación confuso)
  • Usa tabindex="-1" solo para enfoque programático

Gestión del enfoque:

  • Indicadores de enfoque visibles
  • Atrapar el enfoque en modales
  • Devolver el enfoque al cerrar diálogos
  • Enlaces de salto al contenido principal

4. Texto Alternativo e Imágenes

Imágenes informativas:

<img src="grafico.png" alt="Las ventas aumentaron un 25% en el tercer trimestre" />

Imágenes decorativas:

<img src="decoracion.png" alt="" />
<!-- o -->
<img src="decoracion.png" role="presentation" />

Imágenes complejas:

<figure>
  <img src="grafico-complejo.png" alt="Gráfico de ventas trimestral" />
  <figcaption>
    Descripción detallada de los datos del gráfico...
  </figcaption>
</figure>

5. Color y Contraste

Relaciones de contraste (WCAG AA):

  • Texto normal: mínimo 4.5:1
  • Texto grande (18pt+): mínimo 3:1
  • Componentes de UI: mínimo 3:1

No confíes solo en el color:

<!-- Malo: Solo color -->
<span style="color: red;">Error</span>

<!-- Bueno: Icono + color -->
<span style="color: red;">
  <svg aria-hidden="true"><!-- icono de error --></svg>
  <span class="sr-only">Error: </span>
  Entrada no válida
</span>

6. Formularios y Etiquetas

Cada entrada necesita una etiqueta:

<!-- Etiqueta explícita -->
<label for="email">Correo electrónico</label>
<input id="email" type="email" />

<!-- Etiqueta implícita -->
<label>
  Correo electrónico
  <input type="email" />
</label>

<!-- aria-label para botones de icono -->
<button aria-label="Buscar">
  <svg><!-- icono de búsqueda --></svg>
</button>

Mensajes de error:

<input
  id="contraseña"
  aria-invalid="true"
  aria-describedby="error-contraseña"
/>
<div id="error-contraseña" role="alert">
  La contraseña debe tener al menos 8 caracteres
</div>

7. Encabezados y Estructura del Documento

Jerarquía adecuada de encabezados:

<h1>Título de la Página</h1>
  <h2>Sección 1</h2>
    <h3>Subsección 1.1</h3>
    <h3>Subsección 1.2</h3>
  <h2>Sección 2</h2>

No saltes niveles: h1 → h2 → h3 (no h1 → h3)

8. Contenido Dinámico

Anuncia actualizaciones a los lectores de pantalla:

<!-- Cortés: esperar a que el usuario haga una pausa -->
<div role="status" aria-live="polite">
  5 mensajes nuevos
</div>

<!-- Asertivo: interrumpir de inmediato -->
<div role="alert" aria-live="assertive">
  Tu sesión expirará en 1 minuto
</div>

Estados de carga:

<button aria-busy="true" aria-label="Cargando...">
  <span aria-hidden="true">Cargando</span>
</button>

9. Pruebas con Lectores de Pantalla

Texto solo para lectores de pantalla:

.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border-width: 0;
}

Oculta elementos decorativos:

<svg aria-hidden="true"><!-- icono --></svg>

10. Problemas Comunes a Revisar

Faltantes:

  • Texto alternativo en imágenes
  • Etiquetas en entradas de formulario
  • Jerarquía adecuada de encabezados
  • Indicadores de enfoque de teclado
  • Etiquetas ARIA en botones de icono

Inadecuados:

  • Texto con bajo contraste
  • Marcado no semántico (divs como botones)
  • Gestión de enfoque ausente en modales
  • Trampas de teclado
  • Reproducción automática de medios

Pruebas:

  • Navegación solo con teclado
  • Lector de pantalla (NVDA, JAWS, VoiceOver)
  • Simulación de daltonismo
  • Zoom al 200%
  • Herramientas automatizadas (axe, Lighthouse)

11. Pruebas Automatizadas

Herramientas:

# Lighthouse
npx lighthouse https://example.com --only-categories=accessibility

# axe-core
npm install --save-dev @axe-core/cli
npx axe https://example.com

# pa11y
npm install --save-dev pa11y
npx pa11y https://example.com

En pruebas:

import { axe } from 'jest-axe';

test('no debe tener violaciones de accesibilidad', async () => {
  const { container } = render(<MyComponent />);
  const results = await axe(container);
  expect(results).toHaveNoViolations();
});

12. Lista de Verificación WCAG 2.1 Nivel AA

Perceptible:

  • Alternativas textuales para contenido no textual
  • Subtítulos para audio/video
  • Contenido adaptable (marcado semántico)
  • Contraste de color suficiente

Operable:

  • Accesible por teclado
  • Sin trampas de teclado
  • Límites de tiempo adecuados (ajustables)
  • Sin parpadeos que induzcan convulsiones
  • Enlaces para saltar navegación
  • Títulos de página descriptivos
  • El orden de enfoque tiene sentido
  • Propósito del enlace claro desde el contexto

Comprensible:

  • Idioma de la página especificado (<html lang="es">)
  • Navegación predecible
  • Asistencia en la entrada (etiquetas, instrucciones, mensajes de error)

Robusto:

  • HTML válido
  • Nombre, rol y valor para widgets personalizados
  • Compatible con tecnologías de asistencia

Mejores Prácticas

  • Construye la accesibilidad desde el principio
  • Prueba con tecnologías de asistencia reales
  • Usa HTML semántico primero, ARIA después
  • Mantén una estructura de documento lógica
  • Proporciona múltiples formas de acceder al contenido
  • Prueba la navegación por teclado a fondo
  • No deshabilites el zoom
  • Usa puntos de referencia y encabezados

Archivos de Apoyo

  • reference/wcag-checklist.md: Lista de verificación completa de WCAG 2.1 AA
  • reference/aria-patterns.md: Patrones comunes de widgets ARIA

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados