Communitygithub.com

WCAG-Audit-Muster

Führen Sie WCAG 2.2-Barrierfreiheitsaudits mit automatisierten Tests, manueller Überprüfung und Sanierungsanleitung durch. Verwenden Sie dies bei der Überprüfung von Websites auf Barrierefreiheit, der Behebung von WCAG-Verstößen oder der Implementierung barrierefreier Designmuster.

Was ist WCAG-Audit-Muster?

Dieses Skill definiert einen umfassenden Ansatz für WCAG 2.2-Audits mit strukturierten Checklisten, Code-Mustern und Sanierungsstrategien. Es deckt die vier POUR-Prinzipien (Wahrnehmbar, Bedienbar, Verständlich, Robust) ab und bietet detaillierte Prüfpunkte für jedes Erfolgskriterium, von Niveau A bis AA. Das Skill enthält automatisierte Testbeispiele mit axe-core und Playwright, sowie Befehlszeilen-Tools wie @axe-core/cli und pa11y. Es bietet Sanierungsmuster für häufige Probleme wie fehlende Formularbeschriftungen, unzureichenden Farbkontrast und Tastaturnavigation. Ziel ist es, Entwickler mit einem detaillierten Audit-Leitfaden zu unterstützen, der sowohl für juristische Anforderungen (ADA, Section 508, VPAT) als auch für praktische barrierefreie Entwicklung geeignet ist. Die Plattformen sind browserbasierte Webanwendungen und Softwareentwicklungstools. Es funktioniert durch die Bereitstellung von Markdown-Checklisten, konsistenten Code-Beispielen und automatisierbaren Testskripten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

WCAG-Audit-Muster preview
WCAG-Audit-Muster preview

Dokumentation

Was macht WCAG-Audit-Muster?

Umfassender Leitfaden zur Überprüfung von Webinhalten gemäß WCAG 2.2 mit umsetzbaren Sanierungsstrategien.

Wann dieses Skill verwenden

  • Durchführung von Barrierefreiheitsaudits
  • Behebung von WCAG-Verstößen
  • Implementierung barrierefreier Komponenten
  • Vorbereitung auf Klagen wegen fehlender Barrierefreiheit
  • Erfüllung von ADA/Section 508-Anforderungen
  • Erreichung der VPAT-Konformität

Kernkonzepte

1. WCAG-Konformitätsstufen

StufeBeschreibungErforderlich für
AMinimale BarrierefreiheitRechtliche Basis
AAStandardkonformitätDie meisten Vorschriften
AAAErweiterte BarrierefreiheitSpezielle Anforderungen

2. POUR-Prinzipien

Wahrnehmbar:  Können Nutzer die Inhalte wahrnehmen?
Bedienbar:     Können Nutzer die Oberfläche bedienen?
Verständlich:  Können Nutzer die Inhalte verstehen?
Robust:        Funktioniert es mit assistiven Technologien?

3. Häufige Verstöße nach Auswirkung

Kritisch (Blocker):
├── Fehlender Alternativtext für funktionale Bilder
├── Kein Tastaturzugriff auf interaktive Elemente
├── Fehlende Formularbeschriftungen
└── Automatisch abgespielte Medien ohne Steuerelemente

Schwerwiegend:
├── Unzureichender Farbkontrast
├── Fehlende Skip-Links
├── Nicht zugängliche benutzerdefinierte Widgets
└── Fehlende Seitentitel

Mäßig:
├── Fehlendes Sprachattribut
├── Unklarer Linktext
├── Fehlende landmarks
└── Fehlerhafte Überschriftenhierarchie

Audit-Checkliste

Wahrnehmbar (Prinzip 1)

## 1.1 Textalternativen

### 1.1.1 Nicht-Text-Inhalt (Niveau A)

- [ ] Alle Bilder haben Alternativtext
- [ ] Dekorative Bilder haben alt=""
- [ ] Komplexe Bilder haben lange Beschreibungen
- [ ] Symbole mit Bedeutung haben zugängliche Namen
- [ ] CAPTCHAs haben Alternativen

Prüfung:

```html
<!-- Gut -->
<img src="chart.png" alt="Umsatz stieg um 25% von Q1 auf Q2" />
<img src="decorative-line.png" alt="" />

<!-- Schlecht -->
<img src="chart.png" />
<img src="decorative-line.png" alt="dekorative Linie" />
```

