accessibility-audit-toolkit

Accessibility-Audit-Skills für Claude Code, Cowork und vergleichbare AI-Assistenten. Open Source.

accessibility-audit-toolkit

Accessibility-Audit-Skills für Claude Code, Cowork und vergleichbare AI-Assistenten. Open Source.

Drei Skills plus WCAG- und BFSG-Knowledge-Base plus Onboarding-Wizard. Liefert WCAG 2.2 AA Audits, BFSG/EAA-Konformitätsbewertungen und Conformance-Reports (BFSG-Erklärung, VPAT 2.5, ACR).

Version: 0.1.0 License: MIT (Code) plus CC BY 4.0 (Knowledge) Plugin-Format: Cowork/Claude-Code-kompatibel, optional Standalone-Install

Companion-Plugin: Für heuristische UX-Reviews (Nielsen, Laws of UX, Dark Patterns): ux-audit-toolkit. Beide Plugins lassen sich parallel betreiben.

---

Was ist drin

Skills

Skill	Was er macht
accessibility-audit	WCAG 2.2 AA Audit + BFSG/EAA-Compliance-Bewertung + VPAT/ACR
audit-wizard	Interaktiver Step-by-Step-Accessibility-Audit-Flow mit Zwischenständen
accessibility-toolkit-onboard	Onboarding-Wizard für neue User. Führt durch Setup, Compliance-Lage-Check, Demo-Audit

Knowledge-Base

• WCAG 2.2 Success Criteria (Level A und AA, 50 SC)
• BFSG und EAA Compliance (Geltungsbereich, Fristen, Sanktionen, Übergangsregeln)
• Testing-Protokolle (axe, WAVE, NVDA, JAWS, VoiceOver, WCAG-EM 1.0)
• Conformance-Templates (BFSG-Erklärung, VPAT 2.5, Audit-Report)

---

Installation

Option A: Cowork-Plugin (empfohlen für Cowork-User)

git clone https://github.com/tendera01-spec/accessibility-audit-toolkit.git
cd accessibility-audit-toolkit
./build-plugin.sh

Output: dist/accessibility-audit-toolkit-0.1.0.plugin

Plugin per Doppelklick in Cowork öffnen oder via Claude Code installieren:

claude plugin install dist/accessibility-audit-toolkit-0.1.0.plugin

Option B: Standalone-Install via Python-Wizard

git clone https://github.com/tendera01-spec/accessibility-audit-toolkit.git
cd accessibility-audit-toolkit
python3 install.py

Optionen:

python3 install.py --all
python3 install.py --platform claude-code
python3 install.py --target ~/my-workspace
python3 install.py --dry-run --all

---

Quickstart

Nach der Installation triggert der Onboarding-Wizard:

"setup" oder "accessibility setup"

Oder direkt einen Audit starten:

Eingabe	Skill
"BFSG-Check für diese Webseite"	accessibility-audit
"WCAG 2.2 AA Test"	accessibility-audit
"VPAT erstellen für unser Produkt"	accessibility-audit
"Geführter Accessibility-Audit"	audit-wizard
"Hilf mir beim Einstieg"	accessibility-toolkit-onboard

---

Output-Beispiel: BFSG-Konformitätsbewertung

Geltungsbereich: B2C-E-Commerce, BFSG-pflichtig seit 28.06.2025
Konformitätsstand: teilweise vereinbar (3 Level-A + 13 Level-AA Verstöße)
Erklärung zur Barrierefreiheit: fehlt
Feedback-Mechanismus: fehlt
Risiko-Einschätzung: hoch (Geldbußenrisiko bis 100k Euro pro Verstoß)

Top-3-Fixes vor Audit-Disclosure:
1. Skip-Link in der Hauptnavigation ergänzen (WCAG 2.4.1)
2. Form-Labels korrekt verbinden (WCAG 3.3.2)
3. Fokus-Outline sichtbar machen (WCAG 2.4.7)

---

Compliance-Rahmen

Das Toolkit deckt folgende Regulierungen ab:

Region	Gesetz	Standard
EU	EAA (Directive 2019/882)	WCAG 2.1 AA, EN 301 549
Deutschland	BFSG (in Kraft seit 28.06.2025)	WCAG 2.1 AA via BFSGV
USA Federal	Section 508	WCAG 2.0 AA
USA Private	ADA Title III	WCAG 2.1 AA (Best Practice)
Kanada Ontario	AODA	WCAG 2.1 AA
UK	Equality Act 2010	WCAG 2.2 AA empfohlen

Mehr in docs/compliance-quickref.md.

---

Plugin entwickeln und bauen

./build-plugin.sh --check       # nur Validierung
./build-plugin.sh               # vollständiger Build
./build-plugin.sh --clean       # dist/ leeren

Was der Build prüft: Manifest, Pflicht-Files, Skill-Frontmatter, Em-Dashes.

---

Was dieses Toolkit NICHT macht

• Heuristische UX-Reviews (Nielsen, Laws of UX, Dark Patterns) → separates Plugin ux-audit-toolkit
• User-Tests mit Menschen mit Behinderungen (separates Vorgehen, Vendoren wie Fable Tech Labs)
• Rechtsberatung (Fachanwalt nötig)
• Automatisierte Crawls (Tools wie axe-core, Pa11y dafür, das Toolkit interpretiert die Outputs)
• Native Mobile App Audits mit Token-basiertem Tool-Setup

---

Frameworks und Quellen

• W3C (2023). Web Content Accessibility Guidelines (WCAG) 2.2.
• W3C (2014). WCAG-EM 1.0 Methodology.
• W3C (2024). ACT Rules Format 1.0.
• Bundesregierung (2021). Barrierefreiheitsstärkungsgesetz (BFSG).
• EU (2019). European Accessibility Act, Directive (EU) 2019/882.
• ETSI (2021). EN 301 549 V3.2.1.
• ITI (2024). VPAT 2.5 Template.

Originalquellen jeweils nach ihren Lizenzen frei zugänglich. Knowledge-Files sind eigene Zusammenfassungen und Arbeitsmaterialien, CC BY 4.0.

---

Beitragen

Pull Requests willkommen. Mehr in CONTRIBUTING.md.

---

Roadmap

• v0.2: Englische Übersetzung aller Knowledge-Files
• v0.3: WCAG 3.0 (Silver) Erweiterung sobald released
• v0.4: Section 508 Refresh dedicated workflow
• v0.5: Mobile-Native-App-Audit-Patterns
• v1.0: Marketplace-Listing, VPAT 2.5 Auto-Generator

---

Wer steht dahinter

Initial gebaut von einem Strategic Design Director mit Compliance-Erfahrung. Whitelabeled OSS-Version eines internen Audit-Systems.