[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75GC09F0SA1K239A4B7SSWE":3,"skill-same:01M75GC09F0SA1K239A4B7SSWE":44},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M75GC09F0SA1K239A4B7SSWE","screen-reader-testing",null,"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.","RudyCity\u002Fsuperagent","RudyCity","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F82188919?v=4","01M75FP5X8AW8ACBH0SH34WS7M","01M75FP5YAHJK8M1Q52BWXB82K",70,"MIT","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fscreen-reader-testing\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: screen-reader-testing\ndescription: 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.\n---\n\n# Screen Reader Testing\n\nPractical guide to testing web applications with screen readers for comprehensive accessibility validation.\n\n## When to Use This Skill\n\n- Validating screen reader compatibility\n- Testing ARIA implementations\n- Debugging assistive technology issues\n- Verifying form accessibility\n- Testing dynamic content announcements\n- Ensuring navigation accessibility\n\n## Core Concepts\n\n### 1. Major Screen Readers\n\n| Screen Reader | Platform  | Browser        | Usage |\n| ------------- | --------- | -------------- | ----- |\n| **VoiceOver** | macOS\u002FiOS | Safari         | ~15%  |\n| **NVDA**      | Windows   | Firefox\u002FChrome | ~31%  |\n| **JAWS**      | Windows   | Chrome\u002FIE      | ~40%  |\n| **TalkBack**  | Android   | Chrome         | ~10%  |\n| **Narrator**  | Windows   | Edge           | ~4%   |\n\n### 2. Testing Priority\n\n```\nMinimum Coverage:\n1. NVDA + Firefox (Windows)\n2. VoiceOver + Safari (macOS)\n3. VoiceOver + Safari (iOS)\n\nComprehensive Coverage:\n+ JAWS + Chrome (Windows)\n+ TalkBack + Chrome (Android)\n+ Narrator + Edge (Windows)\n```\n\n### 3. Screen Reader Modes\n\n| Mode               | Purpose                | When Used         |\n| ------------------ | ---------------------- | ----------------- |\n| **Browse\u002FVirtual** | Read content           | Default reading   |\n| **Focus\u002FForms**    | Interact with controls | Filling forms     |\n| **Application**    | Custom widgets         | ARIA applications |\n\n## VoiceOver (macOS)\n\n### Setup\n\n```\nEnable: System Preferences → Accessibility → VoiceOver\nToggle: Cmd + F5\nQuick Toggle: Triple-press Touch ID\n```\n\n### Essential Commands\n\n```\nNavigation:\nVO = Ctrl + Option (VoiceOver modifier)\n\nVO + Right Arrow   Next element\nVO + Left Arrow    Previous element\nVO + Shift + Down  Enter group\nVO + Shift + Up    Exit group\n\nReading:\nVO + A             Read all from cursor\nCtrl               Stop speaking\nVO + B             Read current paragraph\n\nInteraction:\nVO + Space         Activate element\nVO + Shift + M     Open menu\nTab                Next focusable element\nShift + Tab        Previous focusable element\n\nRotor (VO + U):\nNavigate by: Headings, Links, Forms, Landmarks\nLeft\u002FRight Arrow   Change rotor category\nUp\u002FDown Arrow      Navigate within category\nEnter              Go to item\n\nWeb Specific:\nVO + Cmd + H       Next heading\nVO + Cmd + J       Next form control\nVO + Cmd + L       Next link\nVO + Cmd + T       Next table\n```\n\n### Testing Checklist\n\n```markdown\n## VoiceOver Testing Checklist\n\n### Page Load\n\n- [ ] Page title announced\n- [ ] Main landmark found\n- [ ] Skip link works\n\n### Navigation\n\n- [ ] All headings discoverable via rotor\n- [ ] Heading levels logical (H1 → H2 → H3)\n- [ ] Landmarks properly labeled\n- [ ] Skip links functional\n\n### Links & Buttons\n\n- [ ] Link purpose clear\n- [ ] Button actions described\n- [ ] New window\u002Ftab announced\n\n### Forms\n\n- [ ] All labels read with inputs\n- [ ] Required fields announced\n- [ ] Error messages read\n- [ ] Instructions available\n- [ ] Focus moves to errors\n\n### Dynamic Content\n\n- [ ] Alerts announced immediately\n- [ ] Loading states communicated\n- [ ] Content updates announced\n- [ ] Modals trap focus correctly\n\n### Tables\n\n- [ ] Headers associated with cells\n- [ ] Table navigation works\n- [ ] Complex tables have captions\n```\n\n### Common Issues & Fixes\n\n```html\n\u003C!-- Issue: Button not announcing purpose -->\n\u003Cbutton>\u003Csvg>...\u003C\u002Fsvg>\u003C\u002Fbutton>\n\n\u003C!-- Fix -->\n\u003Cbutton aria-label=\"Close dialog\">\u003Csvg aria-hidden=\"true\">...\u003C\u002Fsvg>\u003C\u002Fbutton>\n\n\u003C!-- Issue: Dynamic content not announced -->\n\u003Cdiv id=\"results\">New results loaded\u003C\u002Fdiv>\n\n\u003C!-- Fix -->\n\u003Cdiv id=\"results\" role=\"status\" aria-live=\"polite\">New results loaded\u003C\u002Fdiv>\n\n\u003C!-- Issue: Form error not read -->\n\u003Cinput type=\"email\" \u002F>\n\u003Cspan class=\"error\">Invalid email\u003C\u002Fspan>\n\n\u003C!-- Fix -->\n\u003Cinput type=\"email\" aria-invalid=\"true\" aria-describedby=\"email-error\" \u002F>\n\u003Cspan id=\"email-error\" role=\"alert\">Invalid email\u003C\u002Fspan>\n```\n\n## NVDA (Windows)\n\n### Setup\n\n```\nDownload: nvaccess.org\nStart: Ctrl + Alt + N\nStop: Insert + Q\n```\n\n### Essential Commands\n\n```\nNavigation:\nInsert = NVDA modifier\n\nDown Arrow         Next line\nUp Arrow           Previous line\nTab                Next focusable\nShift + Tab        Previous focusable\n\nReading:\nNVDA + Down Arrow  Say all\nCtrl               Stop speech\nNVDA + Up Arrow    Current line\n\nHeadings:\nH                  Next heading\nShift + H          Previous heading\n1-6                Heading level 1-6\n\nForms:\nF                  Next form field\nB                  Next button\nE                  Next edit field\nX                  Next checkbox\nC                  Next combo box\n\nLinks:\nK                  Next link\nU                  Next unvisited link\nV                  Next visited link\n\nLandmarks:\nD                  Next landmark\nShift + D          Previous landmark\n\nTables:\nT                  Next table\nCtrl + Alt + Arrows Navigate cells\n\nElements List (NVDA + F7):\nShows all links, headings, form fields, landmarks\n```\n\n### Browse vs Focus Mode\n\n```\nNVDA automatically switches modes:\n- Browse Mode: Arrow keys navigate content\n- Focus Mode: Arrow keys control interactive elements\n\nManual switch: NVDA + Space\n\nWatch for:\n- \"Browse mode\" announcement when navigating\n- \"Focus mode\" when entering form fields\n- Application role forces forms mode\n```\n\n### Testing Script\n\n```markdown\n## NVDA Test Script\n\n### Initial Load\n\n1. Navigate to page\n2. Let page finish loading\n3. Press Insert + Down to read all\n4. Note: Page title, main content identified?\n\n### Landmark Navigation\n\n1. Press D repeatedly\n2. Check: All main areas reachable?\n3. Check: Landmarks properly labeled?\n\n### Heading Navigation\n\n1. Press Insert + F7 → Headings\n2. Check: Logical heading structure?\n3. Press H to navigate headings\n4. Check: All sections discoverable?\n\n### Form Testing\n\n1. Press F to find first form field\n2. Check: Label read?\n3. Fill in invalid data\n4. Submit form\n5. Check: Errors announced?\n6. Check: Focus moved to error?\n\n### Interactive Elements\n\n1. Tab through all interactive elements\n2. Check: Each announces role and state\n3. Activate buttons with Enter\u002FSpace\n4. Check: Result announced?\n\n### Dynamic Content\n\n1. Trigger content update\n2. Check: Change announced?\n3. Open modal\n4. Check: Focus trapped?\n5. Close modal\n6. Check: Focus returns?\n```\n\n## JAWS (Windows)\n\n### Essential Commands\n\n```\nStart: Desktop shortcut or Ctrl + Alt + J\nVirtual Cursor: Auto-enabled in browsers\n\nNavigation:\nArrow keys         Navigate content\nTab                Next focusable\nInsert + Down      Read all\nCtrl               Stop speech\n\nQuick Keys:\nH                  Next heading\nT                  Next table\nF                  Next form field\nB                  Next button\nG                  Next graphic\nL                  Next list\n;                  Next landmark\n\nForms Mode:\nEnter              Enter forms mode\nNumpad +           Exit forms mode\nF5                 List form fields\n\nLists:\nInsert + F7        Link list\nInsert + F6        Heading list\nInsert + F5        Form field list\n\nTables:\nCtrl + Alt + Arrows Table navigation\n```\n\n## TalkBack (Android)\n\n### Setup\n\n```\nEnable: Settings → Accessibility → TalkBack\nToggle: Hold both volume buttons 3 seconds\n```\n\n### Gestures\n\n```\nExplore: Drag finger across screen\nNext: Swipe right\nPrevious: Swipe left\nActivate: Double tap\nScroll: Two finger swipe\n\nReading Controls (swipe up then right):\n- Headings\n- Links\n- Controls\n- Characters\n- Words\n- Lines\n- Paragraphs\n```\n\n## Common Test Scenarios\n\n### 1. Modal Dialog\n\n```html\n\u003C!-- Accessible modal structure -->\n\u003Cdiv\n  role=\"dialog\"\n  aria-modal=\"true\"\n  aria-labelledby=\"dialog-title\"\n  aria-describedby=\"dialog-desc\"\n>\n  \u003Ch2 id=\"dialog-title\">Confirm Delete\u003C\u002Fh2>\n  \u003Cp id=\"dialog-desc\">This action cannot be undone.\u003C\u002Fp>\n  \u003Cbutton>Cancel\u003C\u002Fbutton>\n  \u003Cbutton>Delete\u003C\u002Fbutton>\n\u003C\u002Fdiv>\n```\n\n```javascript\n\u002F\u002F Focus management\nfunction openModal(modal) {\n  \u002F\u002F Store last focused element\n  lastFocus = document.activeElement;\n\n  \u002F\u002F Move focus to modal\n  modal.querySelector(\"h2\").focus();\n\n  \u002F\u002F Trap focus\n  modal.addEventListener(\"keydown\", trapFocus);\n}\n\nfunction closeModal(modal) {\n  \u002F\u002F Return focus\n  lastFocus.focus();\n}\n\nfunction trapFocus(e) {\n  if (e.key === \"Tab\") {\n    const focusable = modal.querySelectorAll(\n      'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])',\n    );\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n\n    if (e.shiftKey && document.activeElement === first) {\n      last.focus();\n      e.preventDefault();\n    } else if (!e.shiftKey && document.activeElement === last) {\n      first.focus();\n      e.preventDefault();\n    }\n  }\n\n  if (e.key === \"Escape\") {\n    closeModal(modal);\n  }\n}\n```\n\n### 2. Live Regions\n\n```html\n\u003C!-- Status messages (polite) -->\n\u003Cdiv role=\"status\" aria-live=\"polite\" aria-atomic=\"true\">\n  \u003C!-- Content updates will be announced after current speech -->\n\u003C\u002Fdiv>\n\n\u003C!-- Alerts (assertive) -->\n\u003Cdiv role=\"alert\" aria-live=\"assertive\">\n  \u003C!-- Content updates interrupt current speech -->\n\u003C\u002Fdiv>\n\n\u003C!-- Progress updates -->\n\u003Cdiv\n  role=\"progressbar\"\n  aria-valuenow=\"75\"\n  aria-valuemin=\"0\"\n  aria-valuemax=\"100\"\n  aria-label=\"Upload progress\"\n>\u003C\u002Fdiv>\n\n\u003C!-- Log (additions only) -->\n\u003Cdiv role=\"log\" aria-live=\"polite\" aria-relevant=\"additions\">\n  \u003C!-- New messages announced, removals not -->\n\u003C\u002Fdiv>\n```\n\n### 3. Tab Interface\n\n```html\n\u003Cdiv role=\"tablist\" aria-label=\"Product information\">\n  \u003Cbutton role=\"tab\" id=\"tab-1\" aria-selected=\"true\" aria-controls=\"panel-1\">\n    Description\n  \u003C\u002Fbutton>\n  \u003Cbutton\n    role=\"tab\"\n    id=\"tab-2\"\n    aria-selected=\"false\"\n    aria-controls=\"panel-2\"\n    tabindex=\"-1\"\n  >\n    Reviews\n  \u003C\u002Fbutton>\n\u003C\u002Fdiv>\n\n\u003Cdiv role=\"tabpanel\" id=\"panel-1\" aria-labelledby=\"tab-1\">\n  Product description content...\n\u003C\u002Fdiv>\n\n\u003Cdiv role=\"tabpanel\" id=\"panel-2\" aria-labelledby=\"tab-2\" hidden>\n  Reviews content...\n\u003C\u002Fdiv>\n```\n\n```javascript\n\u002F\u002F Tab keyboard navigation\ntablist.addEventListener(\"keydown\", (e) => {\n  const tabs = [...tablist.querySelectorAll('[role=\"tab\"]')];\n  const index = tabs.indexOf(document.activeElement);\n\n  let newIndex;\n  switch (e.key) {\n    case \"ArrowRight\":\n      newIndex = (index + 1) % tabs.length;\n      break;\n    case \"ArrowLeft\":\n      newIndex = (index - 1 + tabs.length) % tabs.length;\n      break;\n    case \"Home\":\n      newIndex = 0;\n      break;\n    case \"End\":\n      newIndex = tabs.length - 1;\n      break;\n    default:\n      return;\n  }\n\n  tabs[newIndex].focus();\n  activateTab(tabs[newIndex]);\n  e.preventDefault();\n});\n```\n\n## Debugging Tips\n\n```javascript\n\u002F\u002F Log what screen reader sees\nfunction logAccessibleName(element) {\n  const computed = window.getComputedStyle(element);\n  console.log({\n    role: element.getAttribute(\"role\") || element.tagName,\n    name:\n      element.getAttribute(\"aria-label\") ||\n      element.getAttribute(\"aria-labelledby\") ||\n      element.textContent,\n    state: {\n      expanded: element.getAttribute(\"aria-expanded\"),\n      selected: element.getAttribute(\"aria-selected\"),\n      checked: element.getAttribute(\"aria-checked\"),\n      disabled: element.disabled,\n    },\n    visible: computed.display !== \"none\" && computed.visibility !== \"hidden\",\n  });\n}\n```\n\n## Best Practices\n\n### Do's\n\n- **Test with actual screen readers** - Not just simulators\n- **Use semantic HTML first** - ARIA is supplemental\n- **Test in browse and focus modes** - Different experiences\n- **Verify focus management** - Especially for SPAs\n- **Test keyboard only first** - Foundation for SR testing\n\n### Don'ts\n\n- **Don't assume one SR is enough** - Test multiple\n- **Don't ignore mobile** - Growing user base\n- **Don't test only happy path** - Test error states\n- **Don't skip dynamic content** - Most common issues\n- **Don't rely on visual testing** - Different experience\n","# Screen Reader Testing\n\nPractical guide to testing web applications with screen readers for comprehensive accessibility validation.\n\n## When to Use This Skill\n\n- Validating screen reader compatibility\n- Testing ARIA implementations\n- Debugging assistive technology issues\n- Verifying form accessibility\n- Testing dynamic content announcements\n- Ensuring navigation accessibility\n\n## Core Concepts\n\n### 1. Major Screen Readers\n\n| Screen Reader | Platform  | Browser        | Usage |\n| ------------- | --------- | -------------- | ----- |\n| **VoiceOver** | macOS\u002FiOS | Safari         | ~15%  |\n| **NVDA**      | Windows   | Firefox\u002FChrome | ~31%  |\n| **JAWS**      | Windows   | Chrome\u002FIE      | ~40%  |\n| **TalkBack**  | Android   | Chrome         | ~10%  |\n| **Narrator**  | Windows   | Edge           | ~4%   |\n\n### 2. Testing Priority\n\n```\nMinimum Coverage:\n1. NVDA + Firefox (Windows)\n2. VoiceOver + Safari (macOS)\n3. VoiceOver + Safari (iOS)\n\nComprehensive Coverage:\n+ JAWS + Chrome (Windows)\n+ TalkBack + Chrome (Android)\n+ Narrator + Edge (Windows)\n```\n\n### 3. Screen Reader Modes\n\n| Mode               | Purpose                | When Used         |\n| ------------------ | ---------------------- | ----------------- |\n| **Browse\u002FVirtual** | Read content           | Default reading   |\n| **Focus\u002FForms**    | Interact with controls | Filling forms     |\n| **Application**    | Custom widgets         | ARIA applications |\n\n## VoiceOver (macOS)\n\n### Setup\n\n```\nEnable: System Preferences → Accessibility → VoiceOver\nToggle: Cmd + F5\nQuick Toggle: Triple-press Touch ID\n```\n\n### Essential Commands\n\n```\nNavigation:\nVO = Ctrl + Option (VoiceOver modifier)\n\nVO + Right Arrow   Next element\nVO + Left Arrow    Previous element\nVO + Shift + Down  Enter group\nVO + Shift + Up    Exit group\n\nReading:\nVO + A             Read all from cursor\nCtrl               Stop speaking\nVO + B             Read current paragraph\n\nInteraction:\nVO + Space         Activate element\nVO + Shift + M     Open menu\nTab                Next focusable element\nShift + Tab        Previous focusable element\n\nRotor (VO + U):\nNavigate by: Headings, Links, Forms, Landmarks\nLeft\u002FRight Arrow   Change rotor category\nUp\u002FDown Arrow      Navigate within category\nEnter              Go to item\n\nWeb Specific:\nVO + Cmd + H       Next heading\nVO + Cmd + J       Next form control\nVO + Cmd + L       Next link\nVO + Cmd + T       Next table\n```\n\n### Testing Checklist\n\n```markdown\n## VoiceOver Testing Checklist\n\n### Page Load\n\n- [ ] Page title announced\n- [ ] Main landmark found\n- [ ] Skip link works\n\n### Navigation\n\n- [ ] All headings discoverable via rotor\n- [ ] Heading levels logical (H1 → H2 → H3)\n- [ ] Landmarks properly labeled\n- [ ] Skip links functional\n\n### Links & Buttons\n\n- [ ] Link purpose clear\n- [ ] Button actions described\n- [ ] New window\u002Ftab announced\n\n### Forms\n\n- [ ] All labels read with inputs\n- [ ] Required fields announced\n- [ ] Error messages read\n- [ ] Instructions available\n- [ ] Focus moves to errors\n\n### Dynamic Content\n\n- [ ] Alerts announced immediately\n- [ ] Loading states communicated\n- [ ] Content updates announced\n- [ ] Modals trap focus correctly\n\n### Tables\n\n- [ ] Headers associated with cells\n- [ ] Table navigation works\n- [ ] Complex tables have captions\n```\n\n### Common Issues & Fixes\n\n```html\n\u003C!-- Issue: Button not announcing purpose -->\n\u003Cbutton>\u003Csvg>...\u003C\u002Fsvg>\u003C\u002Fbutton>\n\n\u003C!-- Fix -->\n\u003Cbutton aria-label=\"Close dialog\">\u003Csvg aria-hidden=\"true\">...\u003C\u002Fsvg>\u003C\u002Fbutton>\n\n\u003C!-- Issue: Dynamic content not announced -->\n\u003Cdiv id=\"results\">New results loaded\u003C\u002Fdiv>\n\n\u003C!-- Fix -->\n\u003Cdiv id=\"results\" role=\"status\" aria-live=\"polite\">New results loaded\u003C\u002Fdiv>\n\n\u003C!-- Issue: Form error not read -->\n\u003Cinput type=\"email\" \u002F>\n\u003Cspan class=\"error\">Invalid email\u003C\u002Fspan>\n\n\u003C!-- Fix -->\n\u003Cinput type=\"email\" aria-invalid=\"true\" aria-describedby=\"email-error\" \u002F>\n\u003Cspan id=\"email-error\" role=\"alert\">Invalid email\u003C\u002Fspan>\n```\n\n## NVDA (Windows)\n\n### Setup\n\n```\nDownload: nvaccess.org\nStart: Ctrl + Alt + N\nStop: Insert + Q\n```\n\n### Essential Commands\n\n```\nNavigation:\nInsert = NVDA modifier\n\nDown Arrow         Next line\nUp Arrow           Previous line\nTab                Next focusable\nShift + Tab        Previous focusable\n\nReading:\nNVDA + Down Arrow  Say all\nCtrl               Stop speech\nNVDA + Up Arrow    Current line\n\nHeadings:\nH                  Next heading\nShift + H          Previous heading\n1-6                Heading level 1-6\n\nForms:\nF                  Next form field\nB                  Next button\nE                  Next edit field\nX                  Next checkbox\nC                  Next combo box\n\nLinks:\nK                  Next link\nU                  Next unvisited link\nV                  Next visited link\n\nLandmarks:\nD                  Next landmark\nShift + D          Previous landmark\n\nTables:\nT                  Next table\nCtrl + Alt + Arrows Navigate cells\n\nElements List (NVDA + F7):\nShows all links, headings, form fields, landmarks\n```\n\n### Browse vs Focus Mode\n\n```\nNVDA automatically switches modes:\n- Browse Mode: Arrow keys navigate content\n- Focus Mode: Arrow keys control interactive elements\n\nManual switch: NVDA + Space\n\nWatch for:\n- \"Browse mode\" announcement when navigating\n- \"Focus mode\" when entering form fields\n- Application role forces forms mode\n```\n\n### Testing Script\n\n```markdown\n## NVDA Test Script\n\n### Initial Load\n\n1. Navigate to page\n2. Let page finish loading\n3. Press Insert + Down to read all\n4. Note: Page title, main content identified?\n\n### Landmark Navigation\n\n1. Press D repeatedly\n2. Check: All main areas reachable?\n3. Check: Landmarks properly labeled?\n\n### Heading Navigation\n\n1. Press Insert + F7 → Headings\n2. Check: Logical heading structure?\n3. Press H to navigate headings\n4. Check: All sections discoverable?\n\n### Form Testing\n\n1. Press F to find first form field\n2. Check: Label read?\n3. Fill in invalid data\n4. Submit form\n5. Check: Errors announced?\n6. Check: Focus moved to error?\n\n### Interactive Elements\n\n1. Tab through all interactive elements\n2. Check: Each announces role and state\n3. Activate buttons with Enter\u002FSpace\n4. Check: Result announced?\n\n### Dynamic Content\n\n1. Trigger content update\n2. Check: Change announced?\n3. Open modal\n4. Check: Focus trapped?\n5. Close modal\n6. Check: Focus returns?\n```\n\n## JAWS (Windows)\n\n### Essential Commands\n\n```\nStart: Desktop shortcut or Ctrl + Alt + J\nVirtual Cursor: Auto-enabled in browsers\n\nNavigation:\nArrow keys         Navigate content\nTab                Next focusable\nInsert + Down      Read all\nCtrl               Stop speech\n\nQuick Keys:\nH                  Next heading\nT                  Next table\nF                  Next form field\nB                  Next button\nG                  Next graphic\nL                  Next list\n;                  Next landmark\n\nForms Mode:\nEnter              Enter forms mode\nNumpad +           Exit forms mode\nF5                 List form fields\n\nLists:\nInsert + F7        Link list\nInsert + F6        Heading list\nInsert + F5        Form field list\n\nTables:\nCtrl + Alt + Arrows Table navigation\n```\n\n## TalkBack (Android)\n\n### Setup\n\n```\nEnable: Settings → Accessibility → TalkBack\nToggle: Hold both volume buttons 3 seconds\n```\n\n### Gestures\n\n```\nExplore: Drag finger across screen\nNext: Swipe right\nPrevious: Swipe left\nActivate: Double tap\nScroll: Two finger swipe\n\nReading Controls (swipe up then right):\n- Headings\n- Links\n- Controls\n- Characters\n- Words\n- Lines\n- Paragraphs\n```\n\n## Common Test Scenarios\n\n### 1. Modal Dialog\n\n```html\n\u003C!-- Accessible modal structure -->\n\u003Cdiv\n  role=\"dialog\"\n  aria-modal=\"true\"\n  aria-labelledby=\"dialog-title\"\n  aria-describedby=\"dialog-desc\"\n>\n  \u003Ch2 id=\"dialog-title\">Confirm Delete\u003C\u002Fh2>\n  \u003Cp id=\"dialog-desc\">This action cannot be undone.\u003C\u002Fp>\n  \u003Cbutton>Cancel\u003C\u002Fbutton>\n  \u003Cbutton>Delete\u003C\u002Fbutton>\n\u003C\u002Fdiv>\n```\n\n```javascript\n\u002F\u002F Focus management\nfunction openModal(modal) {\n  \u002F\u002F Store last focused element\n  lastFocus = document.activeElement;\n\n  \u002F\u002F Move focus to modal\n  modal.querySelector(\"h2\").focus();\n\n  \u002F\u002F Trap focus\n  modal.addEventListener(\"keydown\", trapFocus);\n}\n\nfunction closeModal(modal) {\n  \u002F\u002F Return focus\n  lastFocus.focus();\n}\n\nfunction trapFocus(e) {\n  if (e.key === \"Tab\") {\n    const focusable = modal.querySelectorAll(\n      'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])',\n    );\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n\n    if (e.shiftKey && document.activeElement === first) {\n      last.focus();\n      e.preventDefault();\n    } else if (!e.shiftKey && document.activeElement === last) {\n      first.focus();\n      e.preventDefault();\n    }\n  }\n\n  if (e.key === \"Escape\") {\n    closeModal(modal);\n  }\n}\n```\n\n### 2. Live Regions\n\n```html\n\u003C!-- Status messages (polite) -->\n\u003Cdiv role=\"status\" aria-live=\"polite\" aria-atomic=\"true\">\n  \u003C!-- Content updates will be announced after current speech -->\n\u003C\u002Fdiv>\n\n\u003C!-- Alerts (assertive) -->\n\u003Cdiv role=\"alert\" aria-live=\"assertive\">\n  \u003C!-- Content updates interrupt current speech -->\n\u003C\u002Fdiv>\n\n\u003C!-- Progress updates -->\n\u003Cdiv\n  role=\"progressbar\"\n  aria-valuenow=\"75\"\n  aria-valuemin=\"0\"\n  aria-valuemax=\"100\"\n  aria-label=\"Upload progress\"\n>\u003C\u002Fdiv>\n\n\u003C!-- Log (additions only) -->\n\u003Cdiv role=\"log\" aria-live=\"polite\" aria-relevant=\"additions\">\n  \u003C!-- New messages announced, removals not -->\n\u003C\u002Fdiv>\n```\n\n### 3. Tab Interface\n\n```html\n\u003Cdiv role=\"tablist\" aria-label=\"Product information\">\n  \u003Cbutton role=\"tab\" id=\"tab-1\" aria-selected=\"true\" aria-controls=\"panel-1\">\n    Description\n  \u003C\u002Fbutton>\n  \u003Cbutton\n    role=\"tab\"\n    id=\"tab-2\"\n    aria-selected=\"false\"\n    aria-controls=\"panel-2\"\n    tabindex=\"-1\"\n  >\n    Reviews\n  \u003C\u002Fbutton>\n\u003C\u002Fdiv>\n\n\u003Cdiv role=\"tabpanel\" id=\"panel-1\" aria-labelledby=\"tab-1\">\n  Product description content...\n\u003C\u002Fdiv>\n\n\u003Cdiv role=\"tabpanel\" id=\"panel-2\" aria-labelledby=\"tab-2\" hidden>\n  Reviews content...\n\u003C\u002Fdiv>\n```\n\n```javascript\n\u002F\u002F Tab keyboard navigation\ntablist.addEventListener(\"keydown\", (e) => {\n  const tabs = [...tablist.querySelectorAll('[role=\"tab\"]')];\n  const index = tabs.indexOf(document.activeElement);\n\n  let newIndex;\n  switch (e.key) {\n    case \"ArrowRight\":\n      newIndex = (index + 1) % tabs.length;\n      break;\n    case \"ArrowLeft\":\n      newIndex = (index - 1 + tabs.length) % tabs.length;\n      break;\n    case \"Home\":\n      newIndex = 0;\n      break;\n    case \"End\":\n      newIndex = tabs.length - 1;\n      break;\n    default:\n      return;\n  }\n\n  tabs[newIndex].focus();\n  activateTab(tabs[newIndex]);\n  e.preventDefault();\n});\n```\n\n## Debugging Tips\n\n```javascript\n\u002F\u002F Log what screen reader sees\nfunction logAccessibleName(element) {\n  const computed = window.getComputedStyle(element);\n  console.log({\n    role: element.getAttribute(\"role\") || element.tagName,\n    name:\n      element.getAttribute(\"aria-label\") ||\n      element.getAttribute(\"aria-labelledby\") ||\n      element.textContent,\n    state: {\n      expanded: element.getAttribute(\"aria-expanded\"),\n      selected: element.getAttribute(\"aria-selected\"),\n      checked: element.getAttribute(\"aria-checked\"),\n      disabled: element.disabled,\n    },\n    visible: computed.display !== \"none\" && computed.visibility !== \"hidden\",\n  });\n}\n```\n\n## Best Practices\n\n### Do's\n\n- **Test with actual screen readers** - Not just simulators\n- **Use semantic HTML first** - ARIA is supplemental\n- **Test in browse and focus modes** - Different experiences\n- **Verify focus management** - Especially for SPAs\n- **Test keyboard only first** - Foundation for SR testing\n\n### Don'ts\n\n- **Don't assume one SR is enough** - Test multiple\n- **Don't ignore mobile** - Growing user base\n- **Don't test only happy path** - Test error states\n- **Don't skip dynamic content** - Most common issues\n- **Don't rely on visual testing** - Different experience\n",{"name":5,"description":7},"main","62c7af5ced2c21355d148c243edb6d5921cca1a6",".agents\u002Fskills\u002Fscreen-reader-testing",8,"https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent","https:\u002F\u002Fgithub.com\u002FRudyCity","2026-11-14 22:58:49",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add RudyCity\u002Fsuperagent --skill screen-reader-testing",{"tool":36,"command":37},"bunx","bunx skills add RudyCity\u002Fsuperagent --skill screen-reader-testing",{"tool":39,"command":40},"pnpm","pnpm dlx skills add RudyCity\u002Fsuperagent --skill screen-reader-testing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fscreen-reader-testing\u002FSKILL.md",true,[],[45,52,59,66,73,80],{"skillNo":46,"name":47,"nameZh":6,"description":48,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":18},"01M75GP28CM6QCSXSHKFF3NNKS","telegram_bot","Use Telegram Bot when the user asks for Telegram Bot or this provider's API.","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002Fmuse-bridge-kit\u002Fskills\u002Ftelegram-bot\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":18},"01M75GNZGZYM7NWDV6MBP3HS14","superagent-bridge","Operate the Muse\u003C->superagent Telegram bridge: poll the private group for task_request\u002Ftask_result envelopes, validate senders, and reply with task_batch\u002Ftask_done as Muse (the remote brain).","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002Fmuse-bridge-kit\u002Fskills\u002Fsuperagent-bridge\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":18},"01M75GNHN19HJWZ7NAPM5E5JCV","Writing Skills","TDD for process documentation - test with subagents before writing, iterate until bulletproof","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":18},"01M75GNCQEKVRA4FH161NZPZNB","writing-shape","Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format (lists, tables, callouts, quotes) at each step. Use when the user has a pile of notes, fragments, or a rough draft and wants help turning it into something publishable.","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-shape\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M75GNAF9NAYCSTBDZDGMK0DZ","Writing Plans","Create detailed implementation plans with bite-sized tasks for engineers with zero codebase context","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":18},"01M75GN72EV0V5NQAW9CSPFRFH","writing-guidelines","Review docs\u002Fprose for Writing Guidelines compliance. Use when asked to \"review my docs\", \"check writing style\", \"audit prose\", \"review docs voice and tone\", or \"check this page against the writing handbook\".","https:\u002F\u002Fgithub.com\u002FRudyCity\u002Fsuperagent\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-guidelines\u002FSKILL.md",[],[]]