Communitygithub.com

ulasalyesil/personal-website-v2

Realiza auditorías de accesibilidad WCAG 2.2 con pruebas automatizadas, verificación manual y guía de corrección. Útil para auditar sitios web, corregir violaciones WCAG o implementar patrones de diseño accesibles.

¿Qué es personal-website-v2?

Este skill proporciona un conjunto completo de patrones y checklist para auditar el contenido web contra los criterios WCAG 2.2 (niveles A, AA, AAA). Incluye desde conceptos fundamentales como los Principios POUR y niveles de conformidad, hasta listas detalladas de verificación por cada principio: Perceptible, Operable, Comprensible y Robusto. También ofrece ejemplos de código (HTML, CSS, JavaScript) para corregir violaciones comunes, como etiquetas de formulario faltantes, contraste insuficiente o navegación por teclado. El skill integra herramientas de prueba automatizadas (axe-core, Pa11y, Lighthouse) y pautas para pruebas manuales. Es ideal para desarrolladores, diseñadores y evaluadores que necesiten preparar informes de accesibilidad, cumplir con ADA/Section 508 o lograr conformidad VPAT.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/wcag-audit-patterns

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

personal-website-v2 preview
personal-website-v2 preview

Documentación

Patrones de Auditoría WCAG

Guía completa para auditar contenido web según las pautas WCAG 2.2 con estrategias de corrección accionables.

Cuándo usar este skill

  • Realizar auditorías de accesibilidad
  • Corregir violaciones WCAG
  • Implementar componentes accesibles
  • Prepararse para demandas de accesibilidad
  • Cumplir con requisitos ADA/Sección 508
  • Lograr conformidad VPAT

Conceptos fundamentales

1. Niveles de conformidad WCAG

NivelDescripciónRequerido para
AAccesibilidad mínimaBase legal
AAConformidad estándarLa mayoría de regulaciones
AAAAccesibilidad mejoradaNecesidades especializadas

2. Principios POUR

Perceptible:  ¿Pueden los usuarios percibir el contenido?
Operable:     ¿Pueden los usuarios operar la interfaz?
Comprensible: ¿Pueden los usuarios comprender el contenido?
Robusto:      ¿Funciona con tecnología de asistencia?

3. Violaciones comunes por impacto

Críticas (Bloqueantes):
├── Falta de texto alternativo en imágenes funcionales
├── Sin acceso por teclado a elementos interactivos
├── Etiquetas de formulario faltantes
└── Multimedia que se reproduce automáticamente sin controles

Graves:
├── Contraste de color insuficiente
├── Enlaces de salto faltantes
├── Widgets personalizados inaccesibles
└── Títulos de página faltantes

Moderadas:
├── Atributo de lenguaje faltante
├── Texto de enlace poco claro
├── Hitos (landmarks) faltantes
└── Jerarquía de encabezados incorrecta

Lista de verificación de auditoría

Perceptible (Principio 1)

## 1.1 Alternativas textuales

### 1.1.1 Contenido no textual (Nivel A)

- [ ] Todas las imágenes tienen texto alternativo
- [ ] Las imágenes decorativas tienen alt=""
- [ ] Las imágenes complejas tienen descripciones largas
- [ ] Los iconos con significado tienen nombres accesibles
- [ ] Los CAPTCHA tienen alternativas

Verificar:

```html
<!-- Correcto -->
<img src="grafico.png" alt="Las ventas aumentaron un 25% del Q1 al Q2" />
<img src="linea-decorativa.png" alt="" />

<!-- Incorrecto -->
<img src="grafico.png" />
<img src="linea-decorativa.png" alt="línea decorativa" />
```

1.2 Medios basados en tiempo

1.2.1 Solo audio y solo video (Nivel A)

  • El audio tiene transcripción textual
  • El video tiene descripción de audio o transcripción

1.2.2 Subtítulos (Nivel A)

  • Todo video tiene subtítulos sincronizados
  • Los subtítulos son precisos y completos
  • Identificación de hablantes incluida

1.2.3 Descripción de audio (Nivel A)

  • El video tiene descripción de audio para contenido visual

1.3 Adaptable

