Skills screen-reader-testing
đŸĻģ

screen-reader-testing

Safe 🌐 Network accessâš™ī¸ External commands

Test screen reader support fast

Screen reader issues are hard to reproduce and validate. This skill gives clear test steps and fixes for VoiceOver, NVDA, JAWS, and TalkBack.

Supports: Claude Codex Code(CC)
📊 70 Adequate
1

Download the skill ZIP

2

Upload in Claude

Go to Settings → Capabilities → Skills → Upload skill

3

Toggle on and start using

Test it

Using "screen-reader-testing". Provide a checklist to test a modal dialog with NVDA.

Expected outcome:

  • Confirm the dialog title and description are announced on open
  • Verify focus moves into the dialog and is trapped inside
  • Check that Escape closes the dialog and focus returns
  • Ensure all buttons announce role and state

Using "screen-reader-testing". What VoiceOver commands help test heading structure?

Expected outcome:

  • VO + Cmd + H to jump to next heading
  • Use Rotor (VO + U) to navigate by headings category
  • Check logical heading level progression
  • Verify all section headings are discoverable

Quality Score

38
Architecture
100
Maintainability
85
Content
30
Community
100
Security
87
Spec Compliance

What You Can Build

Manual regression pass

Run repeatable screen reader checks before a release.

Fix ARIA issues

Debug missing announcements and focus behavior in components.

Team test guide

Standardize screen reader testing coverage across teams.

Try These Prompts

Start with VoiceOver
Create a VoiceOver test checklist for my landing page with headings, landmarks, and forms.
NVDA quick audit
Give me an NVDA script to test a checkout form, including error handling and focus movement.
Dynamic content checks
List steps to verify live region announcements for search results updates.
Advanced widget review
Review my tab and modal behavior and list the critical screen reader checks to run.

Best Practices

  • Test with real screen readers on supported platforms
  • Use semantic HTML before adding ARIA
  • Verify keyboard only flow before screen reader tests

Avoid

  • Relying on a single screen reader for approval
  • Testing only happy paths without errors
  • Ignoring mobile screen reader behavior

Frequently Asked Questions

Is this compatible with Claude, Codex, and Claude Code?
Yes, it is plain guidance and works in Claude, Codex, and Claude Code.
What are the main limits of this skill?
It is manual guidance and does not run tests or automate screen readers.
Can it integrate with my test pipeline?
It provides steps and checklists you can adapt into your QA process.
Does it access or store my data?
No, it only provides instructions and sample patterns.
What if NVDA or VoiceOver results are inconsistent?
Verify browser, mode, and focus behavior, then retest with the listed commands.
How does it compare to automated a11y tools?
It covers real screen reader behavior that automated tools cannot fully detect.

Developer Details

File structure

📄 SKILL.md