使い方ガイドへスキップ
design-review作者 Garry Tan

Design Review スキル。

デザインレビューのための Claude Code と Codex スキル:構築されたページに対するデザイナー視点の QA(不整合、スペーシング、階層、粗雑なパターンを検出し、修正します)。

  • デザインレビュー & アクセシビリティ
  • レビューレポート
garrytan/gstack · design-review/SKILL.mdSKILL.md
--- name: design-review description: Designer's eye QA: finds visual inconsistency, spacing issues, hierarchy problems, AI slop patterns, and slow interactions — then fixes them. (gstack) --- ## When to invoke this skill ## Confusion Protocol ## Claimed Limitations Need Evidence ## Continuous Checkpoint Mode ## Context Health (soft directive) ## Question Tuning (skip entirely if QUESTION_TUNING: false)
2026-09-14 にアップストリームファイルから読み取ったフロントマターとセクション見出し · 全126,647文字

01 できること

design-review スキルが Claude Code と Codex で行うこと

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

ライブサイトをデザイナーの視点でQAします。ユーザー自身のブラウザでページを開き、375、768、1440の各幅でスクリーンショットを撮影し、視覚的階層からインタラクション状態まで10のカテゴリーで評価を行い、その後ソースを編集して見つかった問題を修正します。修正は1件につき1コミットとし、前後のスクリーンショットで再検証します。

深さはデフォルトで5〜8ページですが、フィーチャーブランチ上でURLが指定されていない場合は差分ベースになります。読者は2つの見出しの評価、重み付けされたDesign Scoreと単独のAI Slop Score、さらに[kicker-above-heading]や[gradient-text]といった判断基準の背後にある30の名前付き検出ルールを得られます。

生成されるもの

  • 実行ディレクトリに構造化されたMarkdown形式の監査レポートが出力されます。
  • 以降の実行で回帰比較を行うためのdesign-baseline.jsonファイルが書き出されます。
  • 適用したすべての修正について、前後のスクリーンショットのペアが得られます。
  • ユーザーがフェーズ2の提案を受け入れた場合、抽出された観察結果から作成される任意のDESIGN.mdです。
プロンプト例を見る ↗

仕組み

  1. 01
    分析する前に反応を確認する

    フェーズ1では対象を開き、フルページのデスクトップスクリーンショットを撮影し、目が最初に向かう箇所を示す構造化された第一印象を記述します。

  2. 02
    レンダリングされたシステムを抽出する

    フェーズ2ではページ内のフォント、色、見出しのスケール、タッチターゲットを調査し、その結果をDESIGN.mdとして保存することを提案します。

  3. 03
    ページごとに監査する

    フェーズ3では、各ページごとにコンソールフック、インタラクティブスナップショット、注釈付きスクリーンショットを実行し、3つのビューポート幅でこれを繰り返します。

  4. 04
    フローを体感する

    フェーズ4では2〜3のユーザーフローをたどり、各アクション後のスナップショットの差分を確認し、摩擦や修復のためのグッドウィルスコアを追跡します。

  5. 05
    一度に1つの発見事項を修正する

    フェーズ8では最小限の変更を行い、それ単独でコミットし、次の発見事項に移る前に再テストします。

  6. 06
    2つの見出しを評価する

    デザインスコアは10のカテゴリーにわたる重み付け平均であり、AI slopの評価は単独で成り立っています。

02 適合性を確認

design-review スキルを使用するタイミング

この種のデザインレビューの場合は、Claude Code または Codex で design-review skill を使用してください。以下の適合性と制限は、skill 自体のファイルから取得されています。

適している場合

  • ローンチ前やリデザイン後の監査で、サイト全体に体系的なチェックが必要で、抜粋的な確認では不十分な場合です。
  • UIを変更するフィーチャーブランチで作業しており、変更されたルートのみを監査すべき場合です。
  • 視覚的な不整合について言及したり、ライブサイトを洗練させたい場合、このスキルが自然に提案されるべきです。
  • 公開済みのページがAI生成のように見えるかどうかを判断します。これは多くの開発者が自分では評価できないことです。
  • フルスイープの時間がない場合の高速な健全性チェックです。ホームページと主要な2ページ、簡略化したチェックリストを確認します。

境界を知る

  • 構築前のデザインレビューは別のプランモードのスキルとなります。
  • サードパーティのウィジェットやチームから提供されるべきコピーなど、ソースの外側にある問題は、修正済みではなく保留扱いとしてマークされます。
  • CI設定には手を加えず、既存のテストも対象外です。新しい回帰テストファイルのみ作成できます。

提供すべきもの

  • 対象URLlocalhostを含む有効なアドレスです。指定がない場合、スキルは自動検出するか、mainブランチではあなたに確認します。
  • スコープの上書きフルツアーを希望しない場合、スイープを1ページまたは1つの領域に絞り込みます。
  • 深さのフラグデフォルトはstandardです。--quickは3ページに絞り、--deepはリリース前の完全なスイープに拡張します。
  • 存在する場合のあなたのDESIGN.mdリポジトリルートのデザインドキュメントが最初に読み込まれるため、すべての判断は明示されたシステムに対して調整され、それからの逸脱はより厳しく評価されます。
  • すでにサインイン済みのブラウザセッション監査はユーザーが既に持っているセッション内で動作するため、認証が必要なページでもログインフローは不要です。

03 スキルの内部

design-reviewスキルがClaude CodeとCodexに与えるルール

