使い方ガイドへスキップ
screen-reader-testing作者 Seth Hobson

Screen Reader Testing スキル。

デザインレビュー向けの Claude Code と Codex スキル:VoiceOver、NVDA、JAWS スクリーンリーダーでウェブアプリをテストします。

  • デザインレビュー & アクセシビリティ
  • レビューレポート
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年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

macOS、Windows、iOS、Androidの各プラットフォームでVoiceOver、NVDA、JAWS、TalkBack、Narratorといったスクリーンリーダーを使用してWebアプリケーションをテストします。実際のスクリーンリーダーを用いたハンズオンテストにより、スクリーンリーダーとの互換性を検証し、支援技術に関する問題をデバッグし、適切なARIA実装を確認します。

ナビゲーション、フォーム、動的コンテンツのアナウンス、フォーカス管理、モーダルダイアログを対象とします。プラットフォーム固有のコマンド、テストチェックリスト、一般的なアクセシビリティパターンのコード例を提供します。異なるスクリーンリーダーモード(ブラウズ、フォーカス、アプリケーション)でのテストを重視し、ARIAを補助的な強化として用いたセマンティックHTMLを優先します。

生成されるもの

  • ページ読み込み、ナビゲーション、リンク、フォーム、動的コンテンツ、テーブルを対象とする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のスクロールには2本指スワイプといったコマンドを実行します。

  3. 03
    ブラウズモードとフォーカスモードでテストする

    コンテンツを読むためのブラウズモードとフォームコントロールを操作するためのフォーカスモードの間で、スクリーンリーダーが正しく切り替わることを確認し、モードのアナウンスに注意します。

  4. 04
    セマンティック構造とARIAを検証する

    見出しがローターや要素リストから発見可能であること、ランドマークが適切にラベル付けされていること、ライブリージョンが更新をアナウンスすること、dialog、tab、progressbarなどのロールが正しく実装されていることを確認します。

  5. 05
    フォーカス管理とキーボード操作を確認する

    フォーム送信後にフォーカスがエラーに移動すること、モーダルがフォーカスを正しくトラップし閉じたときにフォーカスを返すこと、タブインターフェースが矢印キー、Home、Endに応答することを確認します。

  6. 06
    動的コンテンツのアナウンスをテストする

    コンテンツの更新をトリガーし、role="status"とaria-live="polite"が現在の発話の後に変更をアナウンスすること、role="alert"が即座に割り込むことを確認します。

02 適合性を確認

screen-reader-testing スキルを使用するタイミング

この種のデザインレビューを行う場合は、Claude Code または Codex で screen-reader-testing スキルを使用してください。適合性と制限については、スキル自体のファイルから引用しています。

適している場合

  • Webアプリケーションがスクリーンリーダーソフトウェアで正しく動作することを検証する
  • 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. 1種類のスクリーンリーダーだけでテストしない

    単一のスクリーンリーダーでのテストでは不十分です。スクリーンリーダーはプラットフォームごとに動作や使用パターンが異なります。

  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 ブランチ main
スキルファイル
plugins/accessibility-compliance/skills/screen-reader-testing/SKILL.md 検証時にコンテンツチェックサムを記録; コミット 4236bb9
License
MIT LICENSE より
リポジトリスター数
39,635 GitHub スナップショットは 2026-09-14 に取得された wshobson/agents リポジトリ全体のもので、このカタログには 18 のスキルが含まれています。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 を含むスクリーンリーダーで Web アプリケーションをテストします。スクリーンリーダーの互換性検証、アクセシビリティ問題のデバッグ、支援技術サポートの確認に使用します。」

SKILL.md の front-matter 説明文です。完全なファイルは約 12,020 文字です。GitHub で完全なファイルを読む。

Screen Reader Testing

実際のデザインレビュータスクで 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 で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

  • Web、スライド、プロトタイプ、ダッシュボード、画像、動画
  • 140+ のデザインシステムと完全なテンプレート/スキルライブラリ
  • ローカル Codex と 21+ のコーディングエージェントを接続 · 無料
無料ダウンロード

macOS と Windows に対応