A11y accessible name
Skill s977043/river-review/skills/midstream/a11y-accessible-name
画像・ボタン・フォーム要素に適切なアクセシブルネームがあるか確認する。From its SKILL.md
npx -y skills add s977043/river-review --skill a11y-accessible-nameAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.4 KB, as published. Nobody here has run it
Goal / 目的
- 主要UI要素のラベル欠落による操作不能や誤解を防ぐ。
Non-goals / 扱わないこと
- コントラスト比やキーボード操作などの包括的なa11y評価。
- 画面全体の情報設計の良し悪し。
- 動的UIのARIA設計（別スキルの対象）。
False-positive guards / 抑制条件
aria-hidden="true"が明示されている装飾要素は指摘しない。aria-label/aria-labelledbyが既に付与されている場合は指摘しない。
Rule / ルール
imgタグにはalt属性を必須にする（装飾的な画像はalt=""を推奨）。button/a/inputには可視テキストまたは ARIA ラベルを持たせる。
Evidence / 根拠の取り方
- 対象要素のタグと属性の有無を差分から示す。
alt/aria-label/aria-labelledbyの欠落を根拠として示す。
Heuristics / 判定の手がかり
imgにaltが存在しない。button/aがアイコンのみで、ラベル属性もない。inputにlabelが関連付けられていない（htmlFor/idが不一致）。
Actions / 改善案
altで意味を短く表現する。aria-labelを追加し、読み上げ名を明示する。labelとinputをid/htmlForで関連付ける。
Output / 出力
Finding:/Evidence:/Impact:/Fix:を含む短いメッセージにする。
評価指標（Evaluation）
- 合格基準: ラベル欠落が差分に紐づき、根拠と改善案が説明されている。
- 不合格基準: 差分と無関係な指摘、根拠のない断定、抑制条件の無視。
人間に返す条件（Human Handoff）
- UIの意図が不明で解釈が分かれる場合は質問として返す。
- 画面設計そのものの議論が必要な場合は人間レビューへ返す。