사용 가이드로 건너뛰기
screen-reader-testing작성자 Seth Hobson

Screen Reader Testing 스킬.

디자인 검토를 위한 Claude Code 및 Codex 스킬: VoiceOver, NVDA, JAWS 스크린 리더로 웹 앱을 테스트합니다.

  • Design Review & Accessibility
  • 리뷰 리포트
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
2026-09-14에 업스트림 파일에서 읽은 전면 메타데이터 및 섹션 제목 · 전체 12,020자

01 기능

Claude Code와 Codex에서 screen-reader-testing 스킬이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

macOS, Windows, iOS, Android 플랫폼에서 VoiceOver, NVDA, JAWS, TalkBack, Narrator 스크린 리더로 웹 애플리케이션을 테스트합니다. 실제 스크린 리더를 이용한 실습 테스트를 통해 스크린 리더 호환성을 검증하고, 보조 기술 관련 문제를 디버깅하며, 올바른 ARIA 구현을 보장합니다.

내비게이션, 폼, 동적 콘텐츠 알림, 포커스 관리, 모달 다이얼로그를 다룹니다. 플랫폼별 명령어, 테스트 체크리스트, 일반적인 접근성 패턴에 대한 코드 예제를 제공합니다. 다양한 스크린 리더 모드(browse, focus, application)에서의 테스트를 강조하며, 시맨틱 HTML을 우선하고 ARIA는 보조적 강화로 활용할 것을 권장합니다.

산출물

  • 페이지 로드, 내비게이션, 링크, 폼, 동적 콘텐츠, 표를 다루는 VoiceOver 테스트 체크리스트
  • 초기 로드, 랜드마크, 헤딩, 폼, 인터랙티브 요소, 동적 콘텐츠에 대한 단계별 지침을 담은 NVDA 테스트 스크립트
  • 레이블 없는 버튼, 알림이 없는 동적 콘텐츠, 폼 오류 등 흔한 문제에 대한 접근성 패턴과 해결 방법을 보여주는 HTML 코드 예시
  • 모달 다이얼로그, 포커스 트래핑, 탭 인터페이스 키보드 내비게이션을 포함한 포커스 관리용 JavaScript 코드
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    플랫폼별 주요 스크린 리더로 테스트하기

    Windows에서는 Firefox와 함께 NVDA(사용률 31%)를, macOS 및 iOS에서는 Safari와 함께 VoiceOver(사용률 15%)를, Chrome과 함께 JAWS(사용률 40%)를, Android에서는 TalkBack(사용률 10%)을, Edge와 함께 Narrator(사용률 4%)를 사용합니다.

  2. 02
    스크린 리더별 명령어로 탐색하기

    VoiceOver 요소 탐색을 위한 VO+오른쪽 화살표, NVDA 헤딩 이동을 위한 H, JAWS 링크 목록을 위한 Insert+F7, TalkBack 스크롤을 위한 두 손가락 스와이프와 같은 명령을 실행합니다.

  3. 03
    브라우즈 모드와 포커스 모드에서 테스트하기

    콘텐츠를 읽기 위한 브라우즈 모드와 폼 컨트롤과 상호작용하기 위한 포커스 모드 사이를 스크린 리더가 올바르게 전환하는지 확인하고, 모드 전환 알림을 주의해서 확인합니다.

  4. 04
    시맨틱 구조와 ARIA 검증하기

    헤딩이 로터나 요소 목록을 통해 발견 가능한지, 랜드마크에 올바른 레이블이 지정되어 있는지, 라이브 리전이 업데이트를 알리는지, dialog, tab, progressbar와 같은 역할이 올바르게 구현되어 있는지 확인합니다.

  5. 05
    포커스 관리와 키보드 상호작용 검증하기

    폼 제출 후 포커스가 오류로 이동하는지, 모달이 포커스를 올바르게 가두고 닫힐 때 포커스를 복원하는지, 탭 인터페이스가 화살표 키, Home, End에 반응하는지 확인합니다.

  6. 06
    동적 콘텐츠 알림 테스트하기

    콘텐츠 업데이트를 트리거하여 aria-live="polite"가 지정된 role="status"는 현재 음성 출력이 끝난 후 변경 사항을 알리고, role="alert"는 즉시 알림을 중단시키는지 확인합니다.

