Communitygithub.com

design-md:任意のURLから実測DESIGN.mdを生成

実ブラウザでサイトを開き、配色・書体・余白・ホバー状態・モーション時間・3D・技術スタックを実測した DESIGN.md(Google design.md 形式)を書き出し、コーディングエージェントに同じ見た目のUIを作らせます。

design-md:任意のURLから実測DESIGN.mdを生成 とは?

地元ビジネスのサイト制作レシピ ステップ1(見た目を確定)、Ibad-10/design-md より(2026-10-07 公開、linear.app の完全な作例付き)。URLを渡すと Playwright MCP を操作し、イントロアニメーションの終了を待って extract.js でトークンを取得、上・中・下をスクリーンショット、motion.js と stack.js(フレームワーク、UIキット、GSAP/ScrollTrigger のトゥイーン、シェーダー、Lenis、スライダー)を実行し、CTA・カード・ナビリンクのホバー差分を取り、390px のモバイル表示を確認、内部ページを最大3つ調べてから、YAMLトークンと概要・配色・タイポ・レイアウト・コンポーネント・Do/Don't・レスポンシブ・モーション・3Dとメディア・技術スタック・既知の欠落を書き、@google/design.md でリントします。値はすべて実際のページから取得し、捏造しません。

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

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

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

ドキュメント

URLからのDESIGN.md

入力: URL。オプションの第2引数: 出力パス(デフォルトは./DESIGN.md)。

Playwright MCP(mcp__plugin_playwright_playwright__*)を使用します。最初に1回のToolSearch呼び出しでブラウザツールをロードしてください。

スクリプットの実行

extract.js、motion.js、stack.jsはこのファイルと同じディレクトリにあります。これらを実行するには: ファイルを読み込み、先頭のコメント行を削除し、残りのアロー関数をbrowser_evaluateのfunction引数として渡します。すべてJSONを返します。stack.jsは非同期(スクリプトをフェッチ)ですが、browser_evaluateはこれをサポートしています。

フロー

  1. 開く。 browser_navigateでURLに移動します。browser_resizeで1440x900にリサイズします。クッキーバナーがコンテンツを覆っている場合は、その同意/閉じるボタンをクリックします。キャプチャや「ブロックされました」ページが表示された場合は停止します。ユーザーに伝え、何も書き込まないでください。

  2. 導入アニメーションを待つ。 3秒待ち、スクリーンショットを撮ります。ヒーローが空白、ぼやけている、または半分フェードしているように見える場合は、まだ表示中です: さらに2秒待ってから再度撮影します。モーション&インタラクションのために、表示方法(ブラーイン、フェードアップ、スタッガー)を記録します。アニメーション途中の値は正しくないため、ヒーローが完全に表示されるまで何も実行しないでください。 トークン。 extract.jsを実行します。結果を保持します。

  3. 見る。 デスクトップ幅でスクリーンショットを撮ります:

    • ページの上部
    • 中央: browser_evaluate () => scrollTo(0, document.body.scrollHeight / 2)、800ms待機
    • 下部: 同様にscrollHeightを使用、800ms待機

    スクロールに応じて移動、フェード、表示されるものを記録します。

  4. モーション。 スクロール後にmotion.jsを実行します。これにより、遅延読み込みの3Dキャンバスがすでに存在するようになります。 スタック。 まずページ全体をスクロールします(約900pxずつ、150ms間隔; 1画面サイトの場合はホイールイベントを使用)これにより遅延チャンクが読み込まれ、次にstack.jsを実行します。ページのグローバル、DOM、読み込まれたリソース、CSS、および読み込まれたすべてのスクリプト(インラインと遅延チャンク)のテキストをチェックし、以下を返します:

    • stack: カテゴリ別のライブラリとエビデンス: フレームワーク/プラットフォーム (Next, Nuxt, Astro, SvelteKit, Gatsby, Remix, React, Vue, Angular, Svelte, Framer, Webflow, Wix, Squarespace, Shopify, WordPress, Lovable)、UIキット/アイコン (Tailwind, Radix/shadcn, Headless UI, MUI, Chakra, Mantine, Ant, Bootstrap, Sonner, Lucide, Font Awesome, Phosphor)、3D (Three.js, React Three Fiber, drei, postprocessing, OGL, Babylon, PlayCanvas, A-Frame, regl, twgl, curtains.js, Spline, model-viewer, COBE, Unicorn Studio, Vanta, 生のWebGL)、2D (PixiJS, p5, Paper, Konva, tsParticles, Rive, Lottie)、アニメーション (GSAP + Flip/Draggable/MorphSVG/DrawSVG/MotionPath/CustomEase, Framer Motion, anime.js, React Spring, Velocity, Popmotion, AutoAnimate, Theatre.js)、スクロール (ScrollTrigger, ScrollSmoother, Observer, Lenis, Locomotive, smooth-scrollbar, AOS, ScrollReveal, Rellax, CSSスクロール駆動)、テキスト (SplitText, SplitType, Splitting, Typed, ScrambleText)、スライダー (Swiper, Splide, Embla, Keen, Glide, Flickity, Slick)、ページ遷移 (Barba, Swup, Taxi, Highway, View Transitions)、オーディオ (Howler, Tone)、物理 (Matter, cannon-es, Rapier)。
    • note: WebGLが汎用3Dエンジンなしで実行されている場合に設定されます。つまり、手書きのWebGLです。
    • components: accordion, tabs, dialog, menu, tooltip, carousel, marquee, form, video, iframe, animated SVG, custom cursor, preloader, theme toggleの数。
    • shaders (GLSLソース), scrollTriggers (trigger/start/end/scrub/pin), tweens (GSAP to/from with ease, duration, stagger), motionProps (Framer Motion initial/animate/whileInView), threeObjects (使用されたジオメトリ、マテリアル、ローダー、パス), assets (モデル、HDR、Rive、Spline、Lottie、ビデオ、オーディオ), scripts.failed。

    使用方法:

    • グローバル、DOM、リソースからのエビデンスを最も信頼します。フレームワークランタイムファイル(ReactやNextの内部など)内でのみ見つかった一致は慎重に扱い、スクリーンショットで表示されるものと照合して確認します。
    • シェーダーを読み、平易な言葉で何をするか説明します(ベンド、フレア、フラッター、角丸SDF、ノイズ、パーティクル、グローブ)。エンジン、最大1〜2行の主要なGLSL行、およびスクロール配線を 3D & メディア と スクロール動作 に記載します。シェーダー全体をDESIGN.mdにコピーしないでください。
    • tweensとscrollTriggersを具体的なモーション仕様に変換します(例:「見出しが文字に分割され、blur(7px)から上昇、0.7秒、スタッガー0.017秒、power2.out、上部がビューポートの70%に達したとき」)。
    • scripts.failedが多い場合、クロスオリジンスクリプトがfetchをブロックしています。既知のギャップにリストします。
  5. ホバー状態。 browser_hoverでプライマリCTA、1つのカード、1つのナビリンクにホバーします。各ホバーの後、その要素(targetとして渡す)に対してbrowser_evaluateを実行します: (el) => { const s = getComputedStyle(el); return { bg: s.backgroundColor, color: s.color, border: s.borderColor, shadow: s.boxShadow, transform: s.transform, opacity: s.opacity }; }。extract.jsからの静止値と比較します。各差分が-hoverコンポーネントバリアントになります。

  6. モバイル。 browser_resizeで390x844にリサイズし、上部にスクロールし、3秒待機(イントロアニメーションが再再生)、スクリーンショットを1枚撮ります。ナビゲーションがどのように折りたたまれ、タイプスケールとグリッドがどのように変化するかを記録します。

  7. その他のページ。 メインナビゲーションから、最大3つの内部リンク(できれば価格、製品/機能、ドキュメント/ブログ)を選択します。各リンクに移動し、スクリーンショットを1枚撮り、extract.jsを実行します。これらを使用して、追加のコンポーネント(価格カード、タブ、テーブル、FAQ、フォーム)を見つけます。

  8. 出力ファイルを書く 以下のテンプレートを使用します。

  9. リント。 npx -y @google/design.md lint <path>を実行します。すべてのエラーを修正します。Responsive Behavior、Motion & Interaction、3D & Media、Iteration Guide、またはKnown Gapsに関する警告は予期されたものです(カスタムセクション)。孤立トークンに関する警告は問題ありません。npxが何も表示しない場合(WindowsのGit Bashで発生)、一時フォルダにインストールして直接実行します: npm i --no-save @google/design.md、その後node node_modules/@google/design.md/dist/index.js lint <path>。Nodeまたはネットワークがない場合は、一度だけその旨を伝え、この手順をスキップします。

  10. 終了。 browser_close。ユーザーにファイルパス、見つけた3〜5個の特徴的な特性、および既知のギャップを伝えます。

特殊なサイト

  • 1画面サイト(document.body.scrollHeightがビューポートの高さに等しい): スクロールはページが担当します。マウスを中央に移動し、scrollToの代わりにホイールイベント(page.mouse.wheel)を使用し、数回のホイール操作ごとにスクリーンショットを撮ります。
  • キャンバスがページを覆っているためにホバーが失敗する: マウスの位置でホバーし、CANVASをスキップしてdocument.elementsFromPoint(x, y)でカーソル下の要素を読み取ります。計算されたスタイルが変わらない場合、効果はWebGLまたはJSで描画されています。既知のギャップに記録します。
  • 明るい背景上の白いUIテキスト: mix-blend-mode: differenceを示します。getComputedStyle(el).mixBlendModeを確認し、画面上で見える色(255 − 背景色)とブレンドモードを記録します。
  • プリローダー: 最初のスクリーンショットにロゴまたは名前のみが表示される場合、それをコンポーネントとして記録し、さらに長く(モバイル含めて8秒以上)待機します。
  • オンボーディングモーダルまたはオブジェクトベースのナビゲーション(部屋、テレビ、デスクトップ): モーダルをコンポーネントとしてキャプチャし、それをステップ実行し、少なくとも1つの「部屋」を開いてサブテーマとして抽出します。
  • テーマトグル: page.emulateMedia({ colorScheme: 'dark' })でダークテーマを表示します。prefers-color-schemeまたは[data-theme] CSS変数を読み取ります。トグルボタンがタイムアウトする場合は、[aria-label="..."]で{ force: true }を指定してクリックするか、スタイルシートから直接[data-theme="light"]ルールを読み取ります。
  • ボタンテキストの重複文字(「GGeett iinn」): 文字ごとのテキストロールホバー効果を示します。ホバー&フォーカス状態の下に記録します。
  • テンプレートの残骸(例: 未使用のshadcn変数--primary: 229 84% 39%): スクリーンショットで表示されないCSS変数は無視します。

browser_evaluate呼び出しがスローされた場合、2秒待ってから1回再試行します。再度失敗した場合、そのデータなしで続行し、既知のギャップに記録します。

記述ルール

  • すべての16進数、サイズ、太さ、半径、影、期間、イージングは抽出されたデータから取得します。値を発明しないでください。値が欠落している場合は、それを省略し、既知のギャップにリストします。
  • ほぼ重複する値はクリーンなスケールにまとめます。例: スペーシング7px 8px 9pxは8pxになります。アクセントカラーでない限り、3回未満使用された色は無視します。
  • カラートークンにはセマンティック名を使用します: primary、on-primary、primary-hover、ink、ink-muted、ink-subtle、canvas、surface-1..n、hairline、semantic-success|warning|error。反転した明/暗セクションにはinverse-*を使用します。
  • タイポグラフィトークン: display-xl/lg/md、headline、subhead、body-lg、body、body-sm、caption、button、eyebrow、mono。ピクセルの行の高さを単位なしの比率に変換します(64px on 64pxは1.0になります)。
  • components:では、"{colors.primary}"や"{typography.button}"のようなトークン参照を使用します。各状態を独自のキーに配置します(button-primary、button-primary-hover)。許可されるプロパティ: backgroundColor、textColor、typography、rounded、padding、size、height、width。
  • 透明色(抽出出力の#ffffff @0.08): コンポーネントのbackgroundColorについては、キャンバスカラーにアルファ×(色 − キャンバス)でチャンネルを追加し、不透明な16進数(channel = canvas + alpha × (color − canvas))に平坦化します。そうしないと、リンターのコントラストチェックが誤検出します。境界線は、8桁の16進数(#ffffff14)のままで透明でもかまいません。
  • 散文では、トークンを`{colors.primary}`(#5e6ad2)のように引用し、読者が名前と値の両方を確認できるようにします。
  • ベースの概要、Do's and Don'ts、モーションの説明は、スクリーンショットで表示される内容に基づきます。具体的に記述し(「影の代わりにヘアライン境界線」)、一般的な表現(「クリーンでモダン」)は避けます。
  • 3D: シーンが何か、どこにあるか、サイズ、エンジン(librariesから)、およびどのように反応するか(スクロール、カーソル、アイドルループ)を説明します。モデルやシェーダーをダウンロードしようとしないでください。
  • モーション値(期間、イージング、キーフレーム)は散文のみに記述します。仕様にはmotion:トークングループはありません。

テンプレート

examples/linear.app-DESIGN.mdは、完成したリントクリーンな出力です。期待される詳細レベルを確認するために一度読んでください。

---
version: alpha
name: <サイト>-設計分析
description: "<1つの密な段落: キャンバスカラー、インク、単一アクセント、表示タイプとトラッキング、カード処理、特徴的なモチーフ。16進数値をインラインで含めます。>"

colors:
  primary: "#..."
  on-primary: "#..."
  primary-hover: "#..."
  ink: "#..."
  ink-muted: "#..."
  canvas: "#..."
  surface-1: "#..."
  hairline: "#..."

typography:
  display-xl:
    fontFamily: <フォント>
    fontSize: 64px
    fontWeight: 510
    lineHeight: 1.0
    letterSpacing: -1.4px
  body:
    fontFamily: <フォント>
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
  button:
    fontFamily: <フォント>
    fontSize: 14px
    fontWeight: 510
    lineHeight: 1.0

rounded:
  sm: 4px
  md: 8px
  lg: 12px
  pill: 9999px

spacing:
  xxs: 4px
  xs: 8px
  sm: 12px
  md: 16px
  lg: 24px
  xl: 32px
  section: 96px

components:
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.button}"
    rounded: "{rounded.md}"
    padding: 8px 14px
  button-primary-hover:
    backgroundColor: "{colors.primary-hover}"
  feature-card:
    backgroundColor: "{colors.surface-1}"
    textColor: "{colors.ink}"
    rounded: "{rounded.lg}"
    padding: 24px
  top-nav:
    backgroundColor: "{colors.canvas}"
    textColor: "{colors.ink}"
    height: 64px
---

## 概要

<2〜4段落: ムード、密度、個性、ページリズム、何がそれを認識可能にするか。>

**主な特徴:**
- ...

## 色

> ソースページ: <訪問したページのリスト>

### ブランド & アクセント
- **<説明的な名前>** ({colors.primary}): <役割>
### サーフェス
### テキスト
### セマンティック

## タイポグラフィ

### フォントファミリー
### 階層
| トークン | サイズ | 太さ | 行の高さ | トラッキング | 使用法 |
|-------|------|--------|-------------|----------|-----|
### 原則
### フォント代替に関する注意
<フォントがプロプライエタリな場合のオープンソースの代替。>

## レイアウト

### スペーシングシステム
### グリッド & コンテナ
<最大幅、列数、ガター。>
### ホワイトスペースの哲学

## エレベーション & 奥行き

| レベル | 処理 | 使用法 |
|-------|-----------|-----|
<extract.jsからの影、またはそれらなしで階層を実現する方法(サーフェスラダー、ヘアライン)。>
### 装飾的な奥行き

## シェイプ

### 角丸スケール
### 写真 & イラストレーションのジオメトリ

## コンポーネント

### ボタン
**`button-primary`**: <トークン参照を使用した説明、およびそのホバー状態>
### カード & コンテナ
### 入力 & フォーム
### ナビゲーション
### フッター
### <その他のサイト固有コンポーネント>

## してはいけないこと

### する
- ...
### しない
- ...

## レスポンシブ動作

### ブレークポイント
| 名前 | 幅 | 主な変更点 |
|------|-------|-------------|
### タッチターゲット
### 折りたたみ戦略
### 画像の動作

## モーション & インタラクション

### タイミング & イージング
| 使用法 | プロパティ | 期間 | イージング |
|-----|----------|----------|--------|
<motion.jsのトランジションから、使用頻度順にランク付け。>
### ホバー & フォーカス状態
<ホバー差分から: 何がどのくらいの速さで変化するか。>
### スクロール動作
<スムーズスクロール、スナップ、スティッキー要素、スクリーンショットで見られたスクロールリビール、ライブラリ(Lenis、GSAP ScrollTrigger、AOS)。>
### 環境アニメーション
<ループするキーフレーム: 名前、アニメーション化するもの、期間。>
### モーション軽減
<サイトに`prefers-reduced-motion`ルールはありますか?推奨されるフォールバック。>

## 3D & メディア

<ない場合: 「3Dやビデオはありません。奥行きは<X>から得られます。」そうでない場合、シーンまたはビデオごとに1エントリ:>
- **<シーン名>**: <エンジン>, <位置とサイズ>, <表示内容>, <反応方法>。<エンジン/アプローチ>で再構築。静的フォールバック: <ポスター画像/グラデーション>。

## 技術スタック

| レイヤー | 使用 | エビデンス |
|-------|------|----------|
<stack.jsのカテゴリでヒットがあったものごとに1行: フレームワーク/プラットフォーム、UIキット、3D、2D、アニメーション、スクロール、テキスト、スライダー、ページ遷移、オーディオ。エビデンス = グローバル、DOMマーカー、またはファイル。>

**特徴的な効果の構築方法:**
- **<効果名>**: <ライブラリ+テクニックを1〜3文で、正確な設定値(イーズ、期間、スタッガー、スクラブ)と主要なシェーダーアイデアがあればそれも含めます。>

**再構築レシピ:** <外観を再現するための最小限のライブラリセット、例:「Next.js + Tailwind + GSAP (ScrollTrigger,

…

[翻訳のため切り詰め]

関連スキル