1.2 Zeitbasierte Medien

1.2.1 Nur-Audio und Nur-Video (Niveau A)

  • Audio hat Texttranskript
  • Video hat Audiobeschreibung oder Transkript

1.2.2 Untertitel (Niveau A)

  • Alle Videos haben synchronisierte Untertitel
  • Untertitel sind genau und vollständig
  • Sprecheridentifikation enthalten

1.2.3 Audiobeschreibung (Niveau A)

  • Video hat Audiobeschreibung für visuelle Inhalte

1.3 Anpassbar

1.3.1 Info und Beziehungen (Niveau A)

  • Überschriften verwenden korrekte Tags (h1-h6)
  • Listen verwenden ul/ol/dl
  • Tabellen haben Kopfzeilen
  • Formulareingaben haben Beschriftungen
  • ARIA-Landmarken vorhanden

Prüfung:

<!-- Überschriftenhierarchie -->
<h1>Seitentitel</h1>
<h2>Abschnitt</h2>
<h3>Unterabschnitt</h3>
<h2>Weiterer Abschnitt</h2>

<!-- Tabellenkopfzeilen -->
<table>
  <thead>
    <tr>
      <th scope="col">Name</th>
      <th scope="col">Preis</th>
    </tr>
  </thead>
</table>

1.3.2 Sinnvolle Reihenfolge (Niveau A)

  • Lesereihenfolge ist logisch
  • CSS-Positionierung unterbricht Reihenfolge nicht
  • Fokusreihenfolge entspricht visueller Reihenfolge

1.3.3 Sensorische Merkmale (Niveau A)

  • Anweisungen verlassen sich nicht nur auf Form/Farbe
  • „Klicken Sie auf den roten Button" → „Klicken Sie auf Senden (roter Button)"

1.4 Unterscheidbar

1.4.1 Verwendung von Farbe (Niveau A)

  • Farbe ist nicht das einzige Mittel zur Informationsvermittlung
  • Links ohne Farbe unterscheidbar
  • Fehlerzustände nicht nur farblich

1.4.3 Kontrast (Minimum) (Niveau AA)

  • Text: 4,5:1 Kontrastverhältnis
  • Großer Text (18pt+): 3:1 Verhältnis
  • UI-Komponenten: 3:1 Verhältnis

Tools: WebAIM Kontrastprüfer, axe DevTools

1.4.4 Textgröße ändern (Niveau AA)

  • Text auf 200% ohne Verlust vergrößerbar
  • Kein horizontales Scrollen bei 320px
  • Inhalte fließen korrekt um

1.4.10 Umfluss (Niveau AA)

  • Inhalte fließen bei 400% Zoom um
  • Kein zweidimensionales Scrollen
  • Alle Inhalte bei 320px Breite zugänglich

1.4.11 Nicht-Text-Kontrast (Niveau AA)

  • UI-Komponenten haben 3:1 Kontrast
  • Fokusindikatoren sichtbar
  • Grafische Objekte unterscheidbar

1.4.12 Textabstand (Niveau AA)

  • Kein Inhaltsverlust bei erhöhtem Abstand
  • Zeilenabstand 1,5x Schriftgröße
  • Absatzabstand 2x Schriftgröße
  • Zeichenabstand 0,12x Schriftgröße
  • Wortabstand 0,16x Schriftgröße

### Bedienbar (Prinzip 2)

```markdown
## 2.1 Tastaturzugänglich

### 2.1.1 Tastatur (Niveau A)
- [ ] Alle Funktionen per Tastatur zugänglich
- [ ] Keine Tastaturfallen
- [ ] Tab-Reihenfolge ist logisch
- [ ] Benutzerdefinierte Widgets tastaturbedienbar

Prüfung:
```javascript
// Benutzerdefinierter Button muss tastaturzugänglich sein
<div role="button" tabindex="0"
     onkeydown="if(event.key === 'Enter' || event.key === ' ') activate()">
