본문으로 건너뛰기

Figma Generate Design 스킬

코드를 바탕으로 디자인 시스템의 컴포넌트와 변수를 써서 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-design 스킬은 코드나 설명을 바탕으로 Figma에 화면(페이지, 모달, 드로어, 폼, 대시보드)을 만드는 Figma의 공식 에이전트 스킬입니다. Claude는 Figma MCP 서버를 통해 디자인 시스템의 컴포넌트, 변수, 텍스트 스타일을 찾은 다음, 색을 하드코딩한 상자를 그리는 대신 실제 인스턴스로 화면을 섹션별로 조립합니다.

결과물은 붙여 넣은 스크린샷이 아니라 편집 가능한 Figma 레이어여야 합니다. 스킬은 UI를 평면 이미지로 가져와 결과물로 내놓는 것을 금지합니다. Figma 계정, Figma MCP 서버(원격), 대상 파일이 필요하며, 모든 캔버스 스크립트의 규칙을 담은 Figma의 figma-use 스킬과 함께 작동합니다.

스킬의 SKILL.md에서: Code-to-design output must recreate the UI as editable text, components, icons, and hierarchy.

Figma의 공식 스킬입니다. 다른 스킬과 마찬가지로 에이전트에게 지침을 주고 실행할 스크립트가 들어 있을 수 있으므로, 다른 곳의 사본이 아니라 여기에 링크된 소스에서 설치하세요.

하는 일

  1. 소스 코드(또는 설명)를 읽고 화면의 섹션과 각 섹션이 쓰는 UI 컴포넌트를 나열하며, 기본값인 Inter 대신 제품의 실제 글꼴을 찾습니다.
  2. 코드베이스의 Code Connect 파일로 그 컴포넌트를 찾고, Figma 라이브러리를 검색하고, 기존 화면에서 컴포넌트 키, 변수, 텍스트·효과 스타일을 조사합니다.
  3. 기존 콘텐츠와 떨어진 곳에 래퍼 프레임 하나를 만들고 그 안에 모든 섹션을 만들며, 원시 값 대신 디자인 시스템 인스턴스를 가져오고 변수를 연결합니다.
  4. 반복되는 요소는 인스턴스가 있는 로컬 컴포넌트로 만들고, 아이콘은 SVG로 가져옵니다.
  5. 결과를 검사합니다: 노드 수, 소스와 비교하는 전체 구성 스크린샷 한 장, 텍스트가 제품 글꼴을 쓰는지 명시적으로 확인. 그런 다음 잘못된 부분만 고칩니다.
  6. 사진이나 로고가 있는 웹 앱이라면 Figma의 페이지 캡처를 동시에 실행해 그 이미지를 편집 가능한 결과물로 복사한 뒤, 캡처를 삭제합니다.

얻을 수 있는 결과물

  • 디자인 시스템 컴포넌트 인스턴스, 로컬 컴포넌트, 변수, 스타일로 이루어진 Figma 파일 안의 새 프레임 또는 업데이트된 프레임.
  • 내 컴퓨터에 파일은 생기지 않습니다. 작업 결과는 Figma에 저장됩니다.

이럴 때 사용하세요

  • 앱 화면이 코드로 존재하고, 이를 게시된 컴포넌트로 만든 Figma 화면으로 옮기고 싶을 때.
  • Figma의 화면이 오래되어 지금의 코드와 맞춰야 할 때.
  • 이미 있는 디자인 시스템으로 새 화면, 모달, 대시보드를 Figma에 목업하고 싶을 때.

이럴 때는 맞지 않습니다

  • 결과물이 라이브러리용 재사용 컴포넌트나 토큰 세트일 때: Figma는 이 경우 figma-generate-library 스킬을 안내합니다.
  • Figma 디자인에서 코드를 얻고 싶을 때(반대 방향): figma-design-to-code와 MCP 서버의 design-context 도구가 그 용도입니다.
  • 파일에 게시된 디자인 시스템이나 팀 라이브러리가 없을 때: 스킬은 재사용할 컴포넌트가 있다고 가정하므로, 없으면 결과가 약해집니다.
  • 원격 Figma MCP 서버에 연결할 수 없을 때(예: 조직에서 차단): 서버 없이는 스킬이 작동하지 않습니다.

