使い方ガイドへスキップ
accessibility作者 Addy Osmani

Accessibility スキル。

デザインレビューのための Claude Code と Codex スキル:WCAG 2.2 に従って Web アクセシビリティを監査・改善します。

  • デザインレビュー & アクセシビリティ
  • レビューレポート
addyosmani/web-quality-skills · skills/accessibility/SKILL.mdSKILL.md
--- name: accessibility description: Audit and improve web accessibility following WCAG 2.2 guidelines. Use when asked to "improve accessibility", "a11y audit", "WCAG compliance", "screen reader support", "keyboard navigation", or "make accessible". --- ## Evidence-led audit workflow ## WCAG Principles: POUR ## Conformance levels ## Perceivable ## Operable ## Understandable
2026年9月14日にアップストリームファイルから読み取られたフロントマターとセクション見出し · 全14,265文字

01 できること

Claude Code と Codex でアクセシビリティスキルが担うこと

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

このスキルは WCAG 2.2 に照らしてウェブアクセシビリティを監査し、修正します。構成の軸は POUR — Perceivable、Operable、Understandable、Robust — と、A、AA、AAA の適合レベルです。エビデンス主導のワークフローを実行します。レンダリング済みのページが利用できる場合は、Lighthouse のアクセシビリティ監査をライブで実行し(Chrome DevTools MCP の lighthouse_audit)、失敗したノードを使ってコンポーネントを特定し、take_snapshot でアクセシビリティツリーを検査したうえで、ソースを修正して再実行します。

ライブツールが使えない場合でも、Lighthouse CLI または axe が自動化できる範囲をカバーし、同じ手動チェックは変わりなく必要です。alt テキスト、コントラスト比、フォーカスの可視性、ターゲットサイズ、モーションの低減、フォームのエラー、アクセシブルな認証に関するコードレベルのルールに加え、critical、serious、moderate の順にランク付けしたトリアージリストを提供します。

生成されるもの

  • 優先順位を付けた問題リスト。Critical(直ちに修正)、Serious(リリース前に修正)、Moderate(早めに修正)の階層に分け、具体的な例を挙げて示します。
  • 修正済みのマークアップと、そのまま貼り付けられるスニペット。アイコンボタンのラベルを支援技術に伝えるための visually-hidden ユーティリティなどが含まれます。
  • references/A11Y-PATTERNS.md にある完全なリファレンス実装。フォームラベル、モーダルのフォーカストラップ、スキップリンク、ARIA タブ、ライブリージョン、エラー処理、スクリーンリーダーコマンドを扱います。
プロンプト例を見る ↗

仕組み

  1. 01
    ライブのアクセシビリティ監査を実行する

    レンダリング済みのページから始め、Lighthouse のアクセシビリティ監査をライブで実行します。一般公開ページには mobile navigation モードを、再読み込みすると認証状態が失われる場合は snapshot モードを使います。

  2. 02
    失敗しているコンポーネントを特定する

    失敗した監査ノードを使い、リポジトリ全体を一般的なパターンで grep するのではなく、特定のコンポーネントやテンプレートを指し示します。

  3. 03
    アクセシビリティツリーを検査する

    レンダリング済みのアクセシビリティツリーのスナップショットを読み、名前、ロール、状態、ランドマーク、見出し構造を確認したうえで、影響を受けるフローをキーボードで操作します。

  4. 04
    ソースを修正して再検証する

    レンダリング結果ではなくソースを変更し、同じ監査と同じ手動操作を繰り返して修正を確認します。

  5. 05
    CLI ツールにフォールバックする

    ライブのブラウザツールが使えない場合は、Lighthouse CLI または axe の出力と、同じ手動チェックを組み合わせます。自動化だけではバリアの一部しかカバーできないためです。

02 適合性を確認

accessibility スキルを使用するタイミング

この種のデザインレビューが必要な場合は、Claude Code または Codex でアクセシビリティスキルを使用してください。以下の適合性と制限事項はスキル自体のファイルから引用されています。

適している場合

  • a11y 監査、WCAG 準拠、スクリーンリーダー対応、キーボードナビゲーション、「アクセシブルにして」といった表現のリクエスト。
  • Level AA を目標とするチーム。このファイルでは AA を標準的なターゲットであり、多くの法域で法的要件と位置づけています。
  • 固定ヘッダーや固定フッターがキーボードのフォーカスリングを覆い隠してしまうページ。WCAG 2.2 で新たに加わった達成基準です。
  • マウスなしで完全に操作できなければならないインターフェース。非インタラクティブな要素で作られたカスタムウィジェットも含まれます。

境界を知る

  • インラインテキストリンク、ブラウザがサイズを制御する要素、および24pxの円が他のターゲットと重ならないターゲットは、最小ターゲットサイズのルールから除外されます。
  • レベルAAAは要件ではなく任意として扱われます。
  • このファイルが指摘するアンチパターン: ネイティブのbuttonに手動のキーボード起動を追加することです。EnterとSpaceがすでにclickを発火するため、二重にトリガーされます。

