Communitygithub.com

ビジュアルデザイン

デザインシステムの構築や変更(デザイントークン、カラーパレット、コントラスト、書体、タイプスケール、スペーシングスケール、ダークモード、モーショントークン、コンポーネント状態仕様など)を行う際に使用します。特定のページのレイアウトや批評、リデザインには `designer` を、画像生成には `artist` を使用してください。

ビジュアルデザイン とは?

このスキルは、デザインシステム全体の基盤を構築・管理するためのものです。カラー、タイポグラフィ、スペース、シェイプ、奥行き、モーションの各トークンと、それらから構築されるコンポーネント仕様をカバーします。主な目的は、一度システムを構築すれば、個々のページでそれを再利用できるようにすることです。具体的なページデザインや画像生成は対象外で、それらは別のスキル(`designer`、`artist`)が担当します。このスキルは、デザインの方向性を言語化し、セマンティックトークンを適切に使い分け、アクセシビリティ(WCAG 2.2)に準拠したコントラストを確保するためのルールと手順を提供します。特に、OKLCH色空間を用いたパレット構築、中立色の色味付け、ダークモードでのトークン再マッピングなど、重要な設計原則を網羅しています。

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

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

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

ドキュメント

ビジュアルデザイン は何をしますか?

あらゆる画面の背後にあるシステム:色、文字、スペース、シェイプ、奥行き、モーションのトークンと、それらから構築されるコンポーネント仕様。designer スキルはこのシステムを実際のページに適用します。システムを一度構築すれば、ページはそれを活用できます。

最も重要なルール

  1. トークンを作成する前に、デザインの方向性を言葉で記述します。 3~4文で、誰のためのものか、どんな印象を与えるべきか、絶対に与えてはいけない印象、そしてテーマから借用する要素を1つ記述します。すべてのトークンの決定は、その段落に照らしてチェックされます。
  2. コンポーネントはセマンティックトークンを参照し、プリミティブを直接参照しません。 --color-text-primary であって、--grey-900 ではありません。ダークモード、テーマ変更、リブランドは、書き換えではなく、マッピングの変更になります。
  3. すべての実際の組み合わせについて、両方のテーマでコントラストをチェックします。 以下の表を参照してください。白で合格するパレットでも、色付きのサーフェス上では不合格になることがあります。
  4. デフォルトは決定ではありません。 フレームワークのグレー、すべてにInter、すべてのボックスに4pxの半径:それぞれは問題なく見えますが、組み合わせると他のすべての製品と同じに見えます。各値を決定するか、意図的に受け入れてください。
  5. すべてのコンポーネント仕様は、すべての状態をリストします。 デフォルト、ホバー、フォーカス、アクティブ、無効、ローディング、エラー、該当する場合は選択済み。状態が欠落していると、ビルド中に一貫性なく発明されます。
  6. より少ない値を、一貫して使用します。 ランダムに使用される14段階のスケールよりも、どこでも一貫して使用される6段階のスケールの方が優れています。

使用すべきでない場合

  • 特定のページの配置、ファーストビューの選択、画面の批評、リデザインの実行:designer。
  • イラスト、アイコン、ヒーローイメージ、ブランドマークの生成:artist。
  • チャートやデータビジュアライゼーションのパレット:frontend スキルの references/charts.md。カテゴリカルチャートの色には、ブランドパレットにはない制約があります。
  • フレームワークでのトークンの実装:frontend。

構築順序

各レイヤーは前のレイヤーに依存します:

  1. 方向性の段落。
  2. 色:プリミティブ、次にセマンティックトークン。
  3. タイポグラフィ:書体、次にスケールと役割。
  4. スペーシングスケールとグリッド。
  5. 半径、境界線、および elevation。
  6. モーショントークン。
  7. コンポーネントトークンとコンポーネント仕様。

色

構造:

プリミティブ(生の値、色相ごとに1つのランプ、例:50, 100 ... 900, 950):
  --blue-600: oklch(0.55 0.17 255)

セマンティックトークン(プリミティブを参照し、役割で命名):
  --color-bg, --color-surface, --color-surface-raised
  --color-text, --color-text-muted, --color-text-on-accent
  --color-accent, --color-accent-hover
  --color-border, --color-focus-ring
  --color-danger, --color-success, --color-warning (それぞれにテキストセーフなバリアントを伴う)

