Community생산성 & 협업github.com

wshobson/스크린리더-테스팅

VoiceOver, NVDA 및 JAWS를 포함한 스크린 리더로 웹 애플리케이션을 테스트합니다. 스크린 리더 호환성 검증, 접근성 문제 디버깅 또는 보조 기술 지원 확인 시 사용하세요.

스크린리더-테스팅란 무엇인가요?

이 스킬은 개발자가 VoiceOver, NVDA, JAWS와 같은 주요 스크린 리더를 사용하여 웹 애플리케이션의 접근성을 테스트할 수 있도록 지원합니다. 애플리케이션이 보조 기술과 올바르게 상호작용하는지 확인하고, 접근성 문제를 진단하며, 사용자 경험을 개선하는 데 유용합니다. macOS, Windows 및 Linux를 포함한 여러 플랫폼에서 작동하며, 각 운영 체제에 맞는 스크린 리더 설정 및 명령어를 제공합니다. 이 스킬은 SKILL.md 문서에 정의된 대로 CLI 도구와 함께 사용되어 테스트 프로세스를 자동화하고, 특정 접근성 기준을 충족하는지 확인합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wshobson/agents/tree/main/skills/screen-reader-testing

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

스크린리더-테스팅은(는) 무엇을 하나요?

VoiceOver, NVDA 및 JAWS를 포함한 스크린 리더로 웹 애플리케이션을 테스트합니다. 스크린 리더 호환성 검증, 접근성 문제 디버깅 또는 보조 기술 지원 확인 시 사용하세요.

지원 플랫폼

  • macOS: VoiceOver (내장)
  • Windows: NVDA (무료 오픈 소스), JAWS (상용)
  • Linux: Orca (내장, GNOME 데스크탑)

설치 및 설정

VoiceOver (macOS)

VoiceOver은 macOS에 내장되어 있으므로 별도 설치가 필요하지 않습니다. 활성화하려면:

# VoiceOver 켜기/끄기 단축키
Cmd + F5

# VoiceOver 유틸리티 열기
Cmd + F5를 누른 후, VoiceOver 유틸리티에서 설정

NVDA (Windows)

  1. NVDA 공식 웹사이트에서 다운로드합니다.
  2. 설치 프로그램을 실행하고 지침을 따릅니다.
  3. NVDA를 시작하려면 바탕화면 바로가기를 사용하거나 Ctrl + Alt + N을 누릅니다.

JAWS (Windows)

  1. JAWS 공식 웹사이트에서 다운로드합니다.
  2. 설치 프로그램을 실행하고 지침을 따릅니다.
  3. JAWS를 시작하려면 바탕화면 바로가기를 사용하거나 Insert + J를 누릅니다.

기본 명령어

VoiceOver (macOS)

명령어설명
VO + 오른쪽 화살표다음 요소로 이동
VO + 왼쪽 화살표이전 요소로 이동
VO + Shift + 아래쪽 화살표요소와 상호작용 시작
VO + Shift + 위쪽 화살표상호작용 종료
VO + H도움말 메뉴 열기

참고: VO는 Control + Option 키를 의미합니다.

NVDA (Windows)

명령어설명
NVDA + Tab다음 요소로 이동
NVDA + Shift + Tab이전 요소로 이동
NVDA + Space요소 활성화
NVDA + 위쪽 화살표부모 요소로 이동
NVDA + 아래쪽 화살표자식 요소로 이동
Insert + F7요소 목록 열기

참고: NVDA는 기본적으로 Insert 또는 Caps Lock 키입니다.

JAWS (Windows)

명령어설명
Insert + 아래쪽 화살표다음 요소로 이동
Insert + 위쪽 화살표이전 요소로 이동
Insert + Enter요소 활성화
Insert + F5양식 필드 목록 열기
Insert + F6헤딩 목록 열기

