Communitygithub.com

figma-library-binding

Figma 画面をデザインシステムライブラリにバインドします。トークンは完全一致のみ、アイコンとコンポーネントはライブラリ版に置き換え、一致しない値は設計者に報告します。

figma-library-binding とは?

このスキルは、Figma で作成されたプロダクト画面をプロジェクトのデザインシステムライブラリにバインドするためのものです。カラー、角丸、ストローク、スペーシング、タイプサイズなどのトークンは、値が完全に一致する場合のみバインドし、最も近い値にスナップすることはありません。アイコンやコンポーネントは、ライブラリ側に同名のコンポーネントがあればそれに置き換えます。一致するトークンがない値は「未バインド」としてリストアップし、設計者が判断できるようにします。バインド処理は、プリセットを使用して自動化することも、手動で`al-bind.js`スクリプトを実行することもできます。このスキルは、Claude Code や Cursor などの AI エージェントで使用することを想定しており、`get_libraries`によるライブラリ確認、`search_design_system`によるコンポーネント検索、そして`__alBuild`による画面ビルドとバインド結果の取得を含む一連のワークフローを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byby325/code-to-figma-ui-states/tree/HEAD/skills/figma-library-binding

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

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

ドキュメント

デザインシステムライブラリへのバインド

プロダクト画面は、ローカルレイヤーだけでなく、プロジェクトのデザインシステムを使用しなければなりません。

プリセットの選択

各デザインシステムには、presets/ に1つのプリセットがあります。ユーザーにどのプリセットを使用するか尋ねるか、プロジェクトの依存関係を確認してください(例:プロジェクトがデザイントークンパッケージに依存している場合は、対応するプリセットを使用します)。フォーマットは presets/README.md を参照してください。プリセットがない場合は、以下の「自動バインドの仕組み」に従って一度だけ検索し、結果を新しいプリセットとして保存します。プロジェクトにライブラリがない場合は、「None」と書き、レポートにその旨を記載します。

開始する前に、get_libraries を使用して、すべてのライブラリが libraries_added_to_file に含まれていることを確認してください。不足しているものがある場合は、ユーザーに Figma の Assets › Libraries から追加するよう依頼し、追加されるまで続行しないでください。

バインドルール

画面を変更するよりも、何かをバインドしないままにしておく方が良いです。ツールは以下のことだけを行い、それ以外はローカルのままにしてレポートします。

タイプルールやってはいけないこと
カラー不透明度も含めて完全一致の場合のみバインドします。半透明の色は、その透明度を持つトークンが必要です。Figma はバインド時に不透明度を1にリセットするためです最も近い色にスナップしない
角丸、ストローク、スペーシング、タイプサイズ値が完全に等しい場合のみバインドします3px を 2px や 4px に変更しない
エイリアストークン別のトークンを指すトークン(プリミティブ上のセマンティックトークン)は、チェーンの最後の値としてカウントされます。値に両方がある場合、自身の値を持つトークンが優先されます。エイリアスは、他のトークンが持っていない値にのみ使用されます同じ値を持つ2つのセマンティックトークンを推測で選択せず、報告する
テキストスタイルフォント、サイズ、行の高さがすべて等しい場合のみバインドしますフォントが異なる場合、サイズのみバインドする
アイコンライブラリに同じ名前のコンポーネントがある場合のみ置き換えます。同じ目的を持つことが確認されたマッピングについてのみ、古い名前を受け入れます意味は似ているが外観が異なるアイコンを使用しない
コンポーネントライブラリのコンポーネントがプロダクトのものと同じに見える場合のみ置き換えます。プロダクトのサイズは維持します見た目が異なる場合は、ローカルコンポーネントを維持し、プロダクト画面を変更しない

なぜ最も近い値にスナップしないのか:一致する値は一致する意味を意味するわけではなく、ステートボードとコードが一致しなくなります。一致するトークンがない値はデザインシステムのギャップです。ツールに選ばせるのではなく、設計者が決定できるようにリストアップします。

自動バインドの仕組み

プリセットを使用する場合、al-capture.cjs の設定で preset を設定し、al-pack.py の4番目の引数としてプリセット名を渡します。画面はビルド時に自動的にバインドされます。プリセットがない場合のみ、以下のプロセスに従い、結果を presets/<name>.json として保存します。libs はバインド設定、extract は抽出中に使用されるスプライトマッピングです。

  1. レイアウトツリーを抽出した後、JSON 内のすべての lib(アイコン名)をリストアップします
  2. 各名前について、search_design_system でアイコンシステムを検索します。system:cross は icon / system / cross にマッピングされます。完全な名前の一致のみを受け入れます
  3. search_design_system を使用してコンポーネントセットを見つけ、いくつかのインスタンスを配置し、スクリーンショットを撮り、プロダクトの見た目と比較して buttons.rules を決定します
  4. opts.libs を組み立てます。最初に3~4個のカードをビルドし、log.drift とスクリーンショットを確認します。正しく見える場合のみバッチ処理します
