使い方ガイドへスキップ
visual-design-foundations作者 Seth Hobson

Visual Design Foundations スキル。

Claude Code と Codex 向けのブランド・デザインシステムスキル:統一されたビジュアルを実現するタイポグラフィ、カラー理論、スペーシングシステム、アイコノグラフィを扱います。

  • ブランドとデザインシステム
wshobson/agents · plugins/ui-design/skills/visual-design-foundations/SKILL.mdSKILL.md
--- name: visual-design-foundations description: Apply typography, color theory, spacing systems, and iconography principles to create cohesive visual designs. Use when establishing design tokens, building style guides, or improving visual hierarchy and consistency. --- ## When to Use This Skill ## Core Systems ## Quick Start: Design Tokens in Tailwind ## Typography Best Practices ## Color Theory ## Spacing Guidelines
2026-09-14 に上流ファイルから読み込まれたフロントマターとセクション見出し · 全 7,218 文字

01 できること

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

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

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

スキル自身の言葉で

このスキルは、タイポグラフィスケール、カラー理論、スペーシングシステム、アイコノグラフィの基礎を用いて、一貫性のあるアクセシブルなビジュアルシステムを構築する方法を教えます。モジュラー方式のタイプスケール、8ポイントグリッドのスペーシング、WCAG コントラスト要件を満たすセマンティックなカラーパレット、アイコンサイズシステムによるデザイントークンの確立をカバーしています。

このスキルは、Tailwind CSS、レスポンシブな流動的タイポグラフィ、セマンティックトークンを用いたダークモードテーマ、アクセシビリティ検証のための具体的な実装パターンを提供します。比率に基づくスケールと再利用可能なトークンシステムを定義することで、不揃いなスペーシング、コントラスト不足、場当たり的な数値といった、よくあるビジュアルデザインの課題に対応します。

生成されるもの

  • CSS のカスタムプロパティまたは Tailwind の config によるデザイントークンの定義
  • サイズバリアントを持つアイコンコンポーネント
プロンプト例を見る ↗

仕組み

  1. 01
    モジュラーなデザイントークンを確立する

    比率に基づくサイズ設定(0.75rem から 3rem)のタイポグラフィスケール、8ポイントグリッドのスペーシング(4px から 64px)、ブランド・状態・ニュートラル用のセマンティックカラートークンを定義します。

  2. 02
    レスポンシブなタイポグラフィを適用する

    clamp() を用いた流動的タイポグラフィでビューポートに応じたサイズ設定を行い、最適な読みやすさのために行の幅を最大65文字に保ちます。

  3. 03
    アクセシブルなカラーパレットを実装する

    WCAG のコントラスト比を満たすカラーシステムを構築します。本文テキストは 4.5:1、大きいテキストと UI コンポーネントは 3:1 とし、プログラムによるコントラストチェックを行います。

  4. 04
    一貫したアイコンシステムを作成する

    12px から 32px までのアイコンサイズスケールを定義し、size プロパティを受け取り flex-shrink-0 の挙動を維持する再利用可能なコンポーネントを用意します。

  5. 05
    セマンティックトークンでダークモードを設計する

    見た目ではなく用途に基づいたセマンティックトークンの命名を使用し、コンポーネントを変更せずに data 属性でテーマ切り替えができるようにします。

  6. 06
    垂直方向のリズムを維持する

    定義済みのスケール値を使って隣接要素に一貫したスペーシングルールを適用し、インターフェース全体に視覚的な調和を生み出します。

02 適合性を確認

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

この種類のブランドと design-system の作業が仕事の場合は、Claude Code または Codex で visual-design-foundations スキルを使用してください。適合性と制限事項は、スキル自身のファイルから取得されています。

