コンテンツへスキップ

Figma Design to Code スキル

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-design-to-code スキルは、Figma のデザインをコードとして実装するための Figma 公式のエージェントスキルです。エージェントにフレームのリンクを渡すと、その画面やコンポーネントをプロジェクト内に作ります。Figma はこれを MCP サーバーの get_design_context ツールの必須の前提条件としているため、エージェントが Figma からデザインを取り出すたびに読み込まれます。

このスキルがあるのは、Figma が返すコードが完成したコンポーネントではなく参考資料だからです。スキルはエージェントに、それを忠実度の高い操作できないプロトタイプとして扱わせます:絶対配置をプロジェクトのレイアウトの仕組みに置き換え、既存のコンポーネント、トークン、Code Connect のマッピングを再利用し、すべての画像と SVG をデザインどおりに配置し、最後にデザインのスクリーンショットと照らし合わせて結果を確認します。Figma からは読み取るだけで、コードから Figma に書き込む figma-generate-design とは逆方向です。

スキルの SKILL.md より: treat returned code as a high visual fidelity non-interactive prototype

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

できること

  1. 最初の get_design_context の呼び出しでスクリーンショットを求め(または get_screenshot を呼び出し)、完成したコードが合わせるべき見た目の目標として使います。
  2. 返答が情報不足(sparse)と示された場合は、子ノードの ID をスクリーンショットと照らし合わせ、見えている子要素を 1 回の並列バッチで要求し、その詳細な返答だけをもとに実装します。
  3. プロジェクトとインストール済みのデザインライブラリのパッケージから一致するコンポーネント、アセット、トークンを探し、生のマークアップ、インラインスタイル、ハードコードした値を書かずに、それらを再利用したり組み合わせたりします。
  4. Code Connect でマッピングされたコンポーネントがあれば、つなぎ込みに手間がかかっても必ずそれを使います。
  5. 静的な画像と SVG はすべてプロジェクトにダウンロードし、位置とサイズを正確に保ちます。コードに Figma の一時的なアセット URL は残しません。データに応じて変わる画像は動的なままにします。
  6. 依頼された画面やコンポーネントだけを検証します:すべてのアセットファイル、その配置先、呼び出し箇所、表示サイズを確認し、範囲内の食い違いは直し、範囲外のものは変更せずに指摘します。

得られるもの

  • リポジトリ内のコードの変更:使っているスタック向けのコンポーネントまたはページ(Figma からは React と Tailwind が初期設定で、プロジェクトに合わせて調整されます)と、ダウンロードした画像・SVG のアセット。
  • Figma ファイルは変更されません。

使う場面

  • デザイナーから Figma のフレームを受け取り、既存のコードベースとデザインシステムで実装したいとき。
  • Code Connect を使っていて、マッピング済みのコンポーネントを作り直さずに再利用したいとき。
  • これまでのデザインのコード化で、絶対配置のマークアップ、アイコンの欠落、期限切れの Figma 画像へのリンクが生まれてしまったとき。

向かない場面

  • 逆方向(コードから Figma)にしたい場合:figma-generate-design を使ってください。
  • デザインにアニメーションがあり、動きも必要な場合:figma-implement-motion を加えてください。このスキルの構造に合わせて get_motion_context を扱います。
  • 対象が SwiftUI の場合:SwiftUI と Figma の変換は Figma の figma-swiftui スキルが専門に扱います。
  • 既存のコンポーネントがなく、ピクセル単位で正確な出力が必要な場合:スキルは動きますが、主な価値はプロジェクトに既にあるものの再利用です。

必要なもの

  • 接続済みでサインインした状態の Figma MCP サーバー。Figma はリモートサーバーを推奨しています。get_design_context はデスクトップサーバーにもありますが、Figma デスクトップアプリと、有料プランの Dev シートまたはフルシートが必要です。
  • デザインにアクセスできる Figma アカウント。このスキルは読み取るだけなので書き込み権限は不要ですが、読み取りツールには回数制限があります:Starter プラン、または閲覧シート・コラボシートでは月 20 回まで、有料の Dev シート・フルシートでは 1 日あたりと 1 分あたりの制限です。
  • コンポーネント、トークン、アセットの置き場所を見つけられるよう、エージェントでプロジェクトを開いておくこと。
  • フレームまたはレイヤーへのリンク(Figma の URL にはファイルキーとノード ID が含まれます)。

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

ファイル・フォルダー用途
SKILL.mdスキル全体。3 つの短いセクションで構成されます:コンテキスト(スクリーンショット、情報不足の返答)、実装(再利用、Code Connect、アセット)、検証。

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