const libs = {
  tokens: ['My DS - Foundation'],        // これらのライブラリから変数を読み取る
  icons: { 'system:cross': '<componentKey>' },
  buttons: {
    set: '<componentSetKey>',
    rules: { FFE13A: { Type: 'primary', Size: 'medium', Compact: 'false', Status: 'default' } }, // キーはボタンの背景色
  },
  words: { value: 'Price' },             // テキストプロパティをチームの用語に合わせて名前変更する
};

al-capture.cjs の出力には unmappedIcons が含まれ、今回使用されたがプリセットがまだマッピングしていないアイコンがリストされます。search_design_system でそれらを検索し、完全な名前の一致をプリセットに追加します。次回は自動的にバインドされるため、プリセットは使用とともにより完全になります。

__alBuild が返す stat にはバインド結果が含まれます:boundColors、boundLayout、libIcons、dsButtons、unboundColors、localIcons。

既存画面のバインド

al-bind.js は単独で使用できます。トークンのみをバインドし、アイコンやコンポーネントは置き換えません。スクリプト全体を use_figma に貼り付けるか(eval で読み込む)、次のように呼び出します:

return await __alBind(['<frame id>'], { tokens: ['<library name>'] });

これは boundColors、boundLayout、unboundColors(トークンのない色)を返します。skippedText は、フォントを読み込めなかったテキストの数をカウントするため、そのサイズはバインドされないままになります。

__alBuild で画面がビルドされると、トークンテーブルは _registry にキャッシュされるため、以降の画面で毎回変数をインポートする必要はありません。プリセットが異なるトークンライブラリをリストしている場合、再構築されます。ライブラリが新しいトークンや変更されたトークンを公開した後は、次の __alBuild 呼び出しに refreshTokens: true を渡します。

コンポーネント

  • Auto Layout で中央揃え:パディングやテキストボックスの幅ではなく、テキストを変更しても位置がずれないようにする
  • コンテナはコンポーネントではない:既にコンポーネントを含む繰り返し構造は、単なるコンテナです
  • ステートはバリアント:選択済みと無効は、インスタンスの色を上書きするのではなく、プロパティで切り替え可能でなければなりません
  • 小さなコンポーネントをプロパティに分割:2つのバリアントプロパティ Type と State。テキストはコンポーネントプロパティにします
  • メインコンポーネントは完全である必要がある:ビューポートで切り取られた要素をコンポーネントにしない

レポート

常に以下をリストアップします:

  • バインド比率:色、レイアウト値
  • ライブラリバージョンに置き換えられたアイコンとコンポーネントの数
  • トークンのない色(上位いくつか)、設計者が決定できるようにするため
  • ローカルのままにされたアイコンとコンポーネント、およびその理由

Individual skills in this repo

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

code-to-figma

Rebuild screens from a running web app as native, editable Figma layers (Auto Layout, components, instances) and diff them against browser screenshots — not a screenshot import or a Code layer. Use when the user asks to "turn this page into Figma", "code to Figma", "push this screen to Figma" or "rebuild the UI in Figma". 把 Web 專案實際跑出來的畫面重建成 Figma 原生圖層:造狀態、抽 DOM 版面樹,建 Auto Layout 和 component/instance,再跟瀏覽器截圖比對。單一畫面或一批畫面都能用,不需要做情境稿。Use when 使用者要「code to figma」「把這頁轉成 Figma」「從程式重建畫面」「push 畫面到 Figma」,或 figma-state-board 走路線 B。產出是可編輯圖層,不是 Code layer 或截圖。

figma-state-board

Inventory every UI state of a feature from its code and lay them out on one Figma canvas (a state board) — real screens for states the prototype already handles, plus a gap check of missing error, empty and loading states, split into spec-required and suggested. Use when the user asks for a "state board", "all states of this feature in Figma", "which error screens are missing", or to update an existing board. 從任何產品專案的程式碼盤點一個功能的所有狀態,在 Figma 產出或更新「情境稿」:原型(通常是 mock data 做的)已經有的狀態畫真實畫面,原型缺的狀態全列進「缺漏檢查」,再分「規格有寫」(規格要求、原型漏做)和「建議補」(規格和原型都沒提的錯誤、空狀態、載入等)。Use when 使用者要「做情境稿」「把所有狀態/狀況畫到 Figma」「state board」「檢查缺了哪些 error 畫面」,或要依新規則增修既有情境稿。只要狀態清單用 state-discovery,只要把畫面轉進 Figma 用 code-to-figma。

関連スキル