考慮されたパレットとデフォルトのパレットを分けるルール:

  • ランプはOKLCHで構築します。 明度は色相間で知覚的に均一になるため、600の青と600の緑は同じ視覚的重みを持ちます。HSLの明度は誤解を招きます。
  • ニュートラルに色味を加えます。 純粋なグレーや純粋な黒、白は、所有感がありません。ブランドの色相に向かって少量のクロマ(約0.005~0.015)を追加します。
  • 色付きサーフェス上のテキスト には、そのサーフェスの色相の暗い色合いを使用し、ニュートラルグレーは使用しません。色の上にグレーは、くすんで見えます。
  • コミットメントレベルを選択し、それを維持します。 抑制的(ニュートラルな基盤、1つのアクセント)、コミット(ブランド色相が全体に存在)、フルパレット、または染み込んだ(ブランド色相が基盤)。中途半端なコミットメントは優柔不断と読み取られます。
  • 色だけで意味を伝えないでください。 アイコン、ラベル、またはパターンと組み合わせてください。
  • 現在の反射的な選択に注意してください。 暖かいクリーム色のページにセリフのディスプレイとテラコッタのアクセント、または、ほぼ黒に1つの酸っぱいアクセントは、何も決定されていない場合に生成されたデザインが手を伸ばすものです。方向性の段落がそれらを要求する場合にのみ使用してください。

コントラスト(WCAG 2.2)

ペアAAAAA
本文テキスト(ラージテキスト未満)4.5:17:1
ラージテキスト:24pxレギュラー、または約18.7pxボールド以上3:14.5:1
UIコンポーネントの境界線、アイコン、フォーカスインジケーター、意味を持つチャートマーク3:1なし
  • ユーザーに何かを伝えるプレースホルダーテキストはテキストです:4.5:1。
  • 無効なコントロールは対象外ですが、ユーザーはコントロールが存在することを確認できる必要があります。
  • 計算された色(不透明度とオーバーレイを含む)を測定します。色付きカード上の60%不透明度のラベルは、新しい色です。

タイポグラフィ

  • 習慣ではなく、コンテンツのレジスターに合わせて書体を選択します。 3つの役割:特徴のあるディスプレイフェイス(控えめに使用)、読みやすいボディフェイス、ラベル、キャプション、データ用のユーティリティフェイス(表の数値用のタブラー図形)。
  • 明確なコントラストでペアリングする(セリフとサンセリフ、ジオメトリックとヒューマニスト)か、1つのファミリーをウェイト間で使用します。類似しているが同一ではない2つの書体は、ミスと読まれます。
  • モジュラースケール。 1つの比率を選択します:高密度なプロダクトUIには1.2、コンテンツとマーケティングには1.25~1.333。サイズではなく役割に名前を付けます:display、h1 ~ h4、body-lg、body、body-sm、label、caption。
  • メジャー 本文テキストは60~75文字(max-width: 70ch)。
  • ディスプレイタイプ は、よりタイトなトラッキング(約 -0.02em ~ -0.04em)とサイズ上限(約 clamp() で6rem)を設定します。大きすぎると、意図的とは見なされにくくなります。
  • 見出しには text-wrap: balance、本文には text-wrap: pretty。
  • 行の高さ:本文は約1.5、ディスプレイは1.1~1.25。

スペース、シェイプ、奥行き

  • スペーシングスケール は4または8をベースに:例:4、8、12、16、24、32、48、64。コンポーネントは生のピクセル値ではなくトークンを使用します。
  • 半径:2つまたは3つの値と、どこに適用するかのルールを設定します。ネストされた半径:内側の半径は、外側の半径からそれらの間のパディングを引いた値に等しくなります。
  • Elevation:3つまたは4つのレベルで、それぞれに役割(通常のカード、ドロップダウン、モーダル)を割り当てます。ダークテーマでは、より重い影ではなく、より明るいサーフェスで elevation を上げます。

モーション

  • トークン:持続時間(例:120ms、200ms、320ms)と2つまたは3つのイージングカーブ(1つは出現用、よりシャープなものは消通用)。要素はそれらを再利用します。要素ごとに値を選ぶことはありません。
  • モーションは変化を説明します:何がどこから来たのか、何が反応したのか。装飾だけのモーションは、生成されたように見えます。
  • 1つの振り付けられた瞬間は、すべてが同時にフェードインするよりも優れています。
  • prefers-reduced-motion: reduce を尊重します:動きと長いトランジションを削除し、不透明度の変更は維持します。
  • ホバー時に写真を拡大縮小しないでください。コンテナ(影、境界線、背景)をアニメーション化します。