필요한 것

  • 대상 파일에 접근할 수 있는 Figma 계정. 내 초안(drafts) 밖에 쓰려면 Full 시트가 필요합니다. Figma에 따르면 캔버스 쓰기는 베타 기간에는 무료이며, 이후 사용량 기반 유료 기능이 될 예정입니다.
  • 에이전트에 연결되고 Figma에 로그인된 원격 Figma MCP 서버(https://mcp.figma.com/mcp).
  • Figma의 figma-use 스킬도 필요합니다. figma-generate-design은 캔버스 스크립트를 실행하기 전에 이 스킬을 요구합니다. Figma 플러그인을 설치하면 둘 다 설치됩니다.
  • 대상 Figma 파일(URL 또는 파일 키), 그리고 가능하면 그 안의 게시된 디자인 시스템이나 팀 라이브러리.
  • 화면의 소스 코드나 설명. 읽기 도구는 Figma의 호출 한도에 포함됩니다: Starter 요금제나 View 또는 Collab 시트에서는 월 최대 20회입니다. 쓰기 도구는 한도에서 제외됩니다.

스킬에 들어 있는 파일

파일 또는 폴더용도
SKILL.md필수 6단계 작업 흐름(이해, 컴포넌트/변수/스타일 찾기, 래퍼 프레임, 섹션 만들기, 검증, 업데이트), 적용 범위, 오류 복구.
references/componentization.md반복 요소를 처음부터 인스턴스가 있는 컴포넌트로 만들어야 하는 이유와 방법.
references/discover-product-font.md코드에서 제품의 실제 글꼴을 찾는 위치와, 만든 뒤 이를 확인하는 방법.

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

예시 프롬프트

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

  • figma-generate-design으로 우리 요금제 페이지(src/pages/pricing.tsx)를 이 Figma 파일에 만들어 줘: <file URL>. Acme UI 라이브러리의 컴포넌트를 써 줘.
  • Figma의 Settings 모달 프레임을 현재 SettingsModal.tsx에 맞게 업데이트하고, 바뀐 컴포넌트는 교체해 줘.
  • 헤더, 통계 카드 3개, 최근 주문 표가 있는 대시보드 화면을 Figma에 만들어 줘. 색과 간격은 우리 디자인 시스템 변수를 써서.
  • localhost:3000/checkout에서 실행 중인 앱을 Figma에 편집 가능한 레이어로 만들어 줘. 제품 이미지가 넘어오도록 먼저 캡처해 줘.

figma-generate-design 설치 방법

1단계: Figma MCP 서버 연결

Claude Code에서 가장 쉬운 방법은 Anthropic 공식 마켓플레이스의 Figma 플러그인입니다. MCP 서버 설정과 figma-use, figma-generate-design을 포함한 Figma의 모든 스킬을 추가해 줍니다. 셸에서 명령어를 실행하고 Claude Code를 시작한 뒤, /mcp를 실행하고 브라우저 안내에 따라 Figma에 로그인하세요.

플러그인 없이 하려면 서버를 직접 추가하고 두 스킬 폴더를 직접 설치하세요(아래 스킬 폴더 단계, figma-use도 복사).

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에서는 확장 프로그램으로 설치한 뒤 Gemini CLI 안에서 /mcp auth figma를 실행합니다. VS Code에서는 같은 URL로 HTTP MCP 서버를 추가하고(명령 팔레트, MCP: Add Server) Copilot의 에이전트 모드를 쓰세요.

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

claude.ai 업로드나 Claude API Skills 엔드포인트에는 맞지 않음

이 스킬은 실시간 MCP 도구(use_figma, search_design_system 등)에 의존합니다. 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-design가 있는지 확인하거나, 그냥 작업을 요청하세요.

세션 대신 셸에서 설치하려면:

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-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-generate-design ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/

Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /figma-generate-design를 입력하거나 작업을 설명하면 됩니다.

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-generate-design .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에 각 업체의 문서와 대조해 확인했습니다:

화면을 만드는 방식

이 스킬은 순서를 엄격히 지킵니다. 만들기 전에 먼저 찾습니다: 저장소의 Code Connect 파일을 가장 먼저 확인하고, 다음으로 라이브러리를 검색하고(의도마다 쿼리 하나, "pill", "tab", "chip" 같은 동의어 포함), 그다음 기존 화면을 조사합니다. 디자인 시스템이 다루지 않는 빈틈만 직접 만듭니다.

나중에 캔버스 스크립트 사이에서 노드를 옮기면 오류 없이 실패하기 때문에, 모든 것을 처음에 만든 래퍼 프레임 하나 안에서 만듭니다. 작업은 다시 시도해도 안전한 단계로 나뉘어 실행되므로, 오류가 나도 현재 단계에만 영향을 주고 앞서 만든 섹션은 그대로 남습니다.

스크립트가 오류 없이 엉뚱한 글꼴을 불러올 수 있으므로, 검증은 소스와 비교하는 전체 구성 스크린샷 한 장과 글꼴 패밀리 확인으로 마무리합니다.

이미지와 AI 크레딧

캔버스 스크립트는 URL에서 이미지를 가져올 수 없습니다. 사진, 아바타, 로고가 있는 웹 앱이라면 스킬이 Figma의 캡처 도구로 실행 중인 페이지를 같은 파일에 캡처하고 이미지 채우기를 복사합니다. 쓸 수 있는 이미지가 없으면 Figma AI로 플레이스홀더를 생성할 수 있으며, Figma AI 크레딧을 쓰기 때문에 그렇게 했다고 알려 줍니다.

figma-generate-design에 관한 질문

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

스킬 파일은 무료로 읽고 설치할 수 있지만 오픈 소스는 아닙니다. 저장소에 라이선스 파일이 없으며 Figma의 Developer Terms가 적용됩니다. 사용하려면 Figma 계정이 필요합니다. Figma에 따르면 캔버스 쓰기는 베타 기간에는 무료이고 이후 사용량 기반 유료 기능이 될 예정이며, 읽기 도구는 요금제와 시트에 따라 호출 한도가 있습니다.

Figma MCP 서버가 필요한가요?

네. 모든 단계가 원격 Figma MCP 서버의 도구를 통해 실행됩니다. 예를 들어 use_figma로 캔버스에 만들고, search_design_system으로 컴포넌트를 찾습니다. 서버가 연결되어 로그인되어 있지 않으면 스킬은 아무것도 할 수 없습니다.

어떤 Figma 요금제나 시트가 필요한가요?

Figma 개발자 문서에 따르면 내 초안 밖에 쓰려면 Full 시트가 필요합니다. 읽기 도구는 요금제와 시트별로 한도가 있습니다: Starter 요금제나 View 또는 Collab 시트에서는 월 최대 20회, Professional, Organization, Enterprise의 Dev 또는 Full 시트에서는 일 단위와 분 단위 한도가 적용됩니다. 파일에 쓰는 도구는 한도에서 제외됩니다.

편집 가능한 레이어가 나오나요, 스크린샷이 나오나요?

편집 가능한 레이어입니다. 스킬의 엄격한 규칙에 따라 결과물은 UI를 편집 가능한 텍스트, 컴포넌트, 아이콘, 계층 구조로 다시 만들어야 하며, 스크린샷은 시각적 참고용으로만 쓰고 나중에 삭제합니다.

Figma 파일에 디자인 시스템이 없으면 어떻게 되나요?

스킬은 게시된 디자인 시스템이나 팀 라이브러리 접근 권한을 사전 요구 사항으로 둡니다. 없으면 재사용할 컴포넌트나 변수가 없습니다. 라이브러리 자체를 만들 때는 Figma가 figma-generate-library 스킬을 제공합니다.

Cursor, Codex, Gemini CLI에서도 작동하나요?

Figma 가이드는 Claude Code, Cursor, Gemini CLI, Copilot을 쓰는 VS Code용 설정을 안내하며, Streamable HTTP MCP 서버를 지원하는 다른 도구도 연결할 수 있다고 합니다. 스킬 폴더 자체는 SKILL.md 표준을 따르므로, 스킬 폴더를 읽고 Figma MCP 서버가 연결된 에이전트라면 불러올 수 있습니다.

더 많은 AI 스킬

관련 스킬

스킬 카테고리