02 적합성 확인

screen-reader-testing 스킬을 사용하는 경우

이러한 종류의 디자인 리뷰 작업에는 Claude Code 또는 Codex에서 screen-reader-testing 스킬을 사용하십시오. 아래 적합성 및 제한 사항은 스킬 자체 파일에서 가져온 것입니다.

적합한 경우

  • 웹 애플리케이션이 스크린 리더 소프트웨어와 올바르게 작동하는지 검증
  • ARIA 역할, 상태, 속성이 올바르게 구현되었는지 테스트
  • 보조 기술 사용자에게 영향을 미치는 문제 디버깅
  • 폼 컨트롤이 올바른 레이블과 오류 알림을 통해 접근 가능한지 확인
  • 동적 콘텐츠 업데이트가 스크린 리더 사용자에게 알림되는지 테스트

한계 인지하기

  • 접근성 검증을 시각적 검토에만 의존
  • 오류 상태와 예외 상황을 검증하지 않고 성공 경로만 테스트
  • iOS 및 Android 모바일 스크린 리더 테스트 건너뛰기

03 스킬 내부

screen-reader-testing 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 시뮬레이터가 아닌 실제 스크린 리더로 테스트하기

    시뮬레이션 도구나 에뮬레이터가 아니라 실제 스크린 리더 소프트웨어(VoiceOver, NVDA, JAWS, TalkBack, Narrator)를 사용하여 테스트합니다.

  2. 시맨틱 HTML을 먼저 사용하고, ARIA는 보조적으로 사용하기

    ARIA 속성을 추가하기 전에 네이티브 HTML 요소로 인터페이스를 구성합니다. ARIA는 시맨틱 HTML을 보완하는 역할을 하며 이를 대체하지 않습니다.

  3. 최소 커버리지: macOS와 iOS에서 NVDA+Firefox, VoiceOver+Safari

    최소한 Windows에서 NVDA와 Firefox 조합, macOS에서 VoiceOver와 Safari 조합, iOS에서 VoiceOver와 Safari 조합으로 테스트한 후에야 애플리케이션이 검증된 것으로 간주합니다.

  4. 탐색 모드와 포커스 모드 모두에서 테스트하기

    스크린 리더가 자동 또는 수동으로 두 모드를 전환하므로, 탐색 모드(방향키로 콘텐츠를 읽는 모드)와 포커스 모드(컨트롤과 상호작용하는 모드) 모두에서 경험을 확인합니다.

  5. 스크린 리더 테스트 전에 키보드 전용 탐색 테스트하기

    키보드 전용 테스트는 스크린 리더 접근성의 기반이 되고 상호작용 문제를 조기에 발견할 수 있으므로 먼저 완료합니다.

  6. 단일 페이지 애플리케이션의 포커스 관리 확인하기

    특히 전체 새로고침 없이 페이지 전환이 이루어지는 SPA에서, 콘텐츠가 동적으로 변경될 때 포커스가 올바르게 관리되는지 확인합니다.

  7. 단 하나의 스크린 리더로만 테스트하지 않기

    단일 스크린 리더로 하는 테스트는 충분하지 않습니다. 스크린 리더마다 플랫폼별로 동작과 사용 패턴이 다릅니다.

  8. 동적 콘텐츠와 오류 상태를 항상 테스트하기

    동적으로 업데이트되는 콘텐츠에 대한 테스트를 건너뛰거나 테스트 범위를 정상 경로로만 제한하지 마십시오. 동적 콘텐츠와 오류 처리는 접근성 문제가 가장 흔히 발생하는 부분입니다.