適している場合

  • 新規プロジェクトのデザイントークンの確立
  • スペーシングとサイジングシステムの作成または改良
  • アクセシブルなカラーパレットの構築
  • アイコンシステムとビジュアルアセットのデザイン
  • デザインの視覚的な一貫性を検証する

    提供すべきもの

    • テーマ仕様セマンティックトークン戦略を用いたダークモードやマルチテーマシステムの実装要件

    03 スキルの内部

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

    SKILL.mdがエージェントに設定する、結果を変える4つの具体的な指示・デフォルト・制限。

    1. 8 ポイントグリッドのスペーシングを使用する

      すべてのスペーシング値は、定義済みのスペーシングスケールトークンを使い、0.25rem(4px)から 4rem(64px)まで 4px の倍数に従う必要があります。

    2. 厳密な行の高さの範囲を適用する

      見出しは 1.1 から 1.3、本文テキストは 1.5 から 1.7、UI ラベルは 1.2 から 1.4 の行の高さを使用し、適切な読みやすさを確保します。

    3. テキスト幅を 65 文字に制限する

      本文テキストの max-width を 65ch に設定し、最適な読みやすさを維持して広い画面での目の疲れを防ぎます。

    4. コンポーネントのスペーシング範囲を適用する

      スペーシングスケールを使用して、カードのパディングは 16〜24px、セクション間の間隔は 32〜64px、フォームフィールドの間隔は 16〜24px、アイコンとテキストの間隔は 8px とします。

    04 実際に使う

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

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

    Claude Code、Codex、または使用中のエージェントに visual-design-foundations を追加

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

    Terminal
    npx skills add https://github.com/wshobson/agents --skill visual-design-foundations

    plugins/ui-design/skills/visual-design-foundations/SKILL.md 用の汎用skills CLI フォームです。リポジトリによっては独自のパスが記載されている場合があります。

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

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

    Starter prompt
    Create a design token system for [project name] with an 8-point spacing grid, modular typography scale from 12px to 48px, and an accessible color palette including primary brand color [hex value], semantic status colors for success/warning/error, and a complete neutral gray scale. Implement both light and dark mode variants using semantic token naming. Include Tailwind configuration and verification that all text combinations meet WCAG AA contrast requirements.

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

    最初の結果を確認

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

    • すべてのテキストと UI コンポーネントの配色が、プログラムによるチェックを使用して WCAG コントラスト比の要件を満たしていることを確認します
    • フォントの読み込みで font-display swap が使用され、レイアウトのずれを防いでいることをテストします
    • clamp 関数を使用して、レスポンシブなタイポグラフィがビューポートサイズに応じて滑らかにスケールすることを確認します

    OpenDesign ではvisual-design-foundations をその SKILL.md のリンクからインポートします:Plugins → Add → Skill → Import from link。その後、上部バーで選択してください。

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

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

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

    Repository
    github.com/wshobson/agents ブランチ main
    スキルファイル
    plugins/ui-design/skills/visual-design-foundations/SKILL.md 検証時に記録されたコンテンツチェックサム。コミット 4236bb9
    License
    MIT LICENSE より
    リポジトリスター数
    39,635 wshobson/agents リポジトリ全体の GitHub スナップショット(2026年9月14日取得)。このカタログには18のスキルが含まれています。visual-design-foundations の評価や使用数ではありません。
    OpenDesign により検証済み
    2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。

    SKILL.md の中身

    1. このスキルを使用する場面トークンの確立、パレットの構築、一貫性の検証、ダークモードの実装などのシナリオを挙げます
    2. コアシステムモジュラー型のタイポグラフィスケール、8ポイントのスペーシンググリッド、CSSカスタムプロパティによるセマンティックなカラートークン構造を定義しています
    3. クイックスタート:Tailwindにおけるデザイントークンカスタムフォント、サイズ、カラー、スペーシング値でテーマを拡張するTailwindの設定例を提供しています
    4. タイポグラフィのベストプラクティスフォントの組み合わせ、clampによるレスポンシブな可変タイポグラフィ、フォント読み込み時のレイアウトシフト防止を扱っています
    5. カラー理論WCAGのコントラスト要件、ダークモードの実装戦略、コントラスト比を判定するプログラム関数について詳述しています
    6. スペーシングガイドラインコンポーネント間のスペーシング範囲を規定し、本文コンテンツの垂直リズムのパターンを示しています
    7. アイコノグラフィー12pxから32pxまでのアイコンサイズシステムを定義し、TypeScriptによるアイコンコンポーネントの実装を提供しています
    8. ベストプラクティス制約の確立、決定事項の文書化、アクセシビリティのテスト、セマンティックな命名の使用など、7つの原則
    9. よくある問題スペーシングの不整合、コントラスト不足、フォントの過剰使用、マジックナンバー、ダークモード計画の欠如などの問題を挙げています
    スキル自身による説明
    "タイポグラフィ、色彩理論、スペーシングシステム、アイコノグラフィの原則を適用し、一貫性のある視覚デザインを作成します。デザイントークンの確立、スタイルガイドの構築、視覚的階層と一貫性の向上を行う際に使用します。"

    SKILL.md の front-matter description です。ファイル全体は約7,218文字あります。GitHub でファイル全体を読む

    Visual Design Foundations

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

    OpenDesign をダウンロードし、SKILL.md リンクから visual-design-foundations をインポートし、上記のプロンプトを貼り付けて、結果の前に計画を確認してください。

    ターミナル
    npx skills add https://github.com/wshobson/agents --skill visual-design-foundations

    OpenDesign デスクトップ版

    ひとつのデザインシステムで、すべての制作物をブランドらしく

    完全な Vibe Design Workspace で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

    • Web、スライド、プロトタイプ、ダッシュボード、画像、動画
    • 140+ のデザインシステムと完全なテンプレート/スキルライブラリ
    • ローカル Codex と 21+ のコーディングエージェントを接続 · 無料
    無料ダウンロード

    macOS と Windows に対応