1.3.1 Información y relaciones (Nivel A)

  • Los encabezados usan etiquetas adecuadas (h1-h6)
  • Las listas usan ul/ol/dl
  • Las tablas tienen encabezados
  • Las entradas de formulario tienen etiquetas
  • Los hitos ARIA están presentes

Verificar:

<!-- Jerarquía de encabezados -->
<h1>Título de página</h1>
<h2>Sección</h2>
<h3>Subsección</h3>
<h2>Otra sección</h2>

<!-- Encabezados de tabla -->
<table>
  <thead>
    <tr>
      <th scope="col">Nombre</th>
      <th scope="col">Precio</th>
    </tr>
  </thead>
</table>

1.3.2 Secuencia significativa (Nivel A)

  • El orden de lectura es lógico
  • El posicionamiento CSS no rompe el orden
  • El orden de enfoque coincide con el orden visual

1.3.3 Características sensoriales (Nivel A)

  • Las instrucciones no dependen solo de forma/color
  • "Haz clic en el botón rojo" → "Haz clic en Enviar (botón rojo)"

1.4 Distinguible

1.4.1 Uso del color (Nivel A)

  • El color no es el único medio para transmitir información
  • Los enlaces se distinguen sin color
  • Los estados de error no solo usan color

1.4.3 Contraste (mínimo) (Nivel AA)

  • Texto: relación de contraste 4.5:1
  • Texto grande (18pt+): relación 3:1
  • Componentes de IU: relación 3:1

Herramientas: WebAIM Contrast Checker, axe DevTools

1.4.4 Redimensionar texto (Nivel AA)

  • El texto se redimensiona al 200% sin pérdida
  • Sin desplazamiento horizontal a 320px
  • El contenido se reordena correctamente

1.4.10 Reflujo (Nivel AA)

  • El contenido se reordena al 400% de zoom
  • Sin desplazamiento bidimensional
  • Todo el contenido accesible a 320px de ancho

1.4.11 Contraste de no texto (Nivel AA)

  • Los componentes de IU tienen contraste 3:1
  • Los indicadores de enfoque son visibles
  • Los objetos gráficos se distinguen

1.4.12 Espaciado de texto (Nivel AA)

  • Sin pérdida de contenido con espaciado aumentado
  • Altura de línea 1.5x tamaño de fuente
  • Espaciado de párrafo 2x tamaño de fuente
  • Espaciado entre letras 0.12x tamaño de fuente
  • Espaciado entre palabras 0.16x tamaño de fuente

### Operable (Principio 2)

```markdown
## 2.1 Accesible por teclado

### 2.1.1 Teclado (Nivel A)
- [ ] Toda funcionalidad accesible por teclado
- [ ] Sin trampas de teclado
- [ ] El orden de tabulación es lógico
- [ ] Los widgets personalizados son operables por teclado

Verificar:
```javascript
// El botón personalizado debe ser accesible por teclado
<div role="button" tabindex="0"
     onkeydown="if(event.key === 'Enter' || event.key === ' ') activar()">
```

### 2.1.2 Sin trampa de teclado (Nivel A)

- [ ] El enfoque puede salir de todos los componentes
- [ ] Los diálogos modales capturan el enfoque correctamente
- [ ] El enfoque regresa después de cerrar el modal

## 2.2 Tiempo suficiente

### 2.2.1 Tiempo ajustable (Nivel A)

- [ ] Los tiempos de sesión se pueden extender
- [ ] El usuario es advertido antes del tiempo de espera
- [ ] Opción para deshabilitar la actualización automática

### 2.2.2 Pausar, Detener, Ocultar (Nivel A)

- [ ] El contenido en movimiento se puede pausar
- [ ] El contenido que se actualiza automáticamente se puede pausar
- [ ] Las animaciones respetan prefers-reduced-motion

```css
@media (prefers-reduced-motion: reduce) {
  * {
    animation: none !important;
    transition: none !important;
  }
}
```

## 2.3 Convulsiones y reacciones físicas

### 2.3.1 Tres destellos (Nivel A)

- [ ] Ningún contenido destella más de 3 veces/segundo
- [ ] El área de destello es pequeña (<25% del viewport)

## 2.4 Navegable

### 2.4.1 Omitir bloques (Nivel A)

- [ ] Enlace para saltar al contenido principal presente
- [ ] Regiones de hito (landmark) definidas
- [ ] Estructura de encabezados adecuada

```html
<a href="#main" class="skip-link">Saltar al contenido principal</a>
<main id="main">...</main>
```

### 2.4.2 Página con título (Nivel A)

- [ ] Títulos de página únicos y descriptivos
- [ ] El título refleja el contenido de la página

### 2.4.3 Orden de enfoque (Nivel A)

- [ ] El orden de enfoque coincide con el orden visual
- [ ] tabindex usado correctamente

### 2.4.4 Propósito del enlace (en contexto) (Nivel A)

- [ ] Los enlaces tienen sentido fuera de contexto
- [ ] Sin "haz clic aquí" o "leer más" solos

```html
<!-- Incorrecto -->
<a href="reporte.pdf">Haz clic aquí</a>

<!-- Correcto -->
<a href="reporte.pdf">Descargar Reporte de Ventas Q4 (PDF)</a>
```

### 2.4.6 Encabezados y etiquetas (Nivel AA)

- [ ] Los encabezados describen el contenido
- [ ] Las etiquetas describen el propósito

### 2.4.7 Enfoque visible (Nivel AA)

- [ ] Indicador de enfoque visible en todos los elementos
- [ ] Los estilos de enfoque personalizados cumplen con el contraste

```css
:focus {
  outline: 3px solid #005fcc;
  outline-offset: 2px;
}
```

### 2.4.11 Enfoque no oscurecido (Nivel AA) - WCAG 2.2

- [ ] El elemento enfocado no está completamente oculto
- [ ] Los encabezados fijos no ocultan el enfoque
```

### Comprensible (Principio 3)

```markdown
## 3.1 Legible

### 3.1.1 Idioma de la página (Nivel A)
- [ ] Atributo lang de HTML establecido
- [ ] Idioma correcto para el contenido

```html
<html lang="es">
```

### 3.1.2 Idioma de las partes (Nivel AA)

- [ ] Cambios de idioma marcados

```html
<p>La palabra francesa <span lang="fr">bonjour</span> significa hola.</p>
```

## 3.2 Predecible

### 3.2.1 Al recibir el enfoque (Nivel A)

- [ ] Sin cambio de contexto solo por enfoque
- [ ] Sin ventanas emergentes inesperadas al enfocar

### 3.2.2 Al ingresar datos (Nivel A)

- [ ] Sin envío automático de formularios
- [ ] Usuario advertido antes de un cambio de contexto

### 3.2.3 Navegación consistente (Nivel AA)

- [ ] Navegación consistente en todas las páginas
- [ ] Componentes repetidos en el mismo orden

### 3.2.4 Identificación consistente (Nivel AA)

- [ ] Misma funcionalidad = misma etiqueta
- [ ] Iconos usados de manera consistente

## 3.3 Asistencia para la entrada de datos

### 3.3.1 Identificación de errores (Nivel A)

- [ ] Errores claramente identificados
- [ ] El mensaje de error describe el problema
- [ ] Error vinculado al campo

```html
<input aria-describedby="email-error" aria-invalid="true" />
<span id="email-error" role="alert">Por favor ingresa un correo electrónico válido</span>
```

### 3.3.2 Etiquetas o instrucciones (Nivel A)

- [ ] Todas las entradas tienen etiquetas visibles
- [ ] Campos obligatorios indicados
- [ ] Sugerencias de formato proporcionadas

### 3.3.3 Sugerencia de error (Nivel AA)

- [ ] Los errores incluyen sugerencia de corrección
- [ ] Las sugerencias son específicas

### 3.3.4 Prevención de errores (Nivel AA)

- [ ] Formularios legales/financieros reversibles
- [ ] Datos verificados antes del envío
- [ ] Usuario puede revisar antes de enviar

Robusto (Principio 4)

## 4.1 Compatible

### 4.1.1 Procesamiento (Nivel A) - Obsoleto en WCAG 2.2
- [ ] HTML válido (buena práctica)
- [ ] Sin IDs duplicados
- [ ] Etiquetas de apertura/cierre completas

### 4.1.2 Nombre, rol, valor (Nivel A)
- [ ] Los widgets personalizados tienen nombres accesibles
- [ ] Roles ARIA correctos
- [ ] Los cambios de estado se anuncian

```html
<!-- Casilla de verificación personalizada accesible -->
<div role="checkbox"
     aria-checked="false"
     tabindex="0"
     aria-labelledby="label">
