セマンティックHTML/JSXとWAI-ARIAを「最小で正しく」適用し、キーボード操作・スクリーンリーダ・コントラスト等を満たす実装を作るための判断軸。ネイティブ要素優先、ARIAの過剰使用を避ける。
無料GitHub で公開
usability-psychologist
認知負荷・エラー防止・学習コスト・アクセシビリティの観点からUI/フローを評価し、改善案を“検証可能な仮説”として提示する。認知人間工学/ユーザビリティ/アクセシビリティを統合して扱う。
含まれるファイル(1)
- SKILL.md2.8 KB
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Usability Psychologist Skill
発火条件(適用タイミング)
- 依頼が「使いにくい」「離脱が多い」「入力が難しい」「迷う」「アクセシビリティ」「エラーが多い」なら適用する。
- UI設計のレビュー時、またはフォーム/オンボーディング/設定画面などで優先適用する。
このSkillの基本方針(整理軸)
- 基本方針: 使いやすさは“好み”ではなく“コスト”。迷い・記憶・操作回数・エラー率を減らす。
- 認知負荷: ワーキングメモリを圧迫しない(選択肢を減らす、段階化する、文脈を維持する)。
- a11y: 最低限の基準(キーボード操作、フォーカス、コントラスト、代替テキスト等)を落とさない。
思想(判断ルール)
- ユーザーの「今の文脈」を壊さない(画面遷移・情報の消失・突然のモーダル乱用を避ける)。
- エラーは予防する(入力制約、即時フィードバック、適切なデフォルト)。
- “覚えさせない”。選ばせず、見せる(認識優先)。
- 操作は一貫させる(同じものは同じふるまい)。
- アクセシビリティは後付けしない(最初から仕様に含める)。
進め方(最初に確認する問い)
- 失敗しているのはどこ?(ステップ/画面/操作)
- 何が“できない”のか?(理解/判断/操作/入力/待ち)
- どのユーザーが困る?(初心者/熟練/支援技術/低速回線)
- 成功条件は?(完了率、時間、エラー率、満足度)
出力フォーマット(必ずこの順)
- 問題の整理(観察/事実/仮説)
- 原因仮説(認知負荷/手がかり不足/フィードバック不足/一貫性欠如 等)
- 改善案(優先度つき)
- a11yチェック(最低限)
- 検証計画(計測/ユーザーテスト/AB等)
最低限のa11yチェック(簡易)
- キーボードだけで主要操作が完了できる
- フォーカスが見える
- コントラストが不足していない
- フォームにラベル/エラー説明がある
- 画像に代替テキスト(必要な場合)がある
よくある落とし穴
- “慣れれば使える”を前提にして、初見の迷いを放置する
- エラー文が抽象的で、次の行動が分からない
- a11yを最後に足して破綻する
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
mae616/ai-template92026年10月6日 更新
Agent Browser(Headlessブラウザ自動化CLI)を使ったUI検証・E2Eテスト・スクリーンショット取得の判断軸。アクセシビリティツリーベースの要素選択を優先し、壊れにくいテスト設計を目指す。
mae616/ai-template92026年10月6日 更新
ディズニーの12原則とジブリ的自然運動をベースに、UIアニメーションの「なぜ動かすか」「どう動かすか」を判断する。アニメーション/モーション/トランジション設計の相談で、ツール非依存の概念的判断軸として使う。
mae616/ai-template92026年10月6日 更新
アーキテクチャ設計(境界/依存/データフロー/非機能/運用)を、制約とトレードオフで言語化し、ADR-liteで合意形成しながら段階的に形にする。doc/input/rdd.md にアーキテクチャ/非機能/運用の要求がある、または設計判断(分割/責務/インタフェース/データ整合/観測性/スケール)相談で使う。
mae616/ai-template92026年10月6日 更新
事業仮説を支える一次/二次情報を整理し、意思決定に足る「根拠」「不確実性」「次の調査」を可視化する。でたらめな引用や推測の断言を避け、出典の実在を重視する。
mae616/ai-template92026年10月6日 更新
体験品質(動き/触感/視線誘導)を「実装可能な制約」に落とし、アクセシビリティとパフォーマンスを犠牲にせずに表現を実現する。UIの表現・アニメーション・インタラクション設計/実装の相談で使う。
mae616/ai-template92026年10月6日 更新