ダークモード

  • ダークテーマは、セマンティックトークンの再マッピングであり、決して反転ではありません。基盤には純粋な黒ではなく、ダークグレーを使用し、発光するアクセントのクロマを下げます。
  • ダークテーマですべてのコントラストペアを再チェックします。
  • 間違ったテーマのフラッシュを防ぎます:最初のペイントの前に、ドキュメントヘッド内の小さなインラインスクリプトでテーマを決定します。

ダークモードでのテーマ切り替え、永続化、画像の実装については、references/dark-mode.md を参照してください。

コンポーネント仕様

コンポーネント仕様を記述する前に、references/component-spec.md を参照してください。テンプレートと状態チェックリストが含まれています。

注意点

  • 100から900と名付けられた11段階の色合い。 それは9段階です。カウントと名前が一致するようにランプに名前を付けます(50、100 ... 900、950 は11になります)。
  • 「ラージテキスト」は18ポイントを意味し、18ピクセルではありません。 18pxのレギュラー本文テキストには3:1ではなく4.5:1が必要です。ラージテキストのしきい値は、24pxレギュラーまたは約18.7pxボールドです。
  • コンポーネント内のプリミティブトークン。 最初のテーマまでは機能します。その後、すべてのコンポーネントを編集する必要があります。
  • モックではなく、ビルドでコントラストをチェックします。 不透明度、オーバーレイ、アンチエイリアシングは実際の色を変更します。レンダリングされたピクセルまたは計算されたスタイルを測定します。
  • 1つのグローバルな調整でローカルな問題を修正します。 1つの失敗したペアを救うためにパレット全体を暗くすると、他のすべてのペアがずれます。ペアのトークンを修正します。
  • 誰も使わないトークン、またはトークン化されていない生の値。 どちらもシステムとビルドが乖離していることを意味します。ビルド内の生の16進数値とピクセル値を grep します。
  • 1つの見出しのためにロードされる新しいフォント。 各書体は読み込み時間を要します。システムがすでにロードしている書体を使用します。

検証

  • 方向性の段落が記述され、各トークンファミリーがそれに遡れること。
  • すべてのテキストとUIのペアが、ライトテーマとダークテーマの両方でAAに合格し、構築されたページ上で測定されていること。
  • コンポーネントがセマンティックトークンのみを使用していること:grep でコンポーネントコードに生の色やスペーシングの値が見つからないこと。
  • すべてのコンポーネント仕様にすべての状態がリストされていること。
  • reduced-motion 設定がテストされ、動きが残っていないこと。
  • 反対のシステム設定でハードリロードしたときに、テーマ切り替えでフラッシュが発生しないこと。

Individual skills in this repo

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

api-design

Use when designing or changing an HTTP API contract, adding or editing a route, endpoint or webhook, writing an OpenAPI spec, choosing error, pagination or versioning shapes. Also when asking "is this a breaking change". Not for server internals such as jobs, retries or rate-limit storage; use `backend-patterns`.

artist

Use when making or directing visual assets such as illustrations, hero images, icons, logos, brand marks, textures or diagrams, or writing prompts for an image-generation model. Covers art direction, reference boards and critique against a brief. Not for page layout; use `designer`. Not for palettes and tokens; use `visual-design`.

copywriter

Use when writing, rewriting or reviewing words a customer reads, such as landing or marketing pages, headlines, taglines, calls to action, pricing pages, product descriptions, onboarding text, button labels, error messages and empty states. Not for long-form docs or articles; use `docs`. Not for positioning strategy; use `marketing`.

designer

Use when asked to critique, redesign or review the layout and hierarchy of a page, screen, landing page or dashboard (hero, CTAs, card grids, testimonials), or when a design \"looks off\", \"looks generic\" or \"looks AI-made\". Use it for any layout feedback, even if the word design is not used. Not for tokens, palettes or type scales; use `visual-design`. Not for images; use `artist`.

frontend

Use when building, reviewing or fixing browser UI, such as pages, components, forms, client state, charts, print or PDF views, accessibility or web performance (Core Web Vitals, bundle size, slow renders). Not for visual direction, layout critique or brand (use `designer` or `visual-design`). Not for native or React Native apps (use `mobile`).

game-design

Use when designing or reviewing how a game plays: core loop, mechanics, game feel and juice, difficulty curve, progression, economy and balance, tutorials, HUD and menus or a game design document (GDD) and playtest plan. Not for engine code or rendering (use `frontend`) or for non-game product UX (use `ux-research`).

ux-research

Use when planning or synthesising user research (interviews, usability tests, surveys), mapping a journey or job to be done, specifying an interaction's states, or running a heuristic review of a flow. Not for menus, labels, taxonomy or site structure; use `information-architecture`. Not for visual polish; use `designer`.

関連スキル