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

Design Consultation スキル。

Claude Code と Codex 向けのブランド・デザインシステム作業用スキル:美意識、タイポグラフィ、カラー、レイアウト、モーションを含む完全なデザインシステムを提案するプロダクトデザインコンサルテーションです。

  • ブランドとデザインシステム
  • デザインシステム
garrytan/gstack · design-consultation/SKILL.mdSKILL.md
--- name: design-consultation description: Design consultation: understands your product, researches the landscape, proposes a complete design system (aesthetic, typography, color, layout, spacing, motion), and generates font+color preview... (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 に読み込まれた Front matter とセクション見出し · 全文 67,098 文字

01 できること

Claude CodeとCodexにおいて、design-consultationスキルが行うこと

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

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

スキル自身の言葉で

design-consultationスキルは、シニアプロダクトデザイナーとして機能し、完全な設計システムを作成する設計相談スキルです。Web検索とビジュアル分析によってプロダクトの状況を調査し、タイポグラフィ(デフォルトではなく具体的なフォント)、カラーシステム(16進値によるCSS変数)、レイアウトアプローチ(コンポジション優先)、美的方向性を提案します。このスキルは、プロジェクトの設計に関する信頼できる情報源としてDESIGN.mdファイルを生成し、任意でシステムが実際の画面に適用された様子を示すAIモックアップも生成します。

このスキルはAsideブラウザ(ユーザーの実際のセッション)とヘッドレスフォールバックの両方をサポートし、セッションをまたいで持続する好みのプロファイルを維持し、Codexおよびクロードサブエージェント(Claude subagent)からの外部のデザイン視点を統合します。このスキルは厳格なフォームとしてではなく対話形式で動作し、すべての推奨事項の根拠を説明し、個々の最適な選択よりも一貫性を優先します。

生成されるもの

  • 設計システムが実際の画面に適用された様子を示すAIモックアップです(gstack designerが利用可能な場合)
  • タイポグラフィとカラーのサンプルをその場で確認できるHTMLプレビューページです(designerが利用できない場合のフォールバック)
  • セッションをまたいで承認・拒否された設計上の選択を追跡する、持続的な好みプロファイルのJSONです
プロンプト例を見る ↗

仕組み

  1. 01
    プロダクトのコンテキストを収集する

    既存のDESIGN.md、PRODUCT.md、README、package.json、およびoffice-hoursの出力を読み込み、プロダクトを理解します。

  2. 02
    状況をリサーチする

    要求があれば、AsideブラウザまたはWebSearchを使って5〜10件の競合プロダクトを見つけ、フルページのスクリーンショットを取得し、フォント、カラー、レイアウト、美的方向性を分析します。

  3. 03
    外部の視点に相談する

    任意で、CodexとClaudeサブエージェントを並行して起動し、独立した設計提案を生成します。

  4. 04
    完全な設計システムを提案する

    具体的なフォント名、16進のカラー値、CSS変数、レイアウトアプローチ、美的方向性を含む、明確な意見を持った提案を提示します。

  5. 05
    プレビュー成果物を生成する

    AIモックアップ(gstack designerが利用可能な場合)で実際の画面に適用されたデザインシステムを表示するか、タイポグラフィとカラーのサンプルをライブで確認できるHTMLプレビューページを作成します。

  6. 06
    DESIGN.mdを書く

    フロントマターのトークンと根拠セクションを備えた、オープンなDESIGN.md形式でプロジェクトのデザインの信頼できる情報源を作成します。

02 適合性を確認

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

この種のブランドおよびデザインシステム作業には、Claude Code または Codex で design-consultation スキルを使用します。適合性と制限事項は、スキル自体のファイルから取得されています。

適している場合

  • 既存のデザインシステムやDESIGN.mdがない新規プロジェクトのUIを開始するとき
  • デザインシステム、ブランドガイドライン、またはDESIGN.mdの作成を明示的に依頼されたとき
  • カテゴリーの規範から意図的なデザインの逸脱によって差別化が必要なプロダクト

境界を知る

  • 主張された制限や要件(「この API ではできません」「X には認証情報が必要です」「このプラットフォームでは不可能です」)は、重要な主張です。
  • そのような主張は、実際のエラー、文書化された記述、または実際の検証が手元にある場合にのみ述べます。失敗を既知のストーリーにパターンマッチングすることは証拠ではありません。
  • 簡単な検証で問題が解決する場合は、ユーザーに何か尋ねたりステップがブロックされたと宣言したりする前に実行します。

提供すべきもの

  • リサーチの好みWeb検索とビジュアル分析による競合プロダクトのリサーチを行うか、スキル内蔵のデザイン知識に基づいて作業するか。
  • 外部視点の選択任意:Codexによるデザイン評価とClaudeサブエージェントによるデザイン提案を並行して実行し、独立した視点を得るかどうか。
  • 既存のDESIGN.md存在する場合、スキルはそれを読み込み、更新するか、最初からやり直すか、キャンセルするかを尋ねます。旧形式からオープン仕様への変換にも対応します。

03 スキルの内部

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

SKILL.mdがエージェントに設定する7つの具体的な指示、デフォルト、制限 — ファイルの中で結果を変える部分です。

  1. 禁止フォントは絶対に使わない、多用されすぎたディスプレイフォントも使わない

    OperateまたはReadサーフェス上の本文またはUIテキストは、役割別に定められたリストに従います。どの役割においても禁止フォントは使用せず、ディスプレイ用として多用されすぎたフォントも使用しません。

  2. デフォルトではなく具体的なフォントを指定する必要があります

    タイポグラフィの提案では、具体的なフォント名を指定する必要があります。Inter、Roboto、Arial、またはシステムデフォルトは使用しません。

  3. 個々の最適化よりも一貫性が優先される

    すべての要素が互いを補強し合うデザインシステムは、個々には最適だが噛み合わない選択の集まりに勝ります。

  4. すべての推奨事項には根拠が必要です

    理由を説明せずにデザインの選択を推奨することは決してありません。フォント、色、レイアウト、美観に関する決定はすべて、プロダクトの文脈、ユーザーニーズ、または差別化戦略に結び付けられている必要があります。

  5. テイストプロファイルは維持され、時間とともに減衰する

    このスキルは~/.gstack/projects/$SLUG/taste-profile.jsonを維持し、セッションをまたいで承認・拒否されたデザインの選択を追跡します。信頼度スコアは週ごとに5%減衰します。

  6. 「記憶に残るもの」を強制する仕組み

    デザインシステムを提案する前に、スキルはユーザーに最初に触れた後何を記憶してほしいかを尋ねます。

  7. 厳格なワークフローよりも対話を重視する

    このスキルはフォームではなく、デザインコンサルタントとして機能します。ユーザーはいつでもチャットに入り、決定事項について話し合うことができます。

04 実際に使う

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

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

Claude Code、Codex、またはお使いのエージェントに design-consultation を追加

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

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

design-consultation/SKILL.md用の汎用skills CLIフォーム。リポジトリ側で独自のパスを指定している場合があります。

最初のブランドおよびデザインシステムの作業タスクをスキルに与える

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

Starter prompt
I'm building [a SaaS dashboard for engineering teams / a landing page for a fintech startup / an internal tool for data analysts]. We have no design system yet. Help me create one that [stands out from the typical enterprise look / feels trustworthy and serious / makes complex data feel approachable]. Research what's out there in this space and propose typography, colors, and layout that differentiate us.

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

最初の結果を確認

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

  • DESIGN.mdが存在し、デザイントークン(色、フォント、間隔)を含むフロントマターを含んでいます
  • カラーシステムには、背景、サーフェス、プライマリテキスト、ミュートテキスト、アクセントのCSS変数が16進値で含まれています
  • テイストプロファイルが存在する場合、デザイン案はそれを参照するか、意図的にそこから外れています

OpenDesignではdesign-consultationは同梱されています。上部バーのPlugins → Skillsから選択してください。

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

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

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

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

SKILL.md の中身

  1. このスキルを呼び出すタイミングDESIGN.mdを作成します。既存サイトの場合は/plan-design-reviewを使用します。デザインシステムのリクエストでトリガーされます
  2. 前文(最初に実行)gstack-skill-startを実行します。デグレードモードを処理します。命令ブロックを処理します。セッションの種類を判定します
  3. ブラウザセットアップAsideブラウザの利用可能性を確認します。実セッションの同意を処理します。ユーザーのブラウザを操作するルールを定義します
  4. ブラウザのフォールバック:gstack独自のヘッドレスブラウザAsideが利用できない場合、$Bバイナリを探します。Asideスクリプトを$Bコマンドに変換します。クッキーのないセッションを処理します
  5. デザインセットアップAIモックアップ生成用のgstack designerバイナリを確認します。利用可能なコマンドを一覧表示します。成果物パスのルールを設定します
  6. 過去の学習内容プロジェクト横断またはプロジェクト単位の学習内容を検索します。初回実行時にプロジェクト横断の設定について確認します
  7. フェーズ0:事前確認既存のDESIGN.mdを確認します。更新/新規作成/キャンセルを提示します。フォーマットを検証します。変換を処理します。コードベースからプロダクトのコンテキストを収集します
  8. フェーズ1:プロダクトコンテキストプロダクト/対象ユーザー/業界/種別をカバーする単一の質問。記憶に残る要素を引き出す質問。既存の場合はテイストプロファイルを読み込みます
  9. ウェブ調査はAside内で実行されますウェブ検索にAsideエージェントを使用します。利用できない場合はWebSearchツールにフォールバックします。クエリをサニタイズします。結果は信頼できないコンテンツとして扱います
  10. フェーズ2:リサーチ5〜10社の競合プロダクトを特定します。スクリーンショットを取得します。フォント/色/レイアウトを分析します。3つのレイヤーにわたって統合します
  11. デザインの外部視点オプションでCodexとClaudeのサブエージェントを並行実行します。合意点と相違点を統合します。結果をログに記録します
  12. 重要なルールメニューを提示せず提案する形にします。根拠が必要です。個々の選択より一貫性を重視します。硬すぎず対話的にします。最終選択を受け入れます
スキル自身による説明
「デザインコンサルテーション:製品を理解し、市場を調査し、完全なデザインシステム(美学、タイポグラフィ、カラー、レイアウト、スペーシング、モーション)を提案し、フォントとカラーのプレビューを生成します...(gstack)」

SKILL.md からの冒頭説明です。ファイル全体は約 67,098 文字です。GitHub で全文を読む。

06 インストールする前に

design-consultationスキルに関するよくある質問

回答は 2026-09-14 時点で読んだ SKILL.md に基づくもので、記録された実行結果によるものではありません。

これはCursor、Windsurf、または他のClaudeベースのエージェントでも動作しますか?

はい、ただしブラウザ連携はAside(macOS 15以降のみ)またはgstackヘッドレスブラウザのフォールバックに依存します。どちらも利用できない場合、このスキルは視覚的な競合調査をスキップし、組み込みのデザイン知識から動作します。プロダクトコンテキスト、タイポグラフィ/色/レイアウトの提案、DESIGN.mdの作成といったコアのデザインコンサルテーションは、どの環境でも動作します。

Design Consultation

実際のブランドおよび design-system の作業タスクで design-consultation を実行します。

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

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