screen-reader-testing
starsforks
How to install screen-reader-testing?
wshobson/agents/screen-reader-testing
$npx -y skills add wshobson/agents --skill screen-reader-testingTest web applications with screen readers including VoiceOver, NVDA, and JAWS. Use when validating screen reader compatibility, debugging accessibility issues, or ensuring assistive technology support.
SKILL.md
| 1 | # Screen Reader Testing |
| 2 | |
| 3 | Practical guide to testing web applications with screen readers for comprehensive accessibility validation. |
| 4 | |
| 5 | ## When to Use This Skill |
| 6 | |
| 7 | - Validating screen reader compatibility |
| 8 | - Testing ARIA implementations |
| 9 | - Debugging assistive technology issues |
| 10 | - Verifying form accessibility |
| 11 | - Testing dynamic content announcements |
| 12 | - Ensuring navigation accessibility |
| 13 | |
| 14 | ## Core Concepts |
| 15 | |
| 16 | ### 1. Major Screen Readers |
| 17 | |
| 18 | | Screen Reader | Platform | Browser | Usage | |
| 19 | | ------------- | --------- | -------------- | ----- | |
| 20 | | **VoiceOver** | macOS/iOS | Safari | ~15% | |
| 21 | | **NVDA** | Windows | Firefox/Chrome | ~31% | |
| 22 | | **JAWS** | Windows | Chrome/IE | ~40% | |
| 23 | | **TalkBack** | Android | Chrome | ~10% | |
| 24 | | **Narrator** | Windows | Edge | ~4% | |
| 25 | |
| 26 | ### 2. Testing Priority |
| 27 | |
| 28 | ``` |
| 29 | Minimum Coverage: |
| 30 | 1. NVDA + Firefox (Windows) |
| 31 | 2. VoiceOver + Safari (macOS) |
| 32 | 3. VoiceOver + Safari (iOS) |
| 33 | |
| 34 | Comprehensive Coverage: |
| 35 | + JAWS + Chrome (Windows) |
| 36 | + TalkBack + Chrome (Android) |
| 37 | + Narrator + Edge (Windows) |
| 38 | ``` |
| 39 | |
| 40 | ### 3. Screen Reader Modes |
| 41 | |
| 42 | | Mode | Purpose | When Used | |
| 43 | | ------------------ | ---------------------- | ----------------- | |
| 44 | | **Browse/Virtual** | Read content | Default reading | |
| 45 | | **Focus/Forms** | Interact with controls | Filling forms | |
| 46 | | **Application** | Custom widgets | ARIA applications | |
| 47 | |
| 48 | ## VoiceOver (macOS) |
| 49 | |
| 50 | ### Setup |
| 51 | |
| 52 | ``` |
| 53 | Enable: System Preferences → Accessibility → VoiceOver |
| 54 | Toggle: Cmd + F5 |
| 55 | Quick Toggle: Triple-press Touch ID |
| 56 | ``` |
| 57 | |
| 58 | ### Essential Commands |
| 59 | |
| 60 | ``` |
| 61 | Navigation: |
| 62 | VO = Ctrl + Option (VoiceOver modifier) |
| 63 | |
| 64 | VO + Right Arrow Next element |
| 65 | VO + Left Arrow Previous element |
| 66 | VO + Shift + Down Enter group |
| 67 | VO + Shift + Up Exit group |
| 68 | |
| 69 | Reading: |
| 70 | VO + A Read all from cursor |
| 71 | Ctrl Stop speaking |
| 72 | VO + B Read current paragraph |
| 73 | |
| 74 | Interaction: |
| 75 | VO + Space Activate element |
| 76 | VO + Shift + M Open menu |
| 77 | Tab Next focusable element |
| 78 | Shift + Tab Previous focusable element |
| 79 | |
| 80 | Rotor (VO + U): |
| 81 | Navigate by: Headings, Links, Forms, Landmarks |
| 82 | Left/Right Arrow Change rotor category |
| 83 | Up/Down Arrow Navigate within category |
| 84 | Enter Go to item |
| 85 | |
| 86 | Web Specific: |
| 87 | VO + Cmd + H Next heading |
| 88 | VO + Cmd + J Next form control |
| 89 | VO + Cmd + L Next link |
| 90 | VO + Cmd + T Next table |
| 91 | ``` |
| 92 | |
| 93 | ### Testing Checklist |
| 94 | |
| 95 | ```markdown |
| 96 | ## VoiceOver Testing Checklist |
| 97 | |
| 98 | ### Page Load |
| 99 | |
| 100 | - [ ] Page title announced |
| 101 | - [ ] Main landmark found |
| 102 | - [ ] Skip link works |
| 103 | |
| 104 | ### Navigation |
| 105 | |
| 106 | - [ ] All headings discoverable via rotor |
| 107 | - [ ] Heading levels logical (H1 → H2 → H3) |
| 108 | - [ ] Landmarks properly labeled |
| 109 | - [ ] Skip links functional |
| 110 | |
| 111 | ### Links & Buttons |
| 112 | |
| 113 | - [ ] Link purpose clear |
| 114 | - [ ] Button actions described |
| 115 | - [ ] New window/tab announced |
| 116 | |
| 117 | ### Forms |
| 118 | |
| 119 | - [ ] All labels read with inputs |
| 120 | - [ ] Required fields announced |
| 121 | - [ ] Error messages read |
| 122 | - [ ] Instructions available |
| 123 | - [ ] Focus moves to errors |
| 124 | |
| 125 | ### Dynamic Content |
| 126 | |
| 127 | - [ ] Alerts announced immediately |
| 128 | - [ ] Loading states communicated |
| 129 | - [ ] Content updates announced |
| 130 | - [ ] Modals trap focus correctly |
| 131 | |
| 132 | ### Tables |
| 133 | |
| 134 | - [ ] Headers associated with cells |
| 135 | - [ ] Table navigation works |
| 136 | - [ ] Complex tables have captions |
| 137 | ``` |
| 138 | |
| 139 | ### Common Issues & Fixes |
| 140 | |
| 141 | ```html |
| 142 | <!-- Issue: Button not announcing purpose --> |
| 143 | <button><svg>...</svg></button> |
| 144 | |
| 145 | <!-- Fix --> |
| 146 | <button aria-label="Close dialog"><svg aria-hidden="true">...</svg></button> |
| 147 | |
| 148 | <!-- Issue: Dynamic content not announced --> |
| 149 | <div id="results">New results loaded</div> |
| 150 | |
| 151 | <!-- Fix --> |
| 152 | <div id="results" role="status" aria-live="polite">New results loaded</div> |
| 153 | |
| 154 | <!-- Issue: Form error not read --> |
| 155 | <input type="email" /> |
| 156 | <span class="error">Invalid email</span> |
| 157 | |
| 158 | <!-- Fix --> |
| 159 | <input type="email" aria-invalid="true" aria-describedby="email-error" /> |
| 160 | <span id="email-error" role="alert">Invalid email</span> |
| 161 | ``` |
| 162 | |
| 163 | ## NVDA (Windows) |
| 164 | |
| 165 | ### Setup |
| 166 | |
| 167 | ``` |
| 168 | Download: nvaccess.org |
| 169 | Start: Ctrl + Alt + N |
| 170 | Stop: Insert + Q |
| 171 | ``` |
| 172 | |
| 173 | ### Essential Commands |
| 174 | |
| 175 | ``` |
| 176 | Navigation: |
| 177 | Insert = NVDA modifier |
| 178 | |
| 179 | Down Arrow Next line |
| 180 | Up Arrow Previous line |
| 181 | Tab Next focusable |
| 182 | Shift + Tab Previous focusable |
| 183 | |
| 184 | Reading: |
| 185 | NVDA + Down Arrow Say all |
| 186 | Ctrl Stop speech |
| 187 | NVDA + Up Arrow Current line |
| 188 | |
| 189 | Headings: |
| 190 | H Next heading |
| 191 | Shift + H Previous heading |
| 192 | 1-6 Heading level 1-6 |
| 193 | |
| 194 | Forms: |
| 195 | F Next form field |
| 196 | B Next button |
| 197 | E Next edit field |
| 198 | X Next checkbox |
| 199 | C Next combo box |
| 200 | |
| 201 | Links: |
| 202 | K Next link |
| 203 | U Next unvisited link |
| 204 | V Next visited link |
| 205 | |
| 206 | Landmarks: |
| 207 | D Nex |
People who liked this also viewed
6 picksType
- tddSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- test-driven-developmentUse when implementing any feature or bugfix, before writing implementation codeSkillsJul 2026
- qaSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- verification-before-completionUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidenceSkillsJul 2026
- webapp-testingToolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser lSkillsJul 2026
- playwright-best-practicesUse when writing Playwright tests, fixing flaky tests, debugging failures, implementing Page Object Model, configuring CI/CD, optimizing performance, mocking APIs, handling authentication or OAuth, teSkillsJul 2026
