accessibility-wcag
WCAG準拠のアクセシビリティ設計を整理し、インクルーシブなUI実装と検証を支援するスキル。要件整理、実装方針、監査手順を一貫して整理する。Anchors:• WCAG 2.1 Guidelines / 適用: アクセシビリティ基準 / 目的: 準拠確認• WAI-ARIA Authoring Practices / 適用: ウィジェット実装 / 目的: ARIA実装指針• Inclusive Design Patterns (Heydon Pickering) / 適用: 実装パターン / 目的: ベストプラクティスTrigger:Use when implementing accessibility, ensuring WCAG compliance, or designing ARIA and screen reader support.accessibility, WCAG, ARIA, screen reader, inclusive design
When & Why to Use This Skill
This Claude skill streamlines the development of WCAG-compliant digital experiences by providing a structured framework for accessibility requirements, ARIA implementation, and rigorous validation. It helps teams transition from design to inclusive UI execution through automated audits, manual checklists, and industry-standard design patterns, ensuring software meets global accessibility standards.
Use Cases
- Case 1: Defining accessibility compliance levels (WCAG 2.1 A/AA/AAA) and technical requirements during the initial project planning phase.
- Case 2: Implementing complex UI components like modals and navigation menus using WAI-ARIA Authoring Practices to ensure full screen reader and keyboard compatibility.
- Case 3: Conducting comprehensive accessibility audits using a mix of automated scripts and manual verification steps to identify and remediate inclusive design gaps.
- Case 4: Generating detailed accessibility validation reports and maintenance logs to track compliance progress and support long-term product quality.
| name | accessibility-wcag |
|---|---|
| description | | |
| • WCAG 2.1 Guidelines / 適用 | アクセシビリティ基準 / 目的: 準拠確認 |
| • WAI-ARIA Authoring Practices / 適用 | ウィジェット実装 / 目的: ARIA実装指針 |
| • Inclusive Design Patterns (Heydon Pickering) / 適用 | 実装パターン / 目的: ベストプラクティス |
accessibility-wcag
概要
WCAG準拠のアクセシビリティ設計を整理し、インクルーシブなUI実装と検証を支援する。
ワークフロー
Phase 1: 要件整理
目的: 目標レベルと対象範囲を明確化する。
アクション:
- 対象UIとユーザー層を整理する。
- WCAGレベル(A/AA/AAA)を確認する。
- 参照ガイドとテンプレートを確認する。
Task: agents/analyze-accessibility-requirements.md を参照
Phase 2: 実装設計
目的: アクセシビリティ実装方針を具体化する。
アクション:
- セマンティクスとARIAの方針を整理する。
- キーボード操作とフォーカス管理を設計する。
- テンプレートで表現を統一する。
Task: agents/design-accessibility-solution.md を参照
Phase 3: 検証と記録
目的: 監査結果を検証し、記録を残す。
アクション:
- 監査スクリプトで自動検証を行う。
- チェックリストで手動検証を行う。
- ログと評価情報を更新する。
Task: agents/validate-accessibility.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| analyze-accessibility-requirements | Phase 1開始時 | 対象/目標 | 要件整理メモ、範囲一覧 |
| design-accessibility-solution | Phase 2開始時 | 要件整理メモ | 実装方針、対応項目 |
| validate-accessibility | Phase 3開始時 | 実装方針 | 検証レポート、改善方針 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| WCAG目標を明確にする | 合格基準が明確になるため |
| キーボード操作を保証する | 全ユーザーが操作できるため |
| 検証と記録を実施する | 改善が継続できるため |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| 色だけで情報を伝える | 判別不能になる |
| 見出し構造を飛ばす | 読み上げが崩れる |
| 記録を残さない | 改善が続かない |
リソース参照
scripts/(決定論的処理)
| スクリプト | 機能 |
|---|---|
scripts/a11y-audit.mjs |
アクセシビリティ監査 |
scripts/log_usage.mjs |
使用記録と評価メトリクス更新 |
scripts/validate-skill.mjs |
スキル構造の検証 |
references/(詳細知識)
| リソース | パス | 読込条件 |
|---|---|---|
| レベル1 基礎 | references/Level1_basics.md | 初回整理時 |
| レベル2 実務 | references/Level2_intermediate.md | 実務適用時 |
| レベル3 応用 | references/Level3_advanced.md | 複雑UI時 |
| レベル4 専門 | references/Level4_expert.md | 改善ループ時 |
| ARIAパターン | references/aria-patterns.md | ウィジェット実装時 |
| WCAGチェック | references/wcag-checklist.md | 準拠確認時 |
| テストガイド | references/testing-guide.md | 検証実施時 |
| 要求仕様索引 | references/requirements-index.md | 要件参照時 |
| 旧スキル | references/legacy-skill.md | 互換確認時 |
assets/(テンプレート・素材)
| アセット | 用途 |
|---|---|
assets/accessible-form-template.tsx |
アクセシブルフォーム実装例 |
運用ファイル
| ファイル | 目的 |
|---|---|
EVALS.json |
レベル評価・メトリクス管理 |
LOGS.md |
実行ログの蓄積 |
CHANGELOG.md |
改善履歴の記録 |