提供すべきもの

  • レンダリングされたページ監査、ノードリスト、アクセシビリティツリーはいずれもここから取得されるため、ライブワークフローはレンダリングされたページが利用可能になった時点で始まります。
  • ページのナビゲーションモード一般公開ページなのか、リロードすると認証済みの状態やユーザーが作成した状態が失われるフローなのかをエージェントに伝えてください。モバイルナビゲーションとスナップショットモードのどちらを使うかがこれで決まります。
  • 試すべきキーボードフロー監査中は、アクセシビリティツリーの検査と併せて、影響を受けるインタラクションをキーボードで操作できるようにしておいてください。

03 スキルの内部

アクセシビリティのスキルがClaude CodeとCodexに与えるルール

SKILL.mdがエージェントに設定する7つの具体的な指示、デフォルト、制限 — ファイルの中で結果を変える部分です。

  1. まずネイティブ要素を使う

    ネイティブのbutton、アンカー、フォームコントロールは、Enter/Spaceによる起動、フォーカス、支援技術向けのセマンティクスをすでに処理します。そのため、手動のキーボード処理は、置き換えられない要素のための最終手段です。

  2. フォーカスを視認できる状態に保つ

    アウトラインを削除しないでください。

  3. 24 × 24の最小ターゲットサイズを守る

    AAでは、インタラクティブなターゲットは少なくとも24 × 24 CSSピクセル必要です。ボタン、チェックボックス、ラジオボタンのラベルには、快適なタッチサイズとして44 × 44を推奨します。

  4. 要求に応じてアニメーションを無効化する

    prefers-reduced-motion の下では、このファイルはアニメーションとトランジションの時間を0.01msに縮め、イテレーション回数を1に制限し、scroll-behaviorをautoにリセットします。

  5. 色だけで伝えない

    エラー状態は色にアイコンとテキストを組み合わせます。マークアップでは aria-invalid="true" と、エラーメッセージの要素を指す aria-describedby を組み合わせます。

  6. エラーを通知してフォーカスする

    role="alert" または aria-live でエラーをスクリーンリーダーに伝え、問題のあるフィールドにマークを付け、送信時に最初のエラーへフォーカスを移動します。

  7. 認証の認知負荷を低く保つ

    ログインフローは、パスワードを覚えることやパズルを解くことに依存してはなりません。ただし、コピー&ペーストや自動入力が機能する場合、パスキーやメールリンクなどの代替手段がある場合、またはテストが物体認識や個人に関わる内容を用いる場合は除きます。

04 実際に使う

Claude Code または Codex に accessibility をインストール

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codex、またはお使いのエージェントに accessibility を追加

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/addyosmani/web-quality-skills --skill accessibility

skills CLI の汎用形式(skills/accessibility/SKILL.md 用)。リポジトリが独自のパスを記載している場合があります。

スキルに最初のデザインレビュータスクを与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
Audit [page URL or route] with Lighthouse and then fix the accessibility problems in the source. The form inputs in [component path] have no programmatically associated labels, the icon buttons have no accessible names, and focus outlines are being removed on [element]. Re-run the same audit afterwards and check keyboard navigation and target sizes.

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • ページ全体を Tab で移動し、Enter と Space でコントロールを操作します。

OpenDesign では、SKILL.md のリンクから accessibility をインポートします:Plugins → Add → Skill → Import from link。その後、トップバーで選択します。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

Repository
github.com/addyosmani/web-quality-skills ブランチ main
スキルファイル
skills/accessibility/SKILL.md 検証時にコンテンツチェックサムを記録。コミット afa8da9
License
MIT LICENSE より。SKILL.md には「MIT」と記載されています。
リポジトリスター数
2,786 addyosmani/web-quality-skills リポジトリ全体の GitHub スナップショットを 2026-09-14 に取得。accessibility の評価や使用数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。
スキル自身による説明
「WCAG 2.2ガイドラインに従ってウェブアクセシビリティを監査・改善します。「アクセシビリティ改善」「a11y監査」「WCAG準拠」「スクリーンリーダー対応」「キーボードナビゲーション」「アクセシブルにする」とリクエストされた際に使用します。」

SKILL.md のフロントマター説明。ファイル全体は約 14,265 文字です。GitHub で完全なファイルを読む。

Accessibility

実際のデザインレビュータスクで accessibility を実行します。

OpenDesignをダウンロードし、SKILL.mdリンクからaccessibilityをインポートして、上記のプロンプトを貼り付け、結果の前にプランを確認してください。

ターミナル
npx skills add https://github.com/addyosmani/web-quality-skills --skill accessibility

OpenDesign デスクトップ版

ひとつのデザインシステムで、すべての制作物をブランドらしく

完全な Vibe Design Workspace で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

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

macOS と Windows に対応