コンテンツへスキップ

Figma Generate Library スキル

コードから Figma にデザインシステムを構築する Figma のスキル。変数、ライト・ダークモード、スタイル、バリアント付きコンポーネントを作ります。

公式 · Figma
作者Figma
ライセンスNo licence file; Figma Developer Terms apply
ソースfigma/mcp-server-guide · GitHub 上の SKILL.md
プロジェクトサイトdevelopers.figma.com/docs/figma-mcp-server
対応環境Claude Code · Codex、Gemini CLI、Cursor、Copilot
ソースを確認した日

figma-generate-library スキルは、コードベースをもとに Figma 上のデザインシステムを構築・更新するための Figma 公式のエージェントスキルです。CSS 変数、テーマファイル、コンポーネントを読み取り、対応する Figma の変数(ライトモードとダークモード付き)、テキストスタイルとエフェクトスタイル、適切なバリアントセットを持つコンポーネントを作成します。各プロパティはハードコードした値ではなく変数にバインドされます。

このスキルが決めるのは何をどの順番で作るかで、各キャンバススクリプトの書き方は相棒の figma-use スキルが決めます。そのため 2 つは常に一緒に読み込まれます。リモート Figma MCP サーバーを通じて動き、Figma アカウントと編集できるファイルが必要です。トークンセット、コンポーネント 1 つ、ライブラリ全体、コードと Figma の間でずれた部分の突き合わせなど、依頼に合わせて規模を変えます。

スキルの SKILL.md より: Build professional-grade design-system assets in Figma that match code.

これは Figma による公式スキルです。ほかのスキルと同様、エージェントに指示を与え、実行されるスクリプトを含む場合があります。ほかの場所のコピーではなく、ここでリンクしているソースからインストールしてください。

できること

  1. ファイルに手を付ける前に範囲を 1 つ決め(トークンのみ、単一のコンポーネントまたはファミリー、ライブラリ全体、コードから Figma への突き合わせ)、何を納品しどう確認するかの短いチェックリストを示します。
  2. まず調べます。関連するコードを分析し、ファイルの既存のページ、変数、スタイルを確認し、ファイルで使えるライブラリを一覧にして検索します。コードと Figma で値が食い違うときはあなたに確認します。
  3. 変数コレクションとモード(たとえば Primitives と、Light・Dark を持つ Color コレクション)、プリミティブを参照するエイリアスのセマンティック変数、すべての変数のスコープ、コードを指し示す CSS var() のコード構文を作成します。
  4. 依存関係の順にコンポーネントを構築し、バリアントセット、コンポーネントプロパティ、変数のバインドを設定します。アイコンはアイコンごとにバリアントを作らずインスタンスの入れ替えを使い、30 を超えるバリアントの組み合わせは分割します。
  5. ライブラリ全体の場合は、カバー、スタートガイド、基礎(ファウンデーション)、コンポーネントの各ページを追加し、続いて Code Connect のマッピングと、アクセシビリティ・命名・バインドの最終監査を行います。
  6. 作成したすべての ID を JSON ファイルの状態台帳に記録するので、長い構築作業も新しいチャットで再開できます。キャンバススクリプトを 2 つ同時に実行することはありません。

得られるもの

  • Figma ファイル内の変数、モード、テキストスタイル、エフェクトスタイル、コンポーネント、コンポーネントセット。範囲に含まれる場合はドキュメントページも作られます。
  • 作成したものを記録した、パソコン上の状態ファイル(/tmp/design-system-state-<run id>.json)。構築の再開に使われます。

使う場面

  • デザイントークンとコンポーネントがコードにあり、Figma のライブラリがない、不完全、または古いとき。
  • 新しいコンポーネントを 1 つ、手で描くのではなく、バリアントと変数のバインドを備えた形で Figma にきちんと作りたいとき。
  • CSS に合わせたライトテーマとダークテーマを、Figma の変数モードとして設定したいとき。
  • コードと Figma がずれてしまい、変わったトークンとコンポーネントだけをその場で更新したいとき。

