Communitygithub.com

ローカルデザインシステム

HTML/CSSファイル、Webアーティファクト、ランディングページ、ポスター、レポート、ダッシュボードモックアップなど、人が見る視覚的な成果物を生成する際に使用するスキルです。構造とセンスのみを統治し、成果物の配信方法(アーティファクトツール、ファイル、エクスポート)はタスク自体が決定します。

ローカルデザインシステム とは?

このスキルは、視覚的な成果物(HTML/CSSファイル、Webアーティファクト、ランディングページ、ポスター、レポート/メモのページ、ダッシュボードモックアップなど、人が見るあらゆるページ)を生成する際の設計規律を提供します。デザインの方向性決定前のコンテキスト収集、CSSカスタムプロパティによるトークンセットの定義、カラー・タイポグラフィ・スペーシング・ラディウスの一貫した運用を強制します。大きなグラデーションや絵文字のUI使用禁止、ダミーコンテンツ禁止、偽のクローム禁止などのアンチスロップルールを厳守し、アクセシビリティ(コントラスト比4.5:1以上、ヒットターゲット44px以上)を後付けではなく当初から組み込みます。レイアウトはフレックスボックスとグリッドをgapと共に使用し、フルードなページ設計を原則とします。また、Anthropic/Claudeブランド固有のカラーパレットやタイポグラフィの参照も含まれており、既存のデザインシステムやブランドが指定された場合はそれを正確に反映します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/altitudezhang-commits/agent-skills-pack/tree/HEAD/local-design-system

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

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

ドキュメント

ページ、アーティファクト、HTML/CSS出力のための設計規律

このスキルは、成果物が視覚的なものである場合に使用します。HTML/CSSファイル、Webアーティファクト、ランディングページ、ポスター、レポートやメモのページ、ダッシュボードモックアップ、あるいは人が見るあらゆるページが該当します。このスキルはセンスと構造のみを統治します — 成果物の配信方法(アーティファクトツール、ファイル、エクスポート)はタスク自体が決定します。

帰属:以下のルールは、BaoCutの組み込みdesignおよびdesign-systemスキルを改変したもので、これら自体もAnthropicのanthropic-designスキルから移植されました(出典ノートはreferences/brand-colors.mdを参照)。BaoCut-canvasのメカニズム(.dc.html、DCLogic、canvas.json、design_check、アセットインポートツール)は意図的に削除されています。ここではすべて、プレーンなHTML/CSSを直接記述することを前提としています。コピーした参照では、「board/artboard」をあなたが作成するページまたはファイルとして読み替え、<helmet>を<head>として読み替えてください。

レイアウト前に方向性を決定する

  • 何かを発明する前にデザインコンテキストを収集します:ユーザーのブランド、既存のデザインシステム、このページが隣接するコードベースやページ、ユーザーから提供されたスクリーンショットやファイル。高品質なデザインはそのコンテキストから生まれます。ゼロから製品全体をモックアップするのは最後の手段であり、質の低い成果物を生み出します。

  • ブランドやデザインシステムが指定されている場合は、それを正確に一致させます — 色、タイポグラフィ、スペーシング、ラディウス、フォント — そして、それにこのスキルのすべてのデフォルトを上書きさせます。ユーザーがブランドや製品を指定した場合は、盲目的にデザインするのではなく、実際のアセットを要求するか取得します。

  • 誰も答えられず、システムによる制約もない場合は、名前付きで意図的な美的方向性を1つ選びます(徹底的にミニマル、マキシマリスト、レトロフューチャー、エディトリアル、ブルータリズム、アールデコ、ソフトパステル、インダストリアル、ラグジュアリー、遊び心…)。前提を1行で述べ、それから構築します。誰も答えられない質問で終わらせてはいけません。毎回同じ見た目に静かに収束してはいけません。

  • 2つ以上の決定が結果を変える可能性があり、誰かが答えられる場合は、構築前に1度だけ質問します — 最大4つの質問で、各質問には2〜4の具体的で真に異なる選択肢を提示します(あなたの推奨を最初に)。決して boilerplate な要件収集は行いません。それ以外の場合は、決定し、選択した内容を述べて、先に進みます。

構築前にトークンセットを定義する

  • レイアウトを書く前に、小さなトークンセットを書き留め、それらの値のみを使用します。ファイルの先頭(またはページが読み込むトークンファイル)に :root CSSカスタムプロパティブロックとして配置します — ページが使用するすべての色、サイズ、フォントはそこに遡り、値ごとに1つのソースを持ちます:
:root{
  --surface: #faf7f2;              /* 唯一のトーンベース */
  --ink: #211d19;
  --accent: oklch(0.62 0.14 45);   /* 0〜2のアクセント、oklch */
  --font-display: "Space Grotesk", "Avenir Next", sans-serif;
  --font-body: "Source Sans 3", system-ui, sans-serif;
  --space-1: 4px; --space-2: 8px; --space-3: 16px; --space-4: 24px; --space-5: 40px;
  --radius-sm: 6px; --radius-md: 10px;
}
  • カラー:1つのトーンベース(ウォーム、クール、またはニュートラル)。白と黒はわずかな色合いを帯びます — 純白の彩度は0.02未満に抑えます。ページ全体の背景に純粋な#FFFを決して使用しないでください。アクセント:0〜2、同じ彩度と輝度を持ち、色相のみが異なるoklchで表現します。ブランド/システムカラーを優先します。制約が強すぎる場合は、新しい色相を発明する代わりに、そこから調和のとれたoklchカラーを導出します。

  • タイポグラフィ:1〜3ファミリー — 特徴的なディスプレイフェイスと洗練されたボディフェイスの組み合わせ。すべてのWebフォントには、メトリックマッチングされたシステムフォールバックを設定します。フォールバックはフォントの読み込み中および埋め込みできない場所でレンダリングされるためです。第一選択として汎用的なデフォルト(Inter、Roboto、Arial、Fraunces)は避けます。文字間隔は、意図的な効果で必要がない限り0に保ちます。

  • また、同じトークンパスで、小さなタイプスケール(ディスプレイ/タイトル/見出し/本文/スモール/キャプションにサイズ、ウェイト、行の高さを含む)、スペーシングスケール、ラディウススケールも固定します。実際のソースからの正確な値はそのままコピーします — 4/8pxグリッドに丸めたりスナップしたりしません。

アンチスロップルール(厳守)

  • 装飾としての大きなグラデーションの塗りつぶしやグラデーション背景、青紫グラデーション、色付きの左ボーダーアクセントのある角丸カード、アイコンやUIグリフとしての絵文字は禁止です(アイコンはインラインストロークSVGか実際のアイコンセットを使用します。絵文字はそれが真にブランドの一部である場合のみ表示されます)。

  • フィラーコンテンツ禁止:Lorem ipsum、架空の統計、推薦文、スペースを埋めるために追加された「データスラップ」は禁止です。すべての要素はその場所に値するものです。何もないように感じるセクションは、コンテンツを発明する問題ではなく、レイアウトの問題です。不足している事実は、[YOUR PRICE]のように視覚的にマークされたプレースホルダーになります。

  • 偽のクローム禁止:デバイスモックアップ内に偽の電話ステータスバーやキーボードを描かないでください。

  • 実行の野心を方向性に合わせます:マキシマリストデザインはリッチなエフェクトを取得します。ミニマルデザインはスペーシングと詳細における抑制と精度を取得します。鮮やかなアクセントを持つ支配的な色は、臆病で均等に分散された色よりも優先されます。非対称性、オーバーラップ、たっぷりとしたホワイトスペース、または制御された密度は、デフォルトの中央揃えグリッドよりも優先されます。

レイアウトの仕組み

  • 兄弟要素のグループ(ボタン、チップ、カード、ナビゲーション項目、ツールバー)は、flexまたはgridとgapを使用してレイアウトします — ホワイトスペーステキストノードや兄弟間の要素ごとのマージンは使用しません。インラインフローは、中に時々<a>/<strong>が入った散文用であり、UI要素を配置するためのものではありません。

  • ページはフルードです:ルートにpx幅は設定せず、サイドパディング付きのmax-widthコンテナ、%/rem/frでのサイジング、グリッドはrepeat(auto-fit, minmax(min(<min>px, 100%), 1fr))と記述して、スマートフォンで1列に折りたたまれ、オーバーフローしないようにします。vhは、本当に画面全体を埋めるルートにのみ使用します。さらにコンテンツが続くセクションにはpx/remのmin-heightを使用します。切り詰められるよりは少し高すぎる方を優先します。

  • 固定サイズのルートは、固定フォーマット(デバイスモックアップ、ポスター、ソーシャルイメージ、印刷物)にのみ使用します。モバイルアプリ画面は390×844です。ページは電話の幅で機能するように設計されています — タイトルが不格好に改行されたり、グリッドが押しつぶされたり、テキストが読みやすさを下回るサイズに縮小されたりしてはいけません。

  • 配信ページ内の図は、通常のインラインSVG(<figure>内で問題ありません)です。誰かが編集する必要があるかもしれないラベルやコールアウトは、実際のテキストとして保持します。

