Communitygithub.com

Cozythecoder/frontend-design-md

プロジェクトタイプを自動検出し、意図を分析して、60以上のリファレンスパターンから最適なデザインシステムを適用します。

frontend-design-md とは?

このAIエージェントスキルは、フロントエンドプロジェクトの構築やUI改善において、自動的にプロジェクトタイプを検出し、60以上のデザインシステムライブラリから最適なものを提案・適用するインテリジェントなワークフローを提供します。対象となるのはHTML, CSS, JS, JSX, Vue, Svelteなど、あらゆるウェブプロジェクトファイルです。「design this」「make it look good」のような自然言語の指示や、特定のカテゴリ(ランディングページ、ダッシュボード、ポートフォリオ、Eコマースなど)の言及をトリガーに、4段階のプロセス(プロジェクト分析、事前チェック、デザインシステム適用、検証)を実行します。Linear, Vercel, Stripe, Apple, Teslaといった著名企業のデザインシステムを参考にしたパターンが含まれており、既存のプロジェクトに合わせて色、タイポグラフィ、スペーシング、コンポーネントをインテリジェントに適応します。また、アクセシビリティやパフォーマンスのチェックも自動で行い、高品質なUI実装を支援します。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Cozythecoder/frontend-design-md/tree/HEAD/skills/design-systems

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

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

ドキュメント

デザインシステムインテリジェンススキル

プロジェクトタイプを自動検出し、意図を分析して、60以上のリファレンスパターンから最適なデザインシステムを適用します。

自動検出トリガー

このスキルは以下の場合に有効化されます:

  • ユーザーがWebプロジェクトファイル(HTML, CSS, JS, JSX, Vue, Svelte)を作成・変更した場合
  • ユーザーが「設計して」「見栄えを良くして」「UIを改善」「デザインシステムを適用」と発言した場合
  • ユーザーが特定のカテゴリ(「ランディングページ」「ダッシュボード」「ポートフォリオ」「Eコマース」)に言及した場合
  • プロジェクトに明示的なデザインシステムが指定されていない場合

フェーズ1: プロジェクト分析(自動)

デザインシステムを選択する前に、必ず分析を実行してください。

ステップ1: プロジェクトカテゴリの検出

プロジェクトファイルをスキャンしてタイプを判別します:

# 指標のチェック
detections = {
    'saas-landing': ['pricing', 'signup', 'features', 'hero', 'testimonials'],
    'dashboard-app': ['dashboard', 'chart', 'table', 'sidebar', 'widget'],
    'e-commerce': ['product', 'cart', 'checkout', 'shop', 'inventory'],
    'portfolio': ['portfolio', 'gallery', 'project', 'creative', 'art'],
    'content-publication': ['blog', 'article', 'post', 'content', 'newsletter'],
    'brand-showcase': ['brand', 'story', 'about', 'mission', 'values'],
    'developer-tool': ['api', 'docs', 'code', 'terminal', 'github'],
    'service-business': ['service', 'contact', 'process', 'team', 'consulting']
}

ステップ2: 現在の状態の分析

既存のデザイントークンを確認:

  • CSS/SCSS/Tailwind設定内の色
  • タイポグラフィ(font-family, font-sizeの宣言)
  • スペーシング(margin, padding, gapのパターン)
  • コンポーネント(ボタンクラス、カードクラス)

ステップ3: デザインシステムライブラリとのマッチング

60以上のリファレンスパターンと比較:

プロジェクトタイプ推奨デザインシステム
SaaSランディングlinear.app, vercel.com, supabase.com, stripe.com, notion.so
ダッシュボード/アプリlinear.app (UI), github.com, vercel.com/dashboard, supabase.com/dashboard
Eコマースapple.com, shopify.com, nike.com
ポートフォリオframer.com, webflow.com, cargo.site
コンテンツ/ブログmedium.com, substack.com, stripe.com/blog
開発者ツールvercel.com, github.com, docs.rs, nextjs.org
サービスビジネスcursor.com, intercom.com, webflow.com
ブランド/エージェンシーtesla.com, apple.com, nike.com

ステップ4: 信頼度スコアリング

マッチングの信頼度を計算:

confidence = (
  category_match * 0.40 +      # コンテンツは一致しているか?
  token_similarity * 0.30 +      # 色/タイポグラフィの重複?
  component_patterns * 0.20 +    # ボタン/カードパターン?
  layout_structure * 0.10        # グリッド/フレックスパターン?
)

If confidence > 0.75: 最上位マッチを自動提案
If 0.50-0.75: 2~3の代替案を提示
If < 0.50: カテゴリの優先順位をユーザーに確認

フェーズ2: 事前チェックプロトコル

アセット検査チェックリスト

デザインシステムを適用する前に:

  1. project-context.md の確認

    • プロジェクトルートに存在するか?
    • 存在しない場合:プロジェクト名、目標、対象読者を含むテンプレートから作成
  2. 現在のアセットの分析

    # 自動実行
    python3 ~/.claude/skills/design-systems/scripts/inspect-project.py
    

    チェック項目:

    • ロゴは存在するか?(SVG推奨)
    • プロダクト画像はあるか?(ヒーロー用透過PNG?)
    • カラースキームは既に定義されているか?
    • タイポグラフィは既に設定されているか?
    • 既存のコンポーネントライブラリはあるか?
  3. 構成階層の決定

    • ヒーロー要素: 最も大きなビジュアル(プロダクト画像、イラスト、見出し)
    • サポート要素: 機能、メリット、社会的証明
    • アクセント: 装飾要素、パターン
  4. 技術的制約の検証

    • フレームワークの検出(React, Vue, vanillaなど)
    • CSSアプローチ(Tailwind, CSS-in-JS, SCSSなど)
    • アニメーション機能(GSAP読み込み済み? Framer Motion?)
    • パフォーマンス予算(モバイルファースト? デスクトップ?)

フェーズ3: デザインシステムの適用

ステップ1: 選択とロード

分析に基づき、推奨するDESIGN.mdをロード:

推奨: Linear.app Design System
信頼度: 87%

マッチング理由:
- SaaSランディングページを検出(価格、機能セクション)
- ダークモード設定を検出
- クリーンなタイポグラフィ(Inter風)を発見
- カードベースのレイアウトパターンが存在

ステップ2: プロジェクトへの適応

生のコピーペーストはしないでください。 プロジェクト分析に基づいて適応:

色:

  • プロジェクトにブランドカラーがある場合:デザインシステムの役割にマッピング
  • 色がない場合:デザインシステムのパレットを直接使用
  • 例:「あなたの青 #3B82F6 → プライマリアクセントの役割」

タイポグラフィ:

  • Inter/システムフォントを使用している場合:デザインシステムのスケールを維持
  • 異なるフォントを使用している場合:サイズ/ウェイトを適応
  • 例:「Interの代わりにRoboto → ウェイトを400→500に調整」

スペーシング:

  • 既存のスペーシングスケールを確認
  • デザインシステムにマッピング、または一貫性があれば維持

コンポーネント:

  • 既存のクラスをデザインシステムのパターンにマッピング
  • 例:「あなたの .btn-primary → デザインシステムのプライマリボタン」

ステップ3: 実装チェックリスト

優先順位に従ってデザインシステムを適用:

  1. 基盤(重要)

    • カラーCSS変数がマッピングされている
    • タイポグラフィスケールが定義されている
    • スペーシングシステムが確立されている
    • ベースリセット/ノーマライズが適用されている
  2. レイアウト(高)

    • セクション間隔(ヒーロー、コンテンツ、フッター)
    • コンテナ幅(max-width, padding)
    • グリッドシステム(該当する場合)
  3. コンポーネント(中)

    • ボタン(プライマリ、セカンダリ、ゴースト)
    • カード(使用されている場合)
    • フォーム/入力(使用されている場合)
    • ナビゲーション(ヘッダー、フッター)
  4. 仕上げ(低)

    • シャドウ/エレベーション
    • ボーダー半径の一貫性
    • フォーカス状態
    • ホバートランジション

フェーズ4: 検証

品質ゲート

適用後に実行:

視覚的一貫性チェック:

# 違反をチェック
violations = []

# 1. 色の数
if unique_colors > 8:
    violations.append("色が多すぎます - パレットを簡略化してください")

# 2. タイポグラフィスケール
if font_sizes > 12:
    violations.append("タイポグラフィが体系的ではありません - サイズを統合してください")

# 3. スペーシングの一貫性
if spacing_base not in [4, 8, 16]:
    violations.append("スペーシングが4/8pxグリッドに従っていません")

# 4. タッチターゲット
if touch_targets < 44:
    violations.append("タッチターゲットが44px未満です")

アクセシビリティチェック:

  • テキストのカラーコントラスト >= 4.5:1
  • フォーカスインジケータが視認可能
  • 動作減少設定が尊重されている
  • 必要な箇所にARIAラベルがある

パフォーマンスチェック:

  • レイアウトスラッシングを起こすアニメーションがない
  • 画像が最適化されている
  • フォントがサブセット化されている(カスタムフォントの場合)

参考資料

デザインシステム分析

適応ガイド

検証

カテゴリ別パターン

スクリプト

  • scripts/analyze-project.py — カテゴリと現在のトークンを検出
  • scripts/match-design-system.py — ライブラリと比較
  • scripts/validate-application.py — 品質ゲート
  • scripts/generate-adaptation.py — 既存をデザインシステムにマッピング
  • scripts/inspect-assets.py — 画像、ロゴ、ブランドアセットをチェック

デザインシステムライブラリ

60以上のシステムが ../design-systems/ にカテゴリ別に整理されています:

SaaS / 開発者ツール

  • linear.app (ダーク、Inter、510ウェイト)
  • vercel.com (Geist、シャドウボーダー)
  • supabase.com (温かみ、PostgreSQL風)
  • stripe.com (コンテンツリッチ、グラデーション)
  • notion.so (親しみやすい、丸み)
  • github.com (機能的、高密度)
  • cursor.com (エディタ重視、シンタックスカラー)

Eコマース / プロダクト

  • apple.com (SF Pro、バイナリコントラスト、ピル型CTA)
  • shopify.com (二極化、Polarisトークン)
  • nike.com (大胆、ダイナミック、イメージファースト)

クリエイティブ / ポートフォリオ

  • framer.com (遊び心、グラデーション、弾むような動き)
  • webflow.com (プロフェッショナル、構造化)

コンテンツ / 出版

  • medium.com (読書重視、セリフ本文)
  • substack.com (温かみ、ニュースレター中心)

エンタープライズ

  • ibm.com (Carbonデザイン、体系的)
  • salesforce.com (機能的、高密度)

自動車 / ラグジュアリー

  • tesla.com (ミニマル、プロダクト中心)
  • ferrari.com (ドラマチック、赤いアクセント)
  • bmw.com (技術的、正確)

使用フロー

ユーザー:「SaaSのランディングページを作って」
↓
スキル:プロジェクトを分析...
       検出:SaaSランディングの意図
       現在の状態:デザインシステムなし
↓
スキル:linear.appを推奨(87%一致)
       代替案:vercel.com, stripe.comを提示
↓
ユーザー:「Linearスタイルで」
↓
スキル:事前チェックプロトコルを実行
       - project-context.mdを作成
       - アセットを分析
       - 技術スタックを確認
↓
スキル:Linearデザインシステムを適用
       - カラートークンをマッピング
       - タイポグラフィスケールを設定
       - コンポーネントを実装
↓
スキル:出力を検証
       - カラーコントラストチェック
       - スペーシングの一貫性
       - 品質ゲートレビュー
↓
出力:Linearにインスパイアされたデザインのプロジェクト

設定

プロジェクトルートに .design-system を作成することで、自動検出をオーバーライドできます:

{
  "system": "linear.app",
  "theme": "dark",
  "adaptations": {
    "primaryColor": "#3B82F6",
    "fontFamily": "Inter"
  }
}

このスキルは、60以上のデザインシステムコレクションと、自動検出、事前チェック、検証、インテリジェントな適応というエピックスタイルのワークフローを融合させたものです。

関連スキル