向かない場面

  • 既存のライブラリで画面やページを作りたい場合:それは figma-generate-design の役目です。
  • Figma のデザインからコードがほしい場合:代わりに figma-design-to-code を使ってください。
  • 元になるコードやトークンがなく、ブランドを新しく考えてほしい場合:スキルはコードが定義するものを作り、推測せずに質問します。
  • 共有ファイルで閲覧シートかコラボシートしかない場合:下書き以外への書き込みにはフルシートが必要です。

必要なもの

  • Figma アカウントと編集できるファイル。Figma のドキュメントによると、下書き以外への書き込みにはフルシートが必要で、キャンバスへの書き込みはベータ期間中は無料、今後は従量制の有料機能になる予定です。
  • エージェントに接続し、Figma にサインインした状態のリモート Figma MCP サーバー(https://mcp.figma.com/mcp)。
  • Figma の figma-use スキル。このスキルはすべてのキャンバススクリプトでそれを必要とします。Figma のプラグインで両方がインストールされます。
  • 信頼できる情報源としてのコードベース(またはトークンファイル)。読み取りツールは Figma の回数制限の対象です(Starter プラン、または閲覧シート・コラボシートでは月 20 回まで)。書き込みツールは対象外です。
  • ライブラリ全体を作る場合は時間。チェックポイント付きのフェーズに分けて進み、新しいチャットで再開するための続行用プロンプトをスキルが用意します。

スキルに含まれるファイル

ファイル・フォルダー用途
SKILL.md範囲の取り決め、範囲ごとのワークフロー、15 のデザインシステムのルール、状態台帳、ライブラリ再利用の判断表、あなたに確認するタイミング。
references/discovery-phase.md何かを変更する前に、コードと Figma ファイルを分析する方法。
references/token-creation.mdコレクション、モード、エイリアス、スコープ、コード構文。より大規模なマルチブランドのパターンも含みます。
references/component-creation.mdプロパティとバインドを備えたコンポーネントとバリアントセットの構築。
references/documentation-creation.mdカバー、スタートガイド、基礎(ファウンデーション)の各ページ。
references/code-connect-setup.mdFigma のコンポーネントとコードのコンポーネントの対応付けと、変数のコード構文の設定。
references/naming-conventions.mdファイルにまだ命名規則がない場合の、変数、ページ、バリアント、スタイルの名前の付け方。
references/error-recovery.mdスクリプトが失敗したときの対処と、中断した作業を安全に片付ける方法。
scripts/*.jsキャンバス呼び出しに埋め込む 8 つのヘルパースクリプト:ファイルの調査、コレクションとセマンティックトークンの作成、バリアントセットの構築、変数のバインド、ドキュメントページの作成、検証、一覧にある孤立ノードだけの削除。

2026-11-15 時点でリポジトリに記載されていたライセンス:No licence file; Figma Developer Terms apply。

プロンプト例

インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。

  • figma-generate-library を使って、src/styles/tokens.css からこのファイルに Figma の変数を作成してください:<file URL>。Primitives と、Light・Dark モードを持つ Color コレクションでお願いします。
  • components/Button.tsx をもとに、Button コンポーネントを Figma に作ってください。Size、Variant、State のバリアントを付け、こちらの変数にバインドしてください。
  • Tailwind のテーマとこの Figma ライブラリの変数を比較して、変わった部分だけ更新してください。
  • このリポジトリから、新しい Figma ファイルにデザインシステム一式を作ってください。基礎、Button、Input、Card、Badge、スタートガイドのページを含めてください。

figma-generate-library のインストール方法

Figma MCP サーバーを接続し、figma-use もインストールする

Claude Code で最も簡単なのは、Anthropic の公式マーケットプレイスにある Figma のプラグインを使う方法です。MCP サーバーと、このスキルが必要とする figma-use を含む Figma のすべてのスキルが追加されます。インストール後、Claude Code で /mcp を実行し、ブラウザで Figma にサインインします。

フォルダーを手動でコピーしても構いません。その場合は figma-use も隣にコピーし(下のコマンドで両方コピーされます)、MCP サーバーは 2 つ目のコマンドで追加します。

claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcp

Cursor、Gemini CLI、VS Code の場合

Figma のガイドでは、Cursor ではエージェントチャットで /add-plugin figma を使って同じプラグインをインストールし、Gemini CLI では拡張機能としてインストールします(その後 /mcp auth figma)。VS Code では同じ URL で HTTP MCP サーバーを追加し、Copilot のエージェントモードを使います。

/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guide

claude.ai や API での手順がない理由

すべてのステップで use_figma、get_libraries、search_design_system などのリアルタイムの Figma MCP ツールを呼び出します。Claude API のスキル用サンドボックスはネットワークに接続できず、claude.ai での設定も確認できていないため、エージェントでの設定だけを紹介しています。

スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:

Claude Code:プラグインマーケットプレイスから

  1. ターミナルで claude を実行して Claude Code を起動します。
  2. このプラグインは Anthropic の公式マーケットプレイスにあります。公式マーケットプレイスは Claude Code の初回起動時に自動で追加されます。
  3. プラグインをインストールします。Claude Code はまず詳細を表示するので、追加されるもの(スキル、フック、MCP サーバー)を確認し、自分用、このリポジトリの全員用、このリポジトリでの自分用のどれにするかを選びます。
    /plugin install figma@claude-plugins-official
  4. / を入力して /figma:figma-generate-library を探すか、そのまま作業を依頼します。

セッション内ではなくシェルから行う場合:

claude plugin install figma@claude-plugins-official

プラグインは丸ごとインストールされるため、figma-3d-transforms, figma-code-connect, figma-code-workflows, figma-create-new-file, figma-design-to-code, figma-generate-design, figma-generate-diagram, figma-generative-plugins, figma-implement-motion, figma-shaders, figma-spec, figma-swiftui, figma-use, figma-use-figjam, figma-use-motion, figma-use-slides などほかのスキルも一緒に入ります。

Claude Code:スキルフォルダーにフォルダーをコピー

このパソコン上のすべてのプロジェクトで使うならスキルのフォルダーを ~/.claude/skills/ に、作業者全員で共有するならリポジトリ内の .claude/skills/ に置きます(コミットしてください)。

git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p ~/.claude/skills
cp -R mcp-server-guide/skills/figma-generate-library ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/

Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /figma-generate-library と入力するか、作業内容をそのまま伝えます。

Windows では Git Bash または WSL でコマンドを実行するか、エクスプローラーで同じ場所にフォルダーをコピーしてください。

Codex、Gemini CLI、Cursor、GitHub Copilot

これらのエージェントも同じ SKILL.md フォルダーを読みます。4 つすべてがプロジェクト内で読むフォルダーは .agents/skills/ なので、次のコマンドでスキルをそこにコピーします:

git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p .agents/skills
cp -R mcp-server-guide/skills/figma-generate-library .agents/skills/
cp -R mcp-server-guide/skills/figma-use .agents/skills/
エージェントプロジェクトのフォルダーユーザーのフォルダーメモ
OpenAI Codex
.agents/skills/
~/.agents/skills/
$ と入力するか /skills を実行してスキルを選びます。タスクが当てはまれば Codex が自動で選ぶこともあります。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
または gemini skills install <git URL> --path <folder> --consent で Git からインストールします。Google は 2026 年 6 月 18 日、無料枠と Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えました。Antigravity はプロジェクトでは .agents/skills/、ユーザー用には ~/.gemini/config/skills/ を使います。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent チャットで / を入力してスキルを選びます。Cursor は Claude Code の .claude/skills/ フォルダーも読みます。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI、クラウドエージェント、VS Code・Visual Studio・JetBrains のエージェントモードで動きます(IDE の対応はバージョンによります)。または gh skill install OWNER/REPOSITORY SKILL を実行します(パブリックプレビュー、GitHub CLI 2.90.0 以降)。
信頼できるスキルだけをインストールする. Anthropic は、信頼できる入手元のスキルだけを使い、それ以外のスキルは使う前にすべてのファイルを読むよう勧めています。スキルは、説明に書かれていない方法でエージェントにコマンドの実行、ファイルの読み取り、データの送信を指示できるからです。

これらの手順の出典

2026-11-14 に各ベンダーのドキュメントと照合しました:

まず範囲を決め、そこで止める

このスキルは作業範囲が膨らまないように書かれています。コンポーネント 1 つの依頼がライブラリ全体に広がることはありません。そのコンポーネントに必要な不足トークンだけを作り、検証し、依頼された状態を 1 つのコンパクトなフレームにインスタンスとして並べて、そこで止まります。トークンだけの依頼でコンポーネントが作られることもありません。

範囲ごとに完了の定義(バリアントの網羅、変数のスコープとエイリアス、コード構文、バインド、目視チェック)があり、追加のドキュメントや監査は着手せずにフォローアップとして報告されます。

ライブラリをきれいに保つルール

すべての変数に明示的なスコープ(背景、テキスト、枠線、間隔、角丸)を設定し、あらゆるプロパティの選択肢に表示されないようにします。Web 用のコード構文は、実際の CSS 変数名を使った var() 形式です。セマンティックカラーは生の値を繰り返さず、プリミティブを参照します。

後片付けでは、台帳にある ID と完全に一致するノードだけを削除し、名前から推測して削除することはないので、あなた自身のレイヤーが消えることはありません。

figma-generate-library に関するよくある質問

figma-generate-library と figma-generate-design の違いは?

figma-generate-library はデザインシステムの再利用可能な部品(変数、スタイル、コンポーネント、バリアントセット)を作ります。figma-generate-design はそれらの部品で画面やページを組み立てます。両方が必要なタスクでは両方を読み込むよう、Figma の figma-use スキルに書かれています。

ライトモードとダークモードの変数を作れますか?

はい。標準のトークンのパターンは、モードが 1 つの Primitives コレクション、プリミティブを参照する Light・Dark モードを持つ Color コレクション、そして別々の Spacing と Typography のコレクションです。大規模なシステムでは、ブランドやコントラストのバリエーションなど、さらに多くのモードを使えます。

ライブラリに既にあるコンポーネントを作り直しますか?

いいえ、まず検索します。プロパティ、トークンモデル、命名が合えばライブラリのコンポーネントを再利用し、見た目は合っていてもプロパティが合わなければラップします。作り直すのは、API やトークンモデルに互換性がないときか、ライブラリを編集できないときだけです。判断がはっきりしないときはあなたに確認します。

figma-use は必要ですか?

はい。スキルには、use_figma を呼び出すたびに figma-use を読み込む必要があると書かれています。figma-generate-library は何をどの順番で作るかを知っており、figma-use は Plugin API のルールを知っています。Figma のプラグインをインストールすれば両方が入ります。

figma-generate-library スキルは無料ですか?

スキルのファイルは無料でインストールできますが、オープンソースではありません。リポジトリにはライセンスファイルがなく、Figma の Developer Terms が適用されます。Figma アカウントが必要で、下書き以外への書き込みにはフルシートが必要です。Figma によると、キャンバスへの書き込みはベータ期間中は無料で、今後は従量制の有料機能になる予定です。

長い構築作業が中断したらどうなりますか?

スキルは作成したすべての ID を状態台帳として JSON ファイルに書き込み、実行 ID 付きの続行用プロンプトを示します。新しいチャットではそのファイルを読み直し、Figma ファイルを名前でスキャンして、既存のものを重複させずに中断した箇所から再開します。

ほかの AI スキル

関連スキル

スキルのカテゴリー