테스트 프로세스

  1. 스크린 리더 활성화: 위의 지침에 따라 스크린 리더를 켭니다.
  2. 웹 애플리케이션 열기: 테스트할 웹 애플리케이션을 브라우저에서 엽니다.
  3. 탐색: 스크린 리더 명령어를 사용하여 페이지를 탐색합니다.
  4. 검증: 다음 사항을 확인합니다:
    • 모든 대화형 요소(링크, 버튼, 양식 필드)에 접근 가능한지 확인
    • ARIA 랜드마크 및 레이블이 올바르게 작동하는지 확인
    • 이미지에 적절한 대체 텍스트가 있는지 확인
    • 동적 콘텐츠 업데이트가 올바르게 발표되는지 확인
  5. 문제 기록: 발견된 접근성 문제를 기록합니다.

일반적인 접근성 문제

  • 누락된 대체 텍스트: 이미지에 alt 속성이 없음
  • 잘못된 ARIA 사용: ARIA 속성이 잘못 적용됨
  • 키보드 트랩: 사용자가 키보드로 요소에 갇힘
  • 낮은 대비: 텍스트와 배경 간 대비가 충분하지 않음
  • 포커스 표시 부족: 키보드 포커스가 명확하게 표시되지 않음

리소스

기여

버그 리포트나 기능 제안은 GitHub 저장소에 제출해 주세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

wshobson/accessibility-compliance

Implement WCAG 2.2 compliant interfaces with mobile accessibility, inclusive design patterns, and assistive technology support. Use when auditing accessibility, implementing ARIA patterns, building for screen readers, or ensuring inclusive user experiences.

wshobson/airflow-dag-patterns

Build production Apache Airflow DAGs with best practices for operators, sensors, testing, and deployment. Use when creating data pipelines, orchestrating workflows, or scheduling batch jobs.

wshobson/angular-migration

Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and dependency injection updates. Use when upgrading AngularJS applications, planning framework migrations, or modernizing legacy Angular code.

wshobson/anti-reversing-techniques

Understand anti-reversing, obfuscation, and protection techniques encountered during software analysis. Use this skill when analyzing malware evasion techniques, when implementing anti-debugging protections for CTF challenges, when reverse engineering packed binaries, or when building security research tools that need to detect virtualized environments.

wshobson/api-design-principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

wshobson/architecture-decision-records

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

wshobson/architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or when debugging dependency cycles between application layers.

wshobson/async-python-patterns

Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.

wshobson/attack-tree-construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

wshobson/auth-implementation-patterns

Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.

wshobson/avoid-ai-writing

Audit and rewrite prose so it stops reading as machine-generated. Use this skill when asked to remove AI-isms, clean up AI writing, edit a draft for AI tells, audit a README, changelog, release note, PR description, or blog post for machine-sounding prose, or make text sound less like AI. Supports a detect-only mode, a rewrite mode, and an edit-in-place mode, with optional voice and context profiles.

wshobson/backtesting-frameworks

Build robust backtesting systems for trading strategies with proper handling of look-ahead bias, survivorship bias, and transaction costs. Use when developing trading algorithms, validating strategies, or building backtesting infrastructure.

wshobson/bash-defensive-patterns

Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance and safety.

wshobson/bats-testing-patterns

Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.

wshobson/bazel-build-optimization

Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.

wshobson/before-you-build

Pre-build product and feature risk review for founders, product managers, and AI-assisted builders. Use this skill when the user is about to build a landing page, MVP, SaaS product, internal tool, agent workflow, or major feature and needs to check demand, positioning, monetization, retention, trust, distribution, and adoption risk before implementation starts.

wshobson/billing-automation

Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.

wshobson/binary-analysis-patterns

Master binary analysis patterns including disassembly, decompilation, control flow analysis, and code pattern recognition. Use when analyzing executables, understanding compiled code, or performing static analysis on binaries.

wshobson/block-no-verify-hook

Configure a PreToolUse hook to prevent AI agents from skipping git pre-commit hooks with --no-verify and other bypass flags. Use when setting up Claude Code projects that enforce commit quality gates.

wshobson/brand-landingpage

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

관련 스킬