Communitygithub.com

design-pass

合意されたビジュアル方向性をページやコンポーネントに適用し、既存コンポーネントを優先的に再利用してから、ヘッドレスChrome監査で全幅・ダークモードを検証し、Refactoring UI、Nielsen、WCAG 2.2に照らしてレビューします。再デザイン、スタイル変更、「リファレンスのように見せる」よう依頼された場合、design-ref後、または方向性が既に明確な場合に使用します。

design-pass とは?

design-passは、フロントエンドUIの変更を体系的かつ検証可能な方法で適用するためのClaude Skillです。まず変更前のスクリーンショットを取得し、既存コンポーネントの再利用を徹底しながら、UI監査スクリプトを使って全幅(375px、768px、1440px)とダークモードのビフォー/アフター比較を行います。変更後は再度スクリーンショットを取得し、ピクセル差分を確認。意図しない変更がないか、ヒエラルキー、アクションの優先順位、スペーシング、タイポグラフィ、エラー状態、モバイルでの入力サイズなど、包括的なチェックリストに沿ってレビューします。最後に、グレースケール確認やタイプチェック・リントもパスし、すべての終了条件を満たすまで作業を続けます。Claude Code環境で動作し、`ui-audit`ツールキットと連携します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamk3nnyt/claude-skills/tree/HEAD/skills/design-pass

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

design-pass は何をしますか?

ターゲット: $ARGUMENTS ツールキット: ${CLAUDE_SKILL_DIR}/../ui-audit/scripts/ · チェックリスト: ${CLAUDE_SKILL_DIR}/reference/review-checklist.md

1. ベースライン(コードを触る前)

開発サーバーが起動していることを確認し(必要ならバックグラウンドで起動、本番ビルドは絶対に実行しないでください)、次を実行します:

node ${CLAUDE_SKILL_DIR}/../ui-audit/scripts/audit.mjs http://localhost:<port> --pages <path> --widths 375,768,1440 --dark --out /tmp/design-pass/before

2. 修正前の監査

  • ターゲットがレンダリングするすべてのコンポーネントと、同じパターンをレンダリングする他のすべての場所(クラス文字列やコンポーネント名をgrep)を見つけます。
  • 新しいものを書く前に、既存のプリミティブ(ボタン、カード、モーダル、セクション見出し)を再利用します。同じマークアップが2回以上出現する場合は、それを抽出してから一度だけスタイルを変更します。
  • 依頼されたものだけを正確に構築します。依頼がない限り、新しいセクション、バッジ、トグル、アニメーションは追加しないでください。
  • プロジェクトのトークンのみを使用します。スケールにない値は、最も近いステップを使用するか、トークンを提案します(design-refを参照)。

3. 適用

チェックリストに沿って作業します: ヒエラルキー、ビューごとに1つのプライマリアクション、スペーシングスケール、タイポグラフィスケール、空/ローディング/エラー状態、モバイルで16px以上の入力。

4. 検証

node ${CLAUDE_SKILL_DIR}/../ui-audit/scripts/audit.mjs http://localhost:<port> --pages <path> --widths 375,768,1440 --dark --out /tmp/design-pass/after
node ${CLAUDE_SKILL_DIR}/../ui-audit/scripts/diff.mjs /tmp/design-pass/before /tmp/design-pass/after
  • 各幅のライトモードとダークモードのafterシートを読みます。ターゲット外の意図しない変更がないか、差分PNGを確認します。
  • グレースケールチェック: --inject "document.documentElement.style.filter='grayscale(1)'" を付けて1つの幅を再実行します。
  • 次に、完全な ui-audit の幅セットを1回実行し、タイプチェックとリントも行います(ビルドは不要)。
  • プロジェクトがコードと同期したFigmaファイルを保持している場合は、同じタスク内で一致するフレームを更新します。

終了条件

  • 横スクロールがないこと、beforeと比較して新しいコントラストやaxeの問題がないこと。
  • 差分が意図した場所でのみ変更を示していること。
  • 既存のコンポーネントを複製する新しいコンポーネントがなく、要求されていないUIがないこと。
  • ダークモードがチェックされていること、またはプロジェクトにダークモードがないことが確認されていること。
  • タイプチェックとリントにパスしていること。
  • ユーザーに短いサマリーと、確認すべき1~2のシートパスを提示すること。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル