Figma Use スキル(use_figma)
Figma へのあらゆる書き込みを支える基本スキル。エージェントが use_figma でファイル内の Plugin API スクリプトを実行するときに従うルールです。
公式 · 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-use スキルは、Figma の use_figma MCP ツールのための Figma 公式の基盤スキルです。use_figma を使うと、AI エージェントがファイル内で Figma Plugin API に対して JavaScript を実行し、フレーム、テキスト、オートレイアウト、コンポーネント、変数、スタイルを作成・編集したり、ファイルの構造を調べたりできます。Figma はこれを必須の前提条件としており、エージェントは use_figma を呼び出す前に必ずこのスキルを読み込みます。
これはワークフローではなくルールブックです。キャンバススクリプトが失敗する原因になるミス(フォントの未読み込み、0〜255 の範囲の色、誤った方法でのページ切り替え、ノード ID を返し忘れること)とその避け方を挙げ、その上に乗るタスク用スキルを案内します:画面には figma-generate-design、デザインシステムのアセットには figma-generate-library、アニメーションには figma-use-motion。リモート Figma MCP サーバーと Figma アカウントが必要です。
スキルの SKILL.md より: Use the `use_figma` tool to execute JavaScript in Figma files via the Plugin API.
できること
- すべての use_figma スクリプトの基本ルールを定めます:トップレベル await を使える素の JavaScript で書き、結果は return で返し(console.log は見えません)、後の呼び出しで見つけられるよう、作成・変更したすべてのノード ID を返します。
- よくある失敗を防ぎます:テキストを編集する前にフォントを読み込む、色は 0〜1 の値で指定する、塗りと線は新しい配列として代入し直す、オートレイアウトのサイズ設定はノードを親に追加した後に行う、新しいトップレベルのフレームは原点から離して置く。
- ページの扱い方(ページの切り替えはスクリプトごとに 1 回まで、複数ページの作業は並列の呼び出しに分ける)と、Figma Design、FigJam、Slides の各ファイルの違いを説明します。
- どの関連スキルを読み込むかをエージェントに伝えます:見た目が変わるデザイン変更には figma-generate-design、再利用可能なコンポーネントとトークンには figma-generate-library、パースペクティブや傾きには 3D 変形のスキル。
- デザインシステムの作業(コンポーネント、変数、テキストスタイル、エフェクトスタイル)を専用のリファレンスで扱い、まず ID と件数を返すことで大きな読み取りを小さく抑えます。
- エラーからの復旧を定めます:失敗したスクリプトを安全に再試行できるか、それともまずキャンバスを読んで何が変わったかを確認すべきか。
得られるもの
- このスキル単体では何も作りません。エージェントが use_figma スクリプトを書く方法を形作るものです。成果は、タスクで依頼された内容が Figma ファイルに作成・編集されたものです。
使う場面
- Figma MCP サーバーを通じて Figma ファイルに書き込むあらゆるエージェントのタスク:use_figma の前に自動で読み込まれます。
- デザイナーには面倒なプログラムによる編集:レイヤー名の一括変更、色の変数へのバインド、オートレイアウトの修正、ファイル構造の監査。
- 自分で Figma のスキルを書いていて、公式スキルが土台にしている基本ルールを知りたいとき。
向かない場面
- 画面全体やデザインシステムのライブラリを作る場合:figma-generate-design または figma-generate-library を使ってください。どちらも自分で figma-use を読み込みます。
- Figma のデザインをコードにする場合:ファイルを読むだけの作業で、figma-design-to-code の役目です。
- Figma のデスクトップ MCP サーバーしか使っていない場合:キャンバスに書き込めないため、そこでは use_figma を使えません。
必要なもの
- 接続済みでサインインした状態のリモート Figma MCP サーバー(https://mcp.figma.com/mcp)。Figma のドキュメントによると、キャンバスへの書き込みはリモートサーバーでしか動きません。
- ファイルの編集権限を持つ Figma アカウント。下書き以外への書き込みにはフルシートが必要です。書き込みはベータ期間中は無料で、Figma によると今後は従量制の有料機能になる予定です。
- 見た目が変わるデザイン変更には、隣に figma-generate-design(スキルが必須としています)、ライブラリのアセットには figma-generate-library。Figma のプラグインですべてがインストールされます。
スキルに含まれるファイル
| ファイル・フォルダー | 用途 |
|---|---|
SKILL.md | 21 の重要ルール、ページのルール、エディターのモード、効率的な API(node.query、node.set、createAutoLayout、インラインのスクリーンショット)、段階的なワークフロー、エラーからの復旧、実行前チェックリスト。 |
references/gotchas.md | 既知の落とし穴すべてを誤ったコードと正しいコードで紹介。テキスト編集のためのフォント読み込み手順から始まります。 |
references/common-patterns.md | そのまま動くスクリプトのひな形:図形、テキスト、オートレイアウト、変数、コンポーネント、複数ステップのワークフロー。 |
references/component-patterns.md | バリアントセット、コンポーネントプロパティ、インスタンスの入れ替え、既存コンポーネントの探し方。 |
references/variable-patterns.md | コレクション、モード、スコープ、エイリアス、変数のバインド。 |
references/working-with-design-systems/ | コンポーネント、変数、テキストスタイル、エフェクトスタイルの使い方と作り方を説明する 9 つの短いガイド。 |
references/plugin-api-standalone.d.ts | Plugin API の完全な型定義(約 400 KB)。全体を読むのではなく、正確なシグネチャを検索するために使います。 |
2026-11-15 時点でリポジトリに記載されていたライセンス:No licence file; Figma Developer Terms apply。
プロンプト例
インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。
- この Figma ファイルで、「Frame 12」のような初期設定の名前のままのレイヤーを、内容に基づいたわかりやすい名前に変更し、変更内容を一覧にしてください。
- Pricing ページにある、ハードコードされた青い塗りをすべて color/brand/primary 変数にバインドしてください。
- 整理の計画を立てたいので、このファイルのページ、コンポーネント、変数コレクションを一覧にしてください。
- Features フレームのカードを、今の見た目を保ったまま間隔 16 px のオートレイアウトに変換してください。
figma-use のインストール方法
Figma のプラグインか、関連スキルと一緒にインストールする
figma-use 単体でインストールすることはまれです。Claude Code 用の Figma のプラグインを使うと、リモート MCP サーバーと Figma のすべてのスキルが一度に追加されます。インストール後、/mcp を実行して Figma にサインインします。
フォルダーを手動でコピーする場合、下のコマンドは figma-generate-design と figma-generate-library もコピーします。figma-use は見た目が変わるデザイン作業とライブラリ作業をそれらに任せるからです。
claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcpCursor、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-guideclaude.ai へのアップロードや Claude API には非対応
このスキルは、Figma のリモート MCP サーバーにある use_figma ツールと組み合わせて初めて意味を持ちます。Claude API のスキル用サンドボックスはネットワークに接続できず、claude.ai での設定も確認できていません。
スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:
Claude Code:プラグインマーケットプレイスから
- ターミナルで
claudeを実行して Claude Code を起動します。 - このプラグインは Anthropic の公式マーケットプレイスにあります。公式マーケットプレイスは Claude Code の初回起動時に自動で追加されます。
- プラグインをインストールします。Claude Code はまず詳細を表示するので、追加されるもの(スキル、フック、MCP サーバー)を確認し、自分用、このリポジトリの全員用、このリポジトリでの自分用のどれにするかを選びます。
/plugin install figma@claude-plugins-official - / を入力して
/figma:figma-useを探すか、そのまま作業を依頼します。
セッション内ではなくシェルから行う場合:
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-generate-library, figma-generative-plugins, figma-implement-motion, figma-shaders, figma-spec, figma-swiftui, 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-use ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-generate-design ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-generate-library ~/.claude/skills/Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /figma-use と入力するか、作業内容をそのまま伝えます。
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-use .agents/skills/
cp -R mcp-server-guide/skills/figma-generate-design .agents/skills/
cp -R mcp-server-guide/skills/figma-generate-library .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 以降)。 |
これらの手順の出典
2026-11-14 に各ベンダーのドキュメントと照合しました:
安全なキャンバススクリプトの形
どのスクリプトも再試行できる小ささで、最初に一度だけ対象のページに切り替え、触れるフォントを読み込み、変更を加え、作成・変更した ID を返します。再試行しても害がない場合は関連する作業を 1 回の呼び出しにまとめ、ページの境目や実際に失敗した後で作業を分けます。
確認は、ステップごとにスクリーンショットを撮るのではなく、スクリプトが返す証拠(ID、件数、名前、サイズ)と、通常は組み立て後に 1 枚、見た目の修正後に 1 枚のスクリーンショットで行います。
大きなファイルでも返答を小さく
広範囲の読み取りでは ID、名前、種類、件数だけを返し、詳細は選んだ ID について後の呼び出しで取得します。各一覧(変数、スタイル、コンポーネント、ページ)は別々に返します。スキルはエージェントに、返答を黙って切り詰めるのではなく、返す前にそのサイズを測るよう指示しています。
figma-use に関するよくある質問
use_figma とは何ですか?
use_figma は Figma MCP サーバーの汎用的な書き込みツールです。エージェントが JavaScript のコードを送ると、Figma がファイル内で Plugin API に対してそれを実行し、スクリプトが返した値を返します。Figma Design、FigJam、Slides、Specs のファイルで使え、リモートサーバーでのみ動きます。
figma-generate-design があれば figma-use は不要ですか?
いいえ、必要です。figma-generate-design と figma-generate-library はどちらも、キャンバススクリプトの前に figma-use を必要とします。両者が頼る Plugin API のルールを figma-use が持っているからです。Figma のプラグインで一緒にインストールされます。
Figma が必須の前提条件とするのはなぜですか?
キャンバススクリプトは原因を突き止めにくい形で失敗するからです。フォントを読み込んでいないとテキスト編集でエラーになり、255 という色の値は範囲外で、誤ったセッターでページを切り替えるとエラーになり、ノード ID を返さないスクリプトは次の呼び出しを手探り状態にします。スキルはこうしたルールを最初に伝え、エージェントが試行錯誤で学ばなくて済むようにします。
FigJam のボードや Figma Slides も編集できますか?
use_figma は 3 つのエディターすべてで動きますが、使えるノードの種類はそれぞれ異なります。figma-use は Figma Design とその違いを扱い、FigJam と Slides については Figma が figma-use-figjam と figma-use-slides のスキルを用意しています。
figma-use スキルは無料ですか?
ファイルは無料でインストールできますが、オープンソースではありません。ライセンスファイルがなく、Figma の Developer Terms が適用されます。Figma アカウントと、下書き以外に書き込むためのフルシートが必要です。Figma によると、キャンバスへの書き込みはベータ期間中は無料で、今後は従量制の有料機能になる予定です。
ほかの AI スキル
関連スキル
Figma Generate Design スキル
公式 · Figmaデザインシステムのコンポーネントと変数を使い、コードから Figma ファイルの画面を作成・更新する Figma のスキル。Figma Generate Library スキル
公式 · Figmaコードから Figma にデザインシステムを構築する Figma のスキル。変数、ライト・ダークモード、スタイル、バリアント付きコンポーネントを作ります。Figma Use Motion スキル
公式 · FigmaAI で Figma ファイル内のレイヤーにアニメーションを付ける Figma のスキル。キーフレーム、アニメーションスタイル、イージング、テキストの表示演出、タイムラインの長さを扱います。Figma Design to Code スキル
公式 · FigmaFigma のフレームをプロジェクトのコードにする Figma のスキル。生成されたマークアップを貼り付けるのではなく、既存のコンポーネントとアセットを再利用します。サムネイル設計 スキル
コミュニティ · Frank Heijdenrijk内容に忠実でスマートフォンでも読める動画サムネイルを企画し、公式機能で比較テストを計画します。デザインとテンプレート スキル
コミュニティ · Frank Heijdenrijk繰り返し使うSNS画像向けに、ブランドキット、テンプレート群、制作手順を定義します。