プロンプト例

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

  • この Figma フレームを、既存の Button と Card を使って src/components に React コンポーネントとして実装してください:<frame URL>。
  • この Figma のリンクの設定ページを、Tailwind とこちらのデザイントークンを使って Next.js アプリに作り、アイコンは public/icons にダウンロードしてください。
  • この Figma のデザインを、スクリーンショットとぴったり同じになるよう素の HTML と CSS にしてください:<frame URL>。
  • ProfileHeader.tsx を最新の Figma のデザインに合わせて更新してください。Code Connect でマッピングされている Avatar コンポーネントを再利用してください。

figma-design-to-code のインストール方法

Figma MCP サーバーを接続する

Claude Code では、Anthropic の公式マーケットプレイスにある Figma のプラグインで、リモート MCP サーバーと、このスキルを含む Figma のスキル一式が追加されます。インストール後、/mcp を実行して Figma にサインインします。または、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 は HTTP MCP サーバーで接続します。組織でデスクトップサーバーを使っている場合、そのアドレスは http://127.0.0.1:3845/mcp で、Figma デスクトップアプリを開き Dev Mode でサーバーを有効にしている間だけ使えます。

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

claude.ai へのアップロードや Claude API には非対応

このスキルは、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-design-to-code を探すか、そのまま作業を依頼します。

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

claude plugin install figma@claude-plugins-official

プラグインは丸ごとインストールされるため、figma-3d-transforms, figma-code-connect, figma-code-workflows, figma-create-new-file, figma-generate-design, figma-generate-diagram, figma-generate-library, 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-design-to-code ~/.claude/skills/

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

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-design-to-code .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 に各ベンダーのドキュメントと照合しました:

作り直すより再利用

スキルの大部分は、プロジェクトにあるものを作り直さないための内容です。エージェントは編集する前に、ありそうなプロジェクトのパスとインストール済みのデザインライブラリのパッケージを調べ、一致するコンポーネント、アセット、トークンを再利用し、それらでデザインを表現できない場合にだけ変更しなければなりません。Code Connect のマッピングは、コンポーネントがどうしても設定できない場合を除き、常にマッピング先のノードで使われます。

Figma の絶対配置は、デザインが本当に固定位置を必要とする場合を除き、プロジェクト独自のレイアウトに置き換えられます。デザイン内の操作できる部分は、操作できるコードになります。

失敗の多くはアセットで起きる

スキルは画像と SVG に厳格です。どれもデザインコンテキストの返答のとおりにダウンロードして正確な位置で使い、描き直したり、インライン化したり、似たものに差し替えたり、Figma の一時的な URL を指したまま残したりはしません。SVG は元の幅と高さを保ちます。検証のステップでは、アセットが 1 つでも差し替えられていたり縦横比が崩れていたりすれば失敗とみなされます。

figma-design-to-code に関するよくある質問

figma-design-to-code と figma-generate-design の違いは?

向きが逆です。figma-design-to-code は Figma のデザインを読み取り、リポジトリにコードを書きます。figma-generate-design はコードを読み取り、Figma に編集可能な画面を作ります。多くのチームは Figma のプラグインで両方をインストールしています。

コードは React で出力されますか?

Figma の get_design_context は初期設定で React と Tailwind を返し、指定すれば Vue、素の HTML と CSS、iOS などほかのフレームワークも返せます。スキルはその出力をそのまま貼り付けるのではなく、プロジェクトのスタック、規約、既存のコンポーネントに合わせて調整します。

Figma の有料シートは必要ですか?

このスキルは読み取るだけなので、書き込みのためには不要です。ただし読み取りツールには制限があり、Starter プラン、または閲覧シート・コラボシートでは月 20 回までです。Professional、Organization、Enterprise プランの Dev シート・フルシートでは代わりに 1 日あたりと 1 分あたりの制限になり、日常的な利用に向いています。

なぜスクリーンショットにこだわるのですか?

スクリーンショットは、完成したコードが合わせるべき見た目の目標だからです。スキルはそれをコード内の画像として使うことを禁じています。実装は詳細なデザインコンテキストから行い、実際のアセットをダウンロードして配置しなければなりません。

figma-design-to-code スキルは無料ですか?

ファイルは無料でインストールできますが、オープンソースではありません。リポジトリにはライセンスファイルがなく、Figma の Developer Terms が適用されます。Figma アカウントが必要で、プランとシートに応じた Figma の読み取りツールの回数制限の対象になります。

ほかの AI スキル

関連スキル

スキルのカテゴリー