アクセシビリティは後からチェックするのではなく、最初から描き込む

  • 静的なモックアップでも実際の要素を使用します:<button>、<a href>、<label>付きの<input>。代わりとしてdiv/spanにroleやonClickを決して付けないでください — キーボードはそれをスキップし、スクリーンリーダーは何も取得しません。アイコンのみのボタンにはaria-labelを設定します。装飾的なSVGにはaria-hidden="true"を、意味のあるSVGにはrole="img"とラベルを設定します。

  • テキストのコントラストは、背景との関係で少なくとも4.5:1(24px以上のテキストは3:1)とします。よくある失敗は、グレーのキャプションテキストと白いテキストの下の色付き塗りつぶしです — 合格するまで両方を暗くします。

  • 区別する必要がある色は、色相だけでなく明度も異なっていなければなりません。赤/緑よりも青/オレンジを優先します。

  • ヒットターゲットは少なくとも44pxとします。印刷用本文テキストは少なくとも12ptとします。

コンテンツと編集の規律

  • 素材を追加する前に質問します:追加のセクション、ページ、コピーが作品を向上させる場合は、頼まれてもいないのに追加するのではなく、最初に質問します。

  • 小さなターゲットを絞った変更は、その場所だけを変更します:他のすべてのレイアウト値、スペーシング、フォント、サイズ、位置、色、コンテンツはそのまま維持します。要求された変更を行い、その後、頼まれてもいないことを実行する代わりに、より大きな変更を提案します。再デザインまたは最初からやり直すように要求された場合は異なります — その場合は大きな変更を行います。

  • 既存のページやドキュメントを拡張する場合は、まずそのビジュアルボキャブラリー(スタイル、パレット、トーン、ホバーステート、シャドウとカードのパターン、密度)を読み取り、それに合わせて記述します。

  • ソースを取得できるインターフェースの再現を求められた場合は、実際のソースから作業します:コンポーネントとスタイルを読み、実際のアセットをコピーし、正確な値をコピーします。ソースが存在する場合は、記憶やスクリーンショットから決して再現しないでください。その会社に勤務していない人のために、他社の特徴的な独自デザインを再現しないでください。代わりに、ユーザーの実際の目標に向けた独自のデザインを提供します。

ランディングページと印刷物

  • ランディングページ:何が提供されるかを一文で述べるヒーローを1つ、明確なコールトゥアクションを1つ配置します。訪問者が信頼できる証拠(推薦文、ロゴ、数字 — ユーザーのもの、または視覚的にマークされたプレースホルダー)を配置します。機能を列挙するのではなく、実際の異論に答えるベネフィットセクションを配置します。ページごとに1つのプライマリアクションを、ページが下がるにつれて繰り返します。コピーが製品です:具体的で、ユーザーが実際に販売しているものに根ざしており、交換可能なマーケティングの boilerplate では決してありません。

  • 印刷物(ポスター、チラシ、パンフレット、メモ、レポート、PDFにエクスポートされるもの):開始する前にreferences/print.mdを読んでください — まず固定ページかフロードキュメントかを決定し、実際の用紙サイズ(レター816×1056、A4 794×1123 CSS px)を使用し、≥40pxのセーフマージン、≥1pxの罫線、#767676より薄いグレーテキストは使用せず、チラシの階層は部屋の向こうから3秒で読めるようにします。

Anthropicブランドの作業

  • Anthropic/Claudeブランドを冠する作業の場合:ベースアイボリー#FAF9F5、テキストスレート#141413、アクセントクレイ#D97757、セリフのディスプレイタイプとサンセリフのボディ。完全なウォームグレーランプ、補助パレット、ロゴルールはreferences/brand-colors.mdにあります。フォントスタックとタイプスケールはreferences/brand-typography.mdにあります。クリームベース+セリフ見出し+テラコッタの習慣は、Anthropicブランドの作業、またはブリーフがそれを求める場合のためのものです — すべてのデフォルトではありません。

参考文献

  • references/craft.md — これらのルールの完全な根拠:ユーザーとの方向性選択、バリエーションとワイヤーフレームのラウンド、ランディングページの構造、ソースからのインターフェース再現、共有コンテンツルール。デザインの決定が争われている場合や、作品に深みが必要な場合に読んでください。

  • references/brand-colors.md — Anthropicブランドカラーシステム(ウォームグレー、Claudeパレット、データビジュアライゼーションスケール)とその出典ノート。

  • references/brand-typography.md — メトリックマッチングされたフォールバックとブランドタイプスケールを備えたAnthropicブランドフォントスタック。

  • references/print.md — 印刷物のクラフト:固定ページとフローページ、用紙サイズと単位、マージン、テーブル、チラシルール。

関連スキル