screen-reader-testingvon Seth Hobson

Screen Reader Testing Skill.

Ein Claude Code- und Codex-Skill für Design Review: testet Web-Apps mit VoiceOver-, NVDA- und JAWS-Screenreadern.

Design Review & Accessibility
Review-Bericht

OpenDesign herunterladen Anleitung ansehen

wshobson/agents · plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.mdSKILL.md

--- name: screen-reader-testing description: Test web applications with screen readers including VoiceOver, NVDA, and JAWS. Use when validating screen reader compatibility, debugging accessibility issues, or ensuring assistive technology support. --- ## When to Use This Skill ## Core Concepts ## VoiceOver (macOS) ## VoiceOver Testing Checklist ## NVDA (Windows) ## NVDA Test Script

Metadaten und Abschnittsüberschriften aus der Ursprungsdatei vom 14.09.2026 · 12.020 Zeichen insgesamt

01 Was es tut

Was der screen-reader-testing Skill in Claude Code und Codex leistet

Zusammenfassung, Workflow und Ergebnisse — alles aus der SKILL.md des Skills ausgelesen.

Aus der SKILL.mdGelesen am 14.09.2026 · kein aufgezeichneter Durchlauf

In den eigenen Worten des Skills

Testet Webanwendungen mit den Screenreadern VoiceOver, NVDA, JAWS, TalkBack und Narrator auf macOS, Windows, iOS und Android. Validiert die Kompatibilität mit Screenreadern, debuggt Probleme mit assistiven Technologien und stellt durch praktische Tests mit echten Screenreadern korrekte ARIA-Implementierungen sicher.

Umfasst Navigation, Formulare, Ansagen dynamischer Inhalte, Fokusmanagement und modale Dialoge. Bietet plattformspezifische Befehle, Test-Checklisten und Codebeispiele für gängige Accessibility-Muster. Legt Wert auf das Testen in verschiedenen Screenreader-Modi (Browse, Fokus, Anwendung) und priorisiert semantisches HTML mit ARIA als ergänzende Erweiterung.

Was er erzeugt

VoiceOver-Testcheckliste für Seitenaufruf, Navigation, Links, Formulare, dynamische Inhalte und Tabellen
NVDA-Testskript mit schrittweisen Anleitungen für den initialen Ladevorgang, Landmarks, Überschriften, Formulare, interaktive Elemente und dynamische Inhalte
HTML-Codebeispiele mit barrierefreien Mustern und Korrekturen für häufige Probleme wie nicht beschriftete Schaltflächen, nicht angekündigte dynamische Inhalte und Formularfehler
JavaScript-Code für Fokusmanagement, einschließlich modaler Dialoge, Fokus-Trapping und Tastaturnavigation für Tab-Oberflächen

Siehe Beispiel-Prompt ↗

So funktioniert es

01
Testen mit den wichtigsten Screenreadern nach Plattform
Verwenden Sie NVDA mit Firefox auf Windows (31 % Nutzung), VoiceOver mit Safari auf macOS und iOS (15 % Nutzung), JAWS mit Chrome (40 % Nutzung), TalkBack auf Android (10 % Nutzung) und Narrator mit Edge (4 % Nutzung).
02
Navigieren mit Screenreader-spezifischen Befehlen
Führen Sie Befehle wie VO+Rechte Pfeiltaste für die Elementnavigation in VoiceOver, H für Überschriftensprünge in NVDA, Einfg+F7 für Linklisten in JAWS und Zwei-Finger-Wischen zum Scrollen in TalkBack aus.
03
Testen im Browse- und Fokusmodus
Überprüfen Sie, ob Screenreader korrekt zwischen dem Browse-Modus zum Lesen von Inhalten und dem Fokusmodus zur Interaktion mit Formularelementen wechseln, und achten Sie dabei auf Modusansagen.
04
Semantische Struktur und ARIA validieren
Prüfen Sie, ob Überschriften über den Rotor oder die Elementliste auffindbar sind, Landmarks korrekt beschriftet sind, Live-Regionen Aktualisierungen ansagen und Rollen wie dialog, tab und progressbar korrekt implementiert sind.
05
Fokusmanagement und Tastaturinteraktion überprüfen
Stellen Sie sicher, dass der Fokus nach dem Absenden eines Formulars zu Fehlern springt, modale Dialoge den Fokus korrekt einfangen und beim Schließen zurückgeben und dass Tab-Oberflächen auf Pfeiltasten, Pos1 und Ende reagieren.
06
Ansagen dynamischer Inhalte testen
Lösen Sie Inhaltsaktualisierungen aus und prüfen Sie, dass role="status" mit aria-live="polite" Änderungen nach der aktuellen Sprachausgabe ansagt, während role="alert" sofort unterbricht.

02 Finden Sie Ihren Favoriten

Wann Sie das screen-reader-testing Skill verwenden

Verwenden Sie den screen-reader-testing Skill in Claude Code oder Codex, wenn es um ein Design-Review dieser Art geht. Eignung und Grenzen unten stammen aus der eigenen Datei des Skills.