```

### 2.1.2 Keine Tastaturfalle (Niveau A)

- [ ] Fokus kann von allen Komponenten weg bewegt werden
- [ ] Modale Dialoge sperren Fokus korrekt
- [ ] Fokus kehrt nach Schließen des Modals zurück

## 2.2 Ausreichend Zeit

### 2.2.1 Zeitbegrenzung anpassbar (Niveau A)

- [ ] Sitzungszeitüberschreitungen können verlängert werden
- [ ] Benutzer wird vor Zeitablauf gewarnt
- [ ] Option zum Deaktivieren der automatischen Aktualisierung

### 2.2.2 Pausieren, Stoppen, Ausblenden (Niveau A)

- [ ] Bewegte Inhalte können pausiert werden
- [ ] Automatisch aktualisierte Inhalte können pausiert werden
- [ ] Animationen respektieren prefers-reduced-motion

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

## 2.3 Anfälle und körperliche Reaktionen

### 2.3.1 Drei Blitze (Niveau A)

- [ ] Keine Inhalte blitzen mehr als 3 Mal/Sekunde
- [ ] Blitzfläche ist klein (<25% Viewport)

## 2.4 Navigierbar

### 2.4.1 Blöcke umgehen (Niveau A)

- [ ] Link zum Überspringen zum Hauptinhalt vorhanden
- [ ] Landmarken definiert
- [ ] Korrekte Überschriftenstruktur

```html
<a href="#main" class="skip-link">Zum Hauptinhalt springen</a>
<main id="main">...</main>
```

### 2.4.2 Seite betitelt (Niveau A)

- [ ] Eindeutige, beschreibende Seitentitel
- [ ] Titel spiegelt Seiteninhalt wider

### 2.4.3 Fokusreihenfolge (Niveau A)

- [ ] Fokusreihenfolge entspricht visueller Reihenfolge
- [ ] tabindex korrekt verwendet

### 2.4.4 Linkzweck (Im Kontext) (Niveau A)

- [ ] Links ergeben auch aus dem Kontext Sinn
- [ ] Kein „klicken Sie hier" oder „mehr lesen" allein

```html
<!-- Schlecht -->
<a href="report.pdf">Hier klicken</a>

<!-- Gut -->
<a href="report.pdf">Download Q4-Verkaufsbericht (PDF)</a>
```

### 2.4.6 Überschriften und Beschriftungen (Niveau AA)

- [ ] Überschriften beschreiben Inhalt
- [ ] Beschriftungen beschreiben Zweck

### 2.4.7 Fokus sichtbar (Niveau AA)

- [ ] Fokusindikator auf allen Elementen sichtbar
- [ ] Benutzerdefinierte Fokus-Stile erfüllen Kontrast

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

### 2.4.11 Fokus nicht verdeckt (Niveau AA) - WCAG 2.2

- [ ] Fokussiertes Element nicht vollständig verborgen
- [ ] Sticky-Header verdecken Fokus nicht

Verständlich (Prinzip 3)

## 3.1 Lesbar

### 3.1.1 Sprache der Seite (Niveau A)
- [ ] HTML lang-Attribut gesetzt
- [ ] Sprache korrekt für Inhalt

```html
<html lang="de">

3.1.2 Sprache von Teilen (Niveau AA)

  • Sprachwechsel markiert
<p>Das französische Wort <span lang="fr">bonjour</span> bedeutet Hallo.</p>

3.2 Vorhersehbar

3.2.1 Bei Fokus (Niveau A)

  • Kein Kontextwechsel allein durch Fokus
  • Keine unerwarteten Pop-ups bei Fokus

3.2.2 Bei Eingabe (Niveau A)

  • Kein automatisches Absenden des Formulars
  • Benutzer wird vor Kontextwechsel gewarnt

3.2.3 Konsistente Navigation (Niveau AA)

  • Navigation konsistent über Seiten hinweg
  • Wiederholte Komponenten in gleicher Reihenfolge

3.2.4 Konsistente Bezeichnung (Niveau AA)

  • Gleiche Funktion = gleiche Bezeichnung
  • Symbole konsistent verwendet

3.3 Eingabehilfe

3.3.1 Fehleridentifikation (Niveau A)

  • Fehler klar identifiziert
  • Fehlermeldung beschreibt Problem
  • Fehler mit Feld verknüpft
<input aria-describedby="email-error" aria-invalid="true" />
<span id="email-error" role="alert">Bitte gültige E-Mail eingeben</span>

3.3.2 Beschriftungen oder Anweisungen (Niveau A)

  • Alle Eingaben haben sichtbare Beschriftungen
  • Pflichtfelder gekennzeichnet
  • Formatierungshinweise gegeben