04 활용하기

Claude Code 또는 Codex에 screen-reader-testing 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용자 에이전트에 screen-reader-testing 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

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

plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소에서 자체 경로를 문서화할 수 있습니다.

스킬에 첫 번째 디자인 리뷰 작업 부여

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

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.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • 페이지가 로드될 때 페이지 제목이 안내되는지 확인
  • 로터(VoiceOver) 또는 엘리먼트 목록(NVDA, JAWS)을 사용하여 모든 제목을 찾을 수 있는지 확인
  • 레이블이 연결된 입력 필드와 함께 읽히는지 확인
  • 유효하지 않은 데이터로 폼을 제출했을 때 오류 메시지가 안내되는지 확인
  • 모달 대화상자 내부에 포커스가 올바르게 갇혀 빠져나갈 수 없는지 확인

OpenDesign에서 SKILL.md 링크를 통해 screen-reader-testing을 가져옵니다: Plugins → Add → Skill → Import from link을 실행한 다음 상단 바에서 선택하십시오.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

Repository
github.com/wshobson/agents Branch main
스킬 파일
plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md 검증 시 기록된 콘텐츠 체크섬; 커밋 4236bb9
License
MIT LICENSE에서.
리포지토리 스타
39,635 이 카탈로그에 18개 스킬을 포함하는 wshobson/agents 저장소 전체에 대해 2026-09-14에 촬영된 GitHub 스냅샷입니다. screen-reader-testing의 평가 또는 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 이 스킬을 사용해야 할 때호환성 검증, ARIA 테스트, 보조 기술 디버깅, 폼 및 내비게이션 검증과 같은 시나리오를 나열합니다
  2. 핵심 개념플랫폼별 주요 스크린 리더와 사용 방식, 최소 테스트 우선순위, 탐색 모드·포커스 모드·애플리케이션 모드의 차이를 다룹니다
  3. VoiceOver(macOS)설정 방법, 보조 키를 포함한 필수 명령어, 로터 내비게이션, 테스트 체크리스트, 일반적인 HTML/ARIA 문제 해결법
  4. NVDA(Windows)설정 및 명령어, 헤딩과 랜드마크 내비게이션, 탐색 모드와 포커스 모드 전환, 단계별 테스트 스크립트
  5. JAWS(Windows)가상 커서를 포함한 필수 명령어, 요소 유형별 퀵키, 폼 모드, 테이블 내비게이션 단축키
  6. TalkBack(Android)설정 전환, 내비게이션 및 실행을 위한 터치 제스처, 읽기 단위 제어 옵션
  7. 일반적인 테스트 시나리오포커스 트랩이 있는 모달 대화상자, 라이브 리전, 키보드를 지원하는 탭 인터페이스에 대한 접근 가능한 패턴과 코드
  8. 디버깅 팁스크린 리더가 인식하는 대로 요소의 접근 가능한 이름, 역할, 상태, 표시 여부를 로그로 남기는 JavaScript 함수
  9. 모범 사례실제 테스트, 시맨틱 HTML 우선, 모드별 테스트, 포커스 관리, 단일 스크린 리더 검증 지양 등을 다루는 권장 사항과 주의 사항
스킬 자체 설명
"VoiceOver, NVDA, JAWS를 포함한 스크린 리더로 웹 애플리케이션을 테스트합니다. 스크린 리더 호환성 검증, 접근성 문제 디버깅, 보조 기술 지원 확인 시 사용합니다."

SKILL.md의 프론트매터 설명입니다. 전체 파일은 약 12,020자입니다. GitHub에서 전체 파일 읽기.

스크린 리더 테스트

실제 디자인 리뷰 작업에서 screen-reader-testing 실행

OpenDesign를 다운로드하고 SKILL.md 링크에서 screen-reader-testing을 임포트한 후 위 프롬프트를 붙여넣고 결과 전에 계획을 읽으십시오.

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

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원