mcpField
U
ux-audit-skill

ux-audit-skill

github.com/sergekostenchukデザイン・UI3263 回インストール18 週間前に更新
リポジトリ

ux-audit-skill について

ux-audit-skill は、利用可能な根拠に基づいて既存のUIを評価し、重大度マトリクスと実行可能な改善案を作成するスキルです。URL、スクリーンショット、ソースコードを扱い、根拠の種類と判断範囲を明示します。

主な機能

  1. 01URL、スクリーンショット、コードの評価
  2. 02重大度マトリクスと修正案の作成
  3. 03各指摘の根拠タイプを明記
  4. 04変更前後の根拠を比較して回帰を確認

活用シーン

  1. 01スクリーンショットからUIの問題を評価
  2. 02既存ページやソースファイルをレビュー
  3. 03監査結果を実装タスクに変換
  4. 04変更後の回帰リスクを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill ux-audit-skill

インストール後、Claude Code で/ux-audit-skillを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
assets/
audit-report.template.md
regression-report.template.md
evals/
evals.json
references/
audit-evidence-model.md
mobile-touch-rubric.md
severity-model.md
wcag-quick-ref.md

詳細

UX 監査スキル

既存の UI 成果物を、証拠に基づいてレビューする際に使用します。出力は重要度マトリクスと実行可能なリファクタリング概要であり、一般的なデザイン論ではありません。

作業モード

  • review-live-url：利用可能なブラウザー／静的証拠を用いて、アクセス可能な URL を監査します。
  • review-screenshot：DOM に関する主張を行わず、画像のみのコンテキストを監査します。
  • review-code：ソースファイルとテンプレートを監査します。
  • refactor-brief：調査結果を、別のスキル向けの実装タスクに変換します。
  • regression-check：変更前後の証拠と残るリスクを比較します。

必須のワークフロー

  1. references/audit-evidence-model.md を使用して、利用可能な証拠を分類します。
  2. 調査結果の優先順位付けの前に、references/severity-model.md を適用します。
  3. 監査の出力には assets/audit-report.template.md を使用します。
  4. 変更前後のチェックには assets/regression-report.template.md を使用します。
  5. スクリーンショット、Figma、または認証済み状態を扱う前に、../../shared/privacy-policy.md を適用します。
  6. URL が利用可能な場合は、../../shared/tool_inventory.json に記載されたローカルスクリプトを再利用します。
  7. 各調査結果に証拠の種類を示すラベルを付けます：DOM、screenshot、source、automated、または Manual。

証拠の境界

  • スクリーンショットのみの入力では、DOM、Lighthouse、axe、または実行時に関する主張を裏付けられません。
  • ソースのみの入力では、実行またはスクリーンショットの証拠がない限り、レンダリングされたレイアウトを証明できません。
  • 手動による調査結果も認められますが、Manual とラベル付けする必要があります。
  • 予定しているツールは証拠ではありません。

検証

python3 $CODEX_SKILLS_DIR/.system/skill-creator/scripts/quick_validate.py $CODEX_SKILLS_DIR/ux-audit-skill
python3 $CODEX_SKILLS_DIR/senior-skill-architect/scripts/lint_production_skill.py $CODEX_SKILLS_DIR/ux-audit-skill

出力形式

Audit target:
Evidence available:
Ran:
Skipped:
Severity matrix:
Top fixes:
Verification plan:
Privacy notes:
Residual risk:

コメント

Markdown 対応