Gut geeignet

Validieren, dass eine Webanwendung mit Screenreader-Software korrekt funktioniert
Testen, ob ARIA-Rollen, -Zustände und -Eigenschaften korrekt implementiert sind
Debuggen von Problemen, die Nutzer assistiver Technologien betreffen
Sicherstellen, dass Formularelemente mit korrekten Beschriftungen und Fehleransagen zugänglich sind
Testen, dass Aktualisierungen dynamischer Inhalte Screenreader-Nutzern angesagt werden

Grenzen kennen

Sich ausschließlich auf visuelle Prüfung verlassen, um Accessibility zu validieren
Nur Erfolgspfade testen, ohne Fehlerzustände und Randfälle zu validieren
Mobile-Screenreader-Tests auf iOS und Android werden ausgelassen

03 Innerhalb des Skills

Regeln, die das screen-reader-testing Skill Claude Code und Codex vorgibt

8 konkrete Anweisungen, Standardwerte und Grenzen, die die SKILL.md für den Agent festlegt – der Teil der Datei, der das Ergebnis verändert.

Mit echten Screenreadern testen, nicht mit Simulatoren
Testen Sie stets mit echter Screenreader-Software (VoiceOver, NVDA, JAWS, TalkBack, Narrator) statt mit Simulationstools oder Emulatoren.
Zuerst semantisches HTML verwenden, ARIA ist ergänzend
Bauen Sie Oberflächen zunächst mit nativen HTML-Elementen, bevor Sie ARIA-Attribute hinzufügen. ARIA ergänzt semantisches HTML, ersetzt es aber nicht.
Mindestabdeckung: NVDA+Firefox, VoiceOver+Safari auf macOS und iOS
Testen Sie mindestens mit NVDA in Kombination mit Firefox unter Windows, mit VoiceOver und Safari auf macOS sowie mit VoiceOver und Safari auf iOS, bevor Sie die Anwendung als validiert betrachten.
In Lese- und Fokusmodus testen
Überprüfen Sie das Erlebnis im Lesemodus (zum Lesen von Inhalten mit den Pfeiltasten) und im Fokusmodus (zur Interaktion mit Steuerelementen), da Screenreader automatisch oder manuell zwischen ihnen wechseln.
Vor dem Screenreader-Test zuerst mit reiner Tastaturnavigation testen
Führen Sie zunächst Tests nur mit der Tastatur durch, da diese die Grundlage für die Screenreader-Zugänglichkeit bilden und Interaktionsprobleme frühzeitig aufdecken.
Fokusverwaltung bei Single-Page-Anwendungen überprüfen
Stellen Sie sicher, dass der Fokus bei dynamischen Inhaltsänderungen korrekt verwaltet wird, insbesondere bei SPAs, bei denen Seitenübergänge ohne vollständiges Neuladen erfolgen.
Niemals nur mit einem einzigen Screenreader testen
Das Testen mit nur einem Screenreader reicht nicht aus. Unterschiedliche Screenreader zeigen je Plattform unterschiedliches Verhalten und Nutzungsmuster.
Immer dynamische Inhalte und Fehlerzustände testen
Überspringen Sie nicht das Testen von Inhalten, die sich dynamisch aktualisieren, und beschränken Sie sich nicht auf den Idealfall. Dynamische Inhalte und Fehlerbehandlung sind die häufigsten Quellen für Zugänglichkeitsprobleme.

04 In Betrieb nehmen

screen-reader-testing in Claude Code oder Codex installieren

Ein npx skills add-Befehl, dann eine erste Aufgabe in Ihrem Agent und eine Checkliste für das Ergebnis.

screen-reader-testing zu Claude Code, Codex oder Ihrem Agent hinzufügen

Im eigenen Projekt ausführen; der Installer fragt, welchem Agent er hinzugefügt werden soll.

Terminal

npx skills add https://github.com/wshobson/agents --skill screen-reader-testing

Generische skills-CLI-Form für plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md; das Repository kann einen eigenen Pfad dokumentieren.

Dem Skill eine erste Design-Review-Aufgabe geben

In den eigenen Begriffen des Skills verfasst; ersetzen Sie die Teile in Klammern durch Ihr Material.

Starter prompt

Test the [checkout form] on [staging.example.com] with NVDA and VoiceOver to verify that all field labels are announced, required field indicators are read correctly, validation errors are communicated when the form is submitted with invalid data, and focus moves to the first error. Also confirm that the loading state during payment processing is announced and the success confirmation is read by the screen reader.

Quelle: verfasst aus der SKILL.md in den eigenen Begriffen des Skills.

Das erste Ergebnis prüfen

Was die SKILL.md selbst als korrektes Ergebnis beschreibt:

Überprüfen, ob der Seitentitel beim Laden der Seite angesagt wird
Bestätigen, dass alle Überschriften über den Rotor (VoiceOver) oder die Elementliste (NVDA, JAWS) auffindbar sind
Prüfen, ob Labels zusammen mit den zugehörigen Eingabefeldern vorgelesen werden
Sicherstellen, dass Fehlermeldungen angesagt werden, wenn Formulare mit ungültigen Daten abgesendet werden
Überprüfen, ob der Fokus innerhalb modaler Dialoge korrekt gefangen wird und nicht entweichen kann

