Communitygithub.com

Barrierefreiheits-Audit

Prüft Websites, Web-Apps oder UI-Komponenten auf Barrierefreiheit (a11y), WCAG-Konformität, Screenreader- und Tastaturunterstützung, Farbkontraste und ARIA-Nutzung. Behebt Mängel aus axe-, Lighthouse- oder manuellen Accessibility-Reviews.

Was ist Barrierefreiheits-Audit?

Diese Skill ermöglicht es einem KI-Agenten (z. B. Claude Code), eine umfassende Barrierefreiheitsprüfung einer Webanwendung durchzuführen. Sie deckt alle relevanten WCAG-2.2-AA-Kriterien ab: automatische Scans mit @axe-core/cli oder Lighthouse, manuelle Code-Reviews von Komponenten, Tastaturdurchläufe, Screenreader-Tests und die Erstellung eines strukturierten Berichts. Der Fokus liegt darauf, Probleme direkt in den Komponenten zu beheben, damit die Korrektur überall dort greift, wo die Komponente verwendet wird. Die Skill bietet eine detaillierte Checkliste mit konkreten WCAG-Anforderungen und Anleitungen zur Vermeidung häufiger Fehler (z. B. fehlerhafte ARIA-Nutzung oder fehlende Labels). Der Agent kann auf dieser Basis einen standardisierten Befundbericht mit Schweregrad, betroffenen Gruppen und Lösungsvorschlägen generieren.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/WST2002/claude-code-skills/tree/HEAD/skills/accessibility-audit

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Barrierefreiheits-Audit?

Übersicht

Prüfen, ob jeder die Benutzeroberfläche wahrnehmen, bedienen und verstehen kann: nur mit der Tastatur, mit einem Screenreader, mit Vergrößerung und bei eingeschränkter Sehfähigkeit. Beheben Sie Mängel in den Komponenten, die sie verursachen, damit die Korrektur überall dort greift, wo sie verwendet werden.

Methode

  1. Automatisierter Scan, falls eine URL verfügbar ist: npx @axe-core/cli <url> oder Lighthouse-Barrierefreiheit. Automatisierte Tools finden etwa ein Drittel der Probleme; behandeln Sie die Ergebnisse als Ausgangspunkt.
  2. Code-Review der Komponenten anhand der untenstehenden Checkliste: Formulare, Schaltflächen, Links, Bilder, Modals, Menüs, Tabs, Tabellen, benutzerdefinierte Widgets.
  3. Tastaturtest: Mit der Tabulatortaste durch jedes interaktive Element navigieren. Sichtbarer Fokus, logische Reihenfolge, nichts ist unerreichbar, keine Fokusfallen, Escape schließt Overlays, der Fokus kehrt zum Auslöser zurück.
  4. Screenreader-Semantik: Jedes Steuerelement hat eine Rolle, einen zugänglichen Namen und seinen Zustand (erweitert, ausgewählt, aktiviert, ungültig).
  5. Bericht mit dem untenstehenden Vertrag, zugeordnet zu WCAG 2.2 AA.

Checkliste

BereichAnforderung (WCAG)
BilderInformative Bilder haben einen aussagekräftigen alt-Text; dekorative Bilder erhalten alt="" (1.1.1)
KontrastText 4,5:1, großer Text und UI-Komponenten 3:1 (1.4.3, 1.4.11)
FarbeInformationen werden nicht allein durch Farbe vermittelt (1.4.1)
StrukturEine h1, geordnete Überschriften, Landmarken (header, nav, main, footer), Listen als Listen (1.3.1)
FormulareJedes Eingabefeld hat ein <label>; Fehler werden im Text benannt und mit aria-describedby verknüpft; Pflichtfelder sind gekennzeichnet (1.3.1, 3.3.1, 3.3.2)
SteuerelementeAktionen sind <button>, Navigation ist <a href>; kein klickbares div ohne Rolle, Tabindex und Tastaturhandler (2.1.1, 4.1.2)
FokusSichtbarer Fokusindikator; niemals outline: none ohne Ersatz (2.4.7)
Modals und MenüsFokus wird hinein bewegt, bleibt geöffnet gefangen, Escape schließt, Fokus kehrt zurück (2.1.2, 2.4.3)
NamenNur-Symbol-Schaltflächen haben ein aria-label; Linktext ist aus dem Kontext verständlich (2.4.4, 4.1.2)
Bewegungprefers-reduced-motion respektieren; keine automatisch abspielende Bewegung länger als 5 s ohne Pause (2.2.2, 2.3.3)
Zoom und RefowBei 200 % Zoom und 320 px Breite ohne horizontales Scrollen nutzbar (1.4.4, 1.4.10)
ZieleTouch-Ziele mindestens 24 × 24 px (2.5.8)
Sprache<html lang> gesetzt (3.1.1)

ARIA-Regel: Natürliche HTML-Elemente bevorzugen. Fügen Sie ARIA nur hinzu, wenn kein natives Element passt, und implementieren Sie dann das vollständige Tastaturverhalten dieses Musters.

Ausgabe-Vertrag

### [Critical | Serious | Moderate | Minor] Titel — WCAG <Kriterium>
- Wo: Komponente und Datei:Zeile (und ggf. URL)
- Wer betroffen ist: Tastaturnutzer, Screenreadernutzer, Sehbehinderte usw.
- Lösung: Korrigiertes Markup oder CSS

Critical = blockiert eine Aufgabe für einige Benutzer (z. B. kann ein Formular nicht per Tastatur abgesendet werden). Enden Sie mit Bestandene Prüfungen und Manuell zu testen (Punkte, die eine echte Screenreader-Sitzung erfordern).

Häufige Fehler

  • div oder span mit onClick anstelle eines button.
  • Platzhaltertext als einziges Label verwendet.
  • aria-label, das dem sichtbaren Text widerspricht.
  • role="button" ohne Behandlung der Eingabetaste und Leertaste hinzugefügt.
  • WCAG-Konformität allein aufgrund eines automatisierten Scans behauptet.

Erstellt von Wageesha Tripathi · LinkedIn · E-Mail · Weitere Skills

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills