mcpField
D
design-system-analyzer

design-system-analyzer

github.com/nakanosankuデザイン・UI16241 回インストール42 週間前に更新
リポジトリ

design-system-analyzer について

design-system-analyzerはChromeDevToolsでウェブサイトのCSSを調べ、トークン、アニメーション、操作状態、レイアウト情報を抽出します。所定のテンプレートに沿ってデザインシステムのプロンプトを作成し、既存サイトの視覚仕様をまとめる設計・開発作業に向いています。

主な機能

  1. 01CSS変数とデザイントークンの抽出
  2. 02キーフレーム、アニメーション、遷移の確認
  3. 03操作状態、タイポグラフィ、レイアウトの分析
  4. 04テンプレートに沿ったプロンプト作成

活用シーン

  1. 01既存サイトの色、余白、書体の仕様整理
  2. 02モーションやコンポーネントのスタイルを含む実装プロンプト作成

MCP 対応

ワークフローではChrome DevTools MCPを使ってサイトを開き、調査します。MCPサーバーを提供するとは記載されていません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nakanosanku/ohmyskills --skill design-system-analyzer

インストール後、Claude Code で/design-system-analyzerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
analysis-guide.md
design-system-template.md
setup-guide.md

詳細

デザインシステムアナライザー

ChromeDevTools を通じてウェブサイトを分析し、詳細な CSS ロジック(キーフレーム、トランジション、トークン)を抽出して、包括的なデザインシステム用システムプロンプトを生成します。

重要なルール

  1. 最終プロンプトは、references/design-system-template.md の構造と完全に同じ形式で出力する必要があります。
  2. コンテキストがあふれないよう、抽出データを制限する必要があります(上限については analysis-guide.md を参照)。
  3. テンプレートのプレースホルダーをすべて、抽出または観察した値で埋める必要があります。
  4. セクションを省略してはなりません。データがない場合は「未観察」と記載してください。

ベストプラクティス:自分の Chrome を使う

最高の使用感を得るために(CAPTCHA が表示されず、ログイン Cookie を共有できるように)、次のコマンドで Chrome を実行するようユーザーに案内してください。 chrome.exe --remote-debugging-port=9222 (詳細は references/setup-guide.md を参照してください)


ワークフローの概要

[1. Navigate] → [2. Anti-Bot Check] → [3. Deep Extraction] → [4. Synthesize to Template]

重要:スクリーンショットを撮らないでください。スクリーンショットはコンテキストを過剰に消費するうえ、不要です。視覚的なデータはすべて CSS から抽出します。


ステップ 1:移動とボット対策チェック

mcp__chrome-devtools__navigate_page (url: "<target-url>")

ボット対策のチャレンジがないか、すぐに確認してください。

() => {
  const text = document.body.innerText.toLowerCase();
  const title = document.title.toLowerCase();
  if (text.includes('cloudflare') || text.includes('verify you are human') || title.includes('just a moment')) {
    return 'CHALLENGE_DETECTED';
  }
  return 'OK';
}

CHALLENGE_DETECTED の場合:

  1. すべての操作を一時停止します。
  2. ユーザーに次のように伝えます:「ボット保護が検出されました。ブラウザーで CAPTCHA を手動で解決してから、ここで確認してください。」
  3. 続行する前にユーザーの確認を待ちます。

ステップ 2:CSS を詳細に抽出

references/analysis-guide.md の抽出スクリプトを順番どおりに実行します。

順序スクリプト目的最大項目数
1CSS 変数とトークン色、余白、タイポグラフィの変数50 トークン
2アニメーションとキーフレーム@keyframes、アニメーションの使用状況、トランジション10 KF、15 トランジション
3インタラクション状態:hover、:focus、:active のルール15 ルール
4タイポグラフィ主要な要素のフォントスタック7 要素
5レイアウトと余白角丸、間隔、シャドウ各 5 項目
6技術スタックフレームワークの検出-

重要:各スクリプトには上限が組み込まれています。より多くのデータを抽出するために変更しないでください。


ステップ 3:テンプレートに統合

必須:references/design-system-template.md のテンプレート構造と完全に同じ形式で出力を生成します。

テンプレート対応表
抽出データテンプレートのセクション備考
tokens.colorsDesign Token System > Colors表形式にする
tokens.spacingSpacing, Radius & Borders角丸の値を含める
tokens.typographyTypographyフォントスタックを含める
タイポグラフィのスクリプトTypography > Font Stacks, Type Scale計算済みスタイル
keyframesAnimation & Motion > Key Animationsキーフレーム定義の全体
animationUsageAnimation & Motion > Timing継続時間、イージング
transitionsAnimation & Motion > Timing一般的なパターン
interactionsComponent Styling > State Transitionsホバー/フォーカスの効果
レイアウトサンプラーLayout Principles余白のシステム
技術スタックImplementation NotesTailwind/CSS に関する注意事項
出力形式チェックリスト

出力する前に、以下のセクションがすべてあることを確認します。

  • <role> ブロック(テンプレートからそのままコピー)
  • <design-system> ラッパー
  • コア原則、雰囲気、歴史的背景を含む ## Design Philosophy
  • 色の表、タイポグラフィ、余白を含む ## Design Token System
  • ボタン、カード、フォーム入力欄を含む ## Component Styling Principles
  • 余白のシステム、グリッド、レスポンシブを含む ## Layout Principles
  • 必須要素 3 項目を含む ## The "Signature" Factor
  • 原則、タイミング、主要なアニメーションを含む ## Animation & Motion
  • ## Accessibility Constraints
  • 視覚面とインタラクション面の禁止事項を含む ## Anti-Patterns
  • 技術固有のガイダンスを含む ## Implementation Notes
  • 検証項目 4 項目を含む ## Aesthetic Checklist
  • 終端の </design-system>

リソース

コメント