In OpenDesign importieren Sie screen-reader-testing über den SKILL.md-Link: Plugins → Add → Skill → Import from link, und wählen Sie es anschließend in der oberen Leiste aus.

OpenDesign herunterladen Quickstart lesen

05 Open Source, nachvollziehbar

Quelle, Lizenz und Verifizierung

Woher die Fakten auf dieser Seite stammen und wann sie zuletzt geprüft wurden.

Author: Seth Hobson
Repository: github.com/wshobson/agents Branch main
Skill-Datei: plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md Inhaltsprüfsumme bei Verifikation erfasst; Commit 4236bb9
License: MIT Aus LICENSE.
Repository-Sterne: 39.635 GitHub-Snapshot vom 14.09.2026 für das gesamte Repository wshobson/agents, das 18 Skills in diesem Katalog enthält. Keine Bewertung oder Nutzungszahl für screen-reader-testing.
Verifiziert von OpenDesign: 14.09.2026 Quelldatei, Pfad, Lizenztext und Sternezählung wurden geprüft. Nicht in OpenDesign main gebündelt (geprüft 28.08.2026); ein Live-Durchlauf wurde auf dieser Seite nicht erfasst.

In der SKILL.md

Wann Sie dieses Skill verwenden solltenListet Szenarien wie das Validieren der Kompatibilität, das Testen von ARIA, das Debuggen von assistiven Technologien und das Überprüfen von Formularen und Navigation
KernkonzepteBehandelt die wichtigsten Screenreader nach Plattform und Nutzung, die minimale Testpriorität sowie Browse-, Focus- und Application-Modus
VoiceOver (macOS)Einrichtungsanleitung, wichtige Befehle mit Modifikatortasten, Rotor-Navigation, Testcheckliste und Lösungen für häufige HTML/ARIA-Probleme
NVDA (Windows)Einrichtung und Befehle, Navigation über Überschriften und Landmarken, Umschalten zwischen Browse- und Focus-Modus sowie ein schrittweises Testskript
JAWS (Windows)Wichtige Befehle einschließlich virtuellem Cursor, Schnelltasten für Elementtypen, Formularmodus und Tastenkürzel für die Tabellennavigation
TalkBack (Android)Einrichtungsschalter, Touch-Gesten für Navigation und Aktivierung sowie Optionen für die Granularität der Vorlesesteuerung
Häufige TestszenarienBarrierefreie Muster mit Code für modale Dialoge mit Fokus-Trapping, Live-Regionen und Tab-Oberflächen mit Tastaturunterstützung
Debugging-TippsJavaScript-Funktion, um den zugänglichen Namen, die Rolle, den Zustand und die Sichtbarkeit von Elementen zu protokollieren, so wie Screenreader sie wahrnehmen
Best PracticesEmpfehlungen und Vorbehalte zu tatsächlichem Testen, Priorität von semantischem HTML, Modustests, Fokusverwaltung und dem Vermeiden einer Validierung mit nur einem Screenreader

Die eigene Beschreibung des Skills

„Testet Webanwendungen mit Screenreadern wie VoiceOver, NVDA und JAWS. Verwenden Sie diesen Skill zur Validierung der Screenreader-Kompatibilität, zum Debuggen von Accessibility-Problemen oder zur Sicherstellung der Unterstützung assistiver Technologien."

Front-Matter-Beschreibung aus SKILL.md. Die vollständige Datei umfasst etwa 12.020 Zeichen. Die vollständige Datei auf GitHub lesen.

Screen-Reader-Testing

Führen Sie screen-reader-testing an einer echten Design-Review-Aufgabe aus.

Laden Sie OpenDesign herunter, importieren Sie screen-reader-testing über dessen SKILL.md-Link, fügen Sie den obigen Prompt ein und lesen Sie den Plan vor dem Ergebnis.

OpenDesign herunterladen Alle Skills durchsuchen

Terminal

npx skills add https://github.com/wshobson/agents --skill screen-reader-testing

Was der screen-reader-testing Skill in Claude Code und Codex leistet

In den eigenen Worten des Skills

So funktioniert es

Wann Sie das screen-reader-testing Skill verwenden

Gut geeignet

Grenzen kennen

Regeln, die das screen-reader-testing Skill Claude Code und Codex vorgibt

Mit echten Screenreadern testen, nicht mit Simulatoren

Zuerst semantisches HTML verwenden, ARIA ist ergänzend

Mindestabdeckung: NVDA+Firefox, VoiceOver+Safari auf macOS und iOS

In Lese- und Fokusmodus testen

Vor dem Screenreader-Test zuerst mit reiner Tastaturnavigation testen

Fokusverwaltung bei Single-Page-Anwendungen überprüfen

Niemals nur mit einem einzigen Screenreader testen

Immer dynamische Inhalte und Fehlerzustände testen