SKILL.md がエージェントに設定する 8 つの具体的な指示・既定値・制限 — 結果を変える部分です。

  1. レンダリングを判断し、リポジトリを判断しない

    監査は実装ファイルを読み込みません。所見はレンダリングされたページから得られるものでなければなりません。唯一の例外は、抽出された観察結果からDESIGN.mdを書き出す場合です。

  2. 1つの修正につき1つのコミット

    各修正は単独でコミットされ、コミットメッセージの形式はstyle(design): FINDING-NNNに短い説明を加えたものです。

  3. 開始前にツリーをクリーンにする

    作業ツリーが汚れている場合、実行は停止します。修正コミットが存在する前に、エージェントはコミットするか、stashするか、中止するかを確認しなければなりません。

  4. 実際のアカウントに対して操作する前に確認する

    ローカル以外の対象では、変更を伴う操作には実行ごとに1回、何を行うかを正確に列挙した同意確認が必要です。サインアウトや削除の経路は決して実行されません。

  5. 認証情報はエージェントの外に置く

    事前にサインイン済みのセッションはそのまま使用されます。パスワード、ワンタイムコード、支払い情報、クッキー、トークン、localStorageはすべて対象外です。

  6. すべての所見はスクリーンショットで裏付ける

    少なくとも1枚のスクリーンショットがない所見は無効とみなされ、画像はコピーして読み込まれるため、ユーザーはインラインで確認できます。

  7. 悪化した瞬間に元に戻す

    回帰が発生した場合は直ちに git revert HEAD が実行され、その指摘は場当たり的に修正されるのではなく、対応を見送る(deferred)ものとして記録されます。

  8. 30件の修正で停止

    ループは修正5件ごとにエスカレーションし、デザイン修正のリスクが20%を超えるか修正数が30件に達した時点で完全に停止します。

04 実際に使う

Claude Code または Codex に design-review をインストール

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codex、またはあなたのエージェントに design-review を追加

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/garrytan/gstack --skill design-review

design-review/SKILL.md用の汎用skills CLI形式。リポジトリによっては独自のパスが記載されている場合があります。

スキルに最初のデザインレビュータスクを与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
Audit the design of [https://myapp.com/dashboard] at standard depth. Focus on the settings page. I'm signed in as [[email protected]] in Aside. Flag the AI slop patterns and anything that breaks the spacing scale, then fix what you can.

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • 各修正後に対象ページを再テストし、コンソールエラーのリストが空であるか、ベースライン以下であることを確認します。
  • ターゲットモックアップが生成されていた場合、修正後のスクリーンショットと比較し、合格または不合格を記録します。
  • すべての修正は分類されます。再テストで新たなエラーがないことが確認された場合はverifiedとなります。
  • フェーズ9では対象ページを再監査し、最終評価がベースラインを下回った場合は明確に警告します。
  • レポートには検出数を開始から終了までの差分として記載するか、検出器がインストールされていない、またはオフになっていることを記載します。

OpenDesignではdesign-reviewがバンドルされています。上部バーのPlugins → Skillsから選択してください。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

Author
Garry Tan
Repository
github.com/garrytan/gstack ブランチ main
スキルファイル
design-review/SKILL.md 検証時にコンテンツチェックサムを記録、コミット 71f6048
License
MIT LICENSE より。
リポジトリスター数
132,921 GitHub スナップショットは 2026-09-14 に garrytan/gstack リポジトリ全体に対して取得されました。このリポジトリには、このカタログに含まれる7つのスキルが含まれています。design-review の評価や使用回数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign メイン版に同梱(2026-08-28 確認)。このページでは実際の実行記録はまだありません。

SKILL.md の中身

  1. セットアップURL、スコープ、深さ、認証を解析し、DESIGN.md、クリーンなツリー、ブラウザ、テストを確認します。
  2. モードフル、クイック、ディープ、diff認識、リグレッションのスコープにより、訪問するページが決まります。
  3. フェーズ1: 第一印象デスクトップのフルページスクリーンショットを取得し、構造化された直感的な反応とページエリアのテストを行います。
  4. フェーズ2: デザインシステムの抽出フォント、色、見出しのスケール、タップ領域を調査し、DESIGN.mdの保存を提案します。
  5. フェーズ3: ページごとのビジュアル監査スナップショット、注釈付き・レスポンシブ画像、トランクテストを実施し、その後10カテゴリのチェックリストを確認します。
  6. フェーズ4: インタラクションフローのレビュー2〜3のフローをたどり、各ステップを差分比較し、70点満点のグッドウィルメーターで評価します。
  7. フェーズ5: ページ間の一貫性ナビゲーション、フッター、コンポーネント、トーン、余白のリズムをページ間で比較します。
  8. フェーズ6: レポートのコンパイル各カテゴリをA〜Fで評価し、レポートとdesign-baseline.jsonを作成します。
  9. フェーズ7: トリアージ指摘事項を影響度で分類し、ソース編集で対応できないものは保留にします。
  10. フェーズ8: 修正ループソースを特定し、最小限の修正を行い、コミット、再テスト、分類、自己調整を行います。
  11. フェーズ9: 最終デザイン監査対象ページを再監査し、スコアと検出数を再計算し、リグレッションがあれば警告します。
  12. フェーズ10: レポート完全なレポート、プロジェクトインデックスの要約、PR行、検出器の差分を作成します。
スキル自身による説明
「デザイナーの目による QA:視覚的な不整合、余白の問題、階層の問題、AI による粗雑なパターン、遅いインタラクションを見つけて修正します。(gstack)」

SKILL.md の front-matter 説明文です。ファイル全体は約 126,647 文字です。GitHub でファイル全体を読む。

Design Review

実際のデザインレビュータスクで design-review を実行します。

design-review スキルは OpenDesign に同梱されています。アプリをダウンロードし、Plugins → Skills でスキルを選択し、上記のプロンプトを貼り付けて、結果を読む前にプランを確認してください。

ターミナル
npx skills add https://github.com/garrytan/gstack --skill design-review