</div>
<span id="label">Aceptar términos</span>

4.1.3 Mensajes de estado (Nivel AA)

  • Las actualizaciones de estado se anuncian
  • Las regiones en vivo se usan correctamente
<div role="status" aria-live="polite">3 artículos agregados al carrito</div>

<div role="alert" aria-live="assertive">Error: El envío del formulario falló</div>

## Pruebas automatizadas

```javascript
// Integración con axe-core
const axe = require('axe-core');

async function ejecutarAuditoriaAccesibilidad(page) {
  await page.addScriptTag({ path: require.resolve('axe-core') });

  const results = await page.evaluate(async () => {
    return await axe.run(document, {
      runOnly: {
        type: 'tag',
        values: ['wcag2a', 'wcag2aa', 'wcag21aa', 'wcag22aa']
      }
    });
  });

  return {
    violations: results.violations,
    passes: results.passes,
    incomplete: results.incomplete
  };
}

// Ejemplo de prueba con Playwright
test('no debe tener violaciones de accesibilidad', async ({ page }) => {
  await page.goto('/');
  const results = await ejecutarAuditoriaAccesibilidad(page);

  expect(results.violations).toHaveLength(0);
});
```

```bash
# Herramientas CLI
npx @axe-core/cli https://example.com
npx pa11y https://example.com
lighthouse https://example.com --only-categories=accessibility
```

## Patrones de corrección

### Corrección: Etiquetas de formulario faltantes

```html
<!-- Antes -->
<input type="email" placeholder="Correo electrónico" />

<!-- Después: Opción 1 - Etiqueta visible -->
<label for="email">Dirección de correo electrónico</label>
<input id="email" type="email" />

<!-- Después: Opción 2 - aria-label -->
<input type="email" aria-label="Dirección de correo electrónico" />

<!-- Después: Opción 3 - aria-labelledby -->
<span id="email-label">Correo electrónico</span>
<input type="email" aria-labelledby="email-label" />
```

### Corrección: Contraste de color insuficiente

```css
/* Antes: 2.5:1 de contraste */
.text {
  color: #767676;
}

/* Después: 4.5:1 de contraste */
.text {
  color: #595959;
}

/* O agregar fondo */
.text {
  color: #767676;
  background: #000;
}
```

### Corrección: Navegación por teclado

```javascript
// Hacer que un elemento personalizado sea accesible por teclado
class DropdownAccesible extends HTMLElement {
  connectedCallback() {
    this.setAttribute("tabindex", "0");
    this.setAttribute("role", "combobox");
    this.setAttribute("aria-expanded", "false");

    this.addEventListener("keydown", (e) => {
      switch (e.key) {
        case "Enter":
        case " ":
          this.alternar();
          e.preventDefault();
          break;
        case "Escape":
          this.cerrar();
          break;
        case "ArrowDown":
          this.enfocarSiguiente();
          e.preventDefault();
          break;
        case "ArrowUp":
          this.enfocarAnterior();
          e.preventDefault();
          break;
      }
    });
  }
}
```

## Buenas prácticas

### Hacer

- **Empezar temprano** - Accesibilidad desde la fase de diseño
- **Probar con usuarios reales** - Los usuarios con discapacidad brindan la mejor retroalimentación
- **Automatizar lo que puedas** - 30-50% de los problemas detectables
- **Usar HTML semántico** - Reduce la necesidad de ARIA
- **Documentar patrones** - Construir una biblioteca de componentes accesibles

### No hacer

- **No confiar solo en pruebas automatizadas** - Se requieren pruebas manuales
- **No usar ARIA como primera solución** - Priorizar HTML nativo
- **No ocultar los contornos de enfoque** - Los usuarios de teclado los necesitan
- **No deshabilitar el zoom** - Los usuarios necesitan redimensionar
- **No usar solo color** - Se necesitan múltiples indicadores

## Recursos

- [Pautas WCAG 2.2](https://www.w3.org/TR/WCAG22/)
- [WebAIM](https://webaim.org/)
- [Lista de verificación del Proyecto A11y](https://www.a11yproject.com/checklist/)
- [axe DevTools](https://www.deque.com/axe/)

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Skills relacionados