3.3.3 Fehlerkorrektur (Niveau AA)

  • Fehler enthalten Korrekturvorschlag
  • Vorschläge sind spezifisch

3.3.4 Fehlervermeidung (Niveau AA)

  • Rechtliche/finanzielle Formulare umkehrbar
  • Daten vor dem Absenden geprüft
  • Benutzer kann vor dem Absenden überprüfen

### Robust (Prinzip 4)

```markdown
## 4.1 Kompatibel

### 4.1.1 Parsen (Niveau A) - Veraltet in WCAG 2.2
- [ ] Gültiges HTML (gute Praxis)
- [ ] Keine doppelten IDs
- [ ] Vollständige Start-/End-Tags

### 4.1.2 Name, Rolle, Wert (Niveau A)
- [ ] Benutzerdefinierte Widgets haben zugängliche Namen
- [ ] ARIA-Rollen korrekt
- [ ] Zustandsänderungen angesagt

```html
<!-- Zugängliche benutzerdefinierte Checkbox -->
<div role="checkbox"
     aria-checked="false"
     tabindex="0"
     aria-labelledby="label">
</div>
<span id="label">Bedingungen akzeptieren</span>
```

### 4.1.3 Statusmeldungen (Niveau AA)

- [ ] Statusaktualisierungen angesagt
- [ ] Live-Regionen korrekt verwendet

```html
<div role="status" aria-live="polite">3 Artikel in den Warenkorb gelegt</div>

<div role="alert" aria-live="assertive">Fehler: Formularübermittlung fehlgeschlagen</div>
```

Automatisierte Tests

// axe-core Integration
const axe = require('axe-core');

async function runAccessibilityAudit(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
  };
}

// Playwright-Testbeispiel
test('sollte keine Zugänglichkeitsverstöße haben', async ({ page }) => {
  await page.goto('/');
  const results = await runAccessibilityAudit(page);

  expect(results.violations).toHaveLength(0);
});
# CLI-Tools
npx @axe-core/cli https://example.com
npx pa11y https://example.com
lighthouse https://example.com --only-categories=accessibility

Sanierungsmuster

Behebung: Fehlende Formularbeschriftungen

<!-- Vorher -->
<input type="email" placeholder="E-Mail" />

<!-- Nachher: Option 1 - Sichtbare Beschriftung -->
<label for="email">E-Mail-Adresse</label>
<input id="email" type="email" />

<!-- Nachher: Option 2 - aria-label -->
<input type="email" aria-label="E-Mail-Adresse" />

<!-- Nachher: Option 3 - aria-labelledby -->
<span id="email-label">E-Mail</span>
<input type="email" aria-labelledby="email-label" />

Behebung: Unzureichender Farbkontrast

/* Vorher: 2,5:1 Kontrast */
.text {
  color: #767676;
}

/* Nachher: 4,5:1 Kontrast */
.text {
  color: #595959;
}

/* Oder Hintergrund hinzufügen */
.text {
  color: #767676;
  background: #000;
}

Behebung: Tastaturnavigation

// Benutzerdefiniertes Element tastaturzugänglich machen
class AccessibleDropdown 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.toggle();
          e.preventDefault();
          break;
        case "Escape":
          this.close();
          break;
        case "ArrowDown":
          this.focusNext();
          e.preventDefault();
          break;
        case "ArrowUp":
          this.focusPrevious();
          e.preventDefault();
          break;
      }
    });
  }
}

Best Practices

Zu tun

  • Früh beginnen - Barrierefreiheit ab der Designphase
  • Mit echten Nutzern testen - Menschen mit Behinderungen geben das beste Feedback
  • Automatisieren, was möglich ist - 30-50% der Probleme erkennbar
  • Semantisches HTML verwenden - Reduziert ARIA-Bedarf
  • Muster dokumentieren - Zugängliche Komponentenbibliothek aufbauen

Nicht tun

  • Nicht nur auf automatisierte Tests verlassen - Manuelle Tests erforderlich
  • ARIA nicht als erste Lösung verwenden - Zuerst natives HTML
  • Fokusumrisse nicht ausblenden - Tastaturnutzer brauchen sie
  • Zoom nicht deaktivieren - Nutzer müssen vergrößern können
  • Farbe nicht allein verwenden - Mehrere Indikatoren nötig

Ressourcen

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

Verwandte Skills