본문으로 건너뛰기

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를 스크린샷과 맞춰 보고, 보이는 하위 노드를 한 번에 병렬로 요청한 뒤 그 자세한 응답만으로 구현합니다.
  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일 때: Figma의 figma-swiftui 스킬이 SwiftUI와 Figma 간 변환을 따로 다룹니다.
  • 기존 컴포넌트 없이 픽셀 단위로 똑같은 결과가 필요할 때: 스킬은 그래도 작동하지만, 가장 큰 가치는 프로젝트에 이미 있는 것을 재사용하는 데 있습니다.

필요한 것

  • 연결되어 로그인된 Figma MCP 서버. Figma는 원격 서버를 권장합니다. get_design_context는 데스크톱 서버에도 있지만, 데스크톱 서버에는 Figma 데스크톱 앱과 유료 요금제의 Dev 또는 Full 시트가 필요합니다.
  • 디자인에 접근할 수 있는 Figma 계정. 이 스킬은 읽기만 하므로 쓰기 권한은 필요 없지만, 읽기 도구에는 호출 한도가 있습니다: Starter 요금제나 View 또는 Collab 시트에서는 월 최대 20회, 유료 Dev·Full 시트에서는 일 단위와 분 단위 한도가 적용됩니다.
  • 에이전트에서 열린 프로젝트. 그래야 컴포넌트와 토큰, 에셋을 둘 알맞은 위치를 찾을 수 있습니다.
  • 프레임이나 레이어 링크(Figma URL에는 파일 키와 노드 ID가 들어 있습니다).

스킬에 들어 있는 파일

파일 또는 폴더용도
SKILL.md스킬 전체로, 짧은 세 부분으로 이루어져 있습니다: 컨텍스트(스크린샷, 희소 응답), 구현(재사용, Code Connect, 에셋), 검증.

2026-11-15 기준 저장소에 있는 라이선스: No licence file; Figma Developer Terms apply.

예시 프롬프트

설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.

  • 기존 Button과 Card를 써서 이 Figma 프레임을 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에 로그인하세요. 또는 두 번째 명령어로 서버를 추가하고 이 폴더만 복사해도 됩니다. 이 스킬에는 다른 파일도, 함께 복사할 짝 스킬도 없습니다.

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 서버로 연결합니다. 조직에서 데스크톱 서버를 쓴다면, Figma 데스크톱 앱이 열려 있고 Dev Mode에서 서버가 켜져 있는 동안 주소는 http://127.0.0.1:3845/mcp입니다.

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

claude.ai 업로드나 Claude API에는 맞지 않음

이 스킬은 Figma MCP 서버의 design-context 도구 호출만 안내합니다. 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는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /figma-design-to-code를 입력하거나 작업을 설명하면 됩니다.

Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.

Codex, Gemini CLI, Cursor, GitHub Copilot

이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .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에 엄격합니다: 각각을 design-context 응답이 설명하는 대로 내려받아 정확한 위치에 쓰며, 다시 그리거나, 인라인으로 넣거나, 비슷한 것으로 바꾸거나, 임시 Figma URL을 가리킨 채로 두지 않습니다. SVG는 원래 너비와 높이를 유지합니다. 에셋 하나라도 바뀌었거나 비율이 틀리면 검증 단계에서 실패로 칩니다.

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 요금제나 View 또는 Collab 시트에서는 월 최대 20회입니다. Professional, Organization, Enterprise 요금제의 Dev·Full 시트는 대신 일 단위와 분 단위 한도가 적용되어 꾸준히 쓰기에 알맞습니다.

왜 스크린샷을 꼭 요구하나요?

스크린샷은 완성된 코드가 맞춰야 할 시각적 목표입니다. 스킬은 스크린샷을 코드 안의 이미지로 쓰는 것을 금지합니다. 구현은 자세한 디자인 컨텍스트를 바탕으로 해야 하며, 실제 에셋을 내려받아 배치해야 합니다.

figma-design-to-code 스킬은 무료인가요?

파일은 무료로 설치할 수 있지만 오픈 소스는 아닙니다. 저장소에 라이선스 파일이 없으며 Figma의 Developer Terms가 적용됩니다. Figma 계정이 필요하고, 요금제와 시트에 따른 Figma 읽기 도구 호출 한도에 포함됩니다.

더 많은 AI 스킬

관련 스킬

스킬 카테고리