본문으로 건너뛰기

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 스킬이 정하므로 두 스킬은 항상 함께 불러옵니다. 원격 Figma MCP 서버를 통해 실행되며, Figma 계정과 편집할 수 있는 파일이 필요합니다. 요청 규모에 맞춰 작동합니다: 토큰 세트, 컴포넌트 하나, 전체 라이브러리, 또는 코드와 Figma 사이에서 어긋난 부분 맞추기.

스킬의 SKILL.md에서: Build professional-grade design-system assets in Figma that match code.

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

하는 일

  1. 파일을 건드리기 전에 범위를 하나 고르고(토큰만, 컴포넌트 하나 또는 한 계열, 전체 라이브러리, 코드와 Figma 맞추기), 무엇을 만들고 어떻게 확인할지 짧은 체크리스트로 알려 줍니다.
  2. 먼저 조사합니다: 관련 코드를 분석하고, 파일의 기존 페이지, 변수, 스타일을 살펴보고, 파일에서 쓸 수 있는 라이브러리를 나열해 검색하며, 코드와 Figma의 값이 다르면 사용자에게 묻습니다.
  3. 변수 컬렉션과 모드(예: Primitives와, Light·Dark 모드가 있는 Color 컬렉션), 프리미티브를 참조하는 시맨틱 변수, 모든 변수의 범위(scope), 그리고 코드를 가리키는 CSS var() 코드 구문을 만듭니다.
  4. 의존 순서대로 컴포넌트를 만들며 배리언트 세트, 컴포넌트 속성, 변수 연결을 갖추고, 아이콘마다 배리언트를 만드는 대신 인스턴스 교체(instance swap)를 쓰며, 30개가 넘는 배리언트 조합은 나눕니다.
  5. 전체 라이브러리라면 표지, 시작하기, 파운데이션, 컴포넌트 페이지를 추가하고, 이어서 Code Connect 매핑과 접근성·이름·연결에 대한 최종 점검을 합니다.
  6. 만든 모든 ID를 JSON 파일의 상태 기록(state ledger)에 남겨 긴 작업을 새 채팅에서 이어 갈 수 있게 하며, 캔버스 스크립트 두 개를 동시에 실행하지 않습니다.

얻을 수 있는 결과물

  • Figma 파일 안의 변수, 모드, 텍스트 스타일, 효과 스타일, 컴포넌트, 컴포넌트 세트. 범위에 포함되면 문서 페이지도 만듭니다.
  • 만든 항목을 기록해 작업을 이어 가는 데 쓰는, 내 컴퓨터의 상태 파일(/tmp/design-system-state-<run id>.json).

이럴 때 사용하세요

  • 디자인 토큰과 컴포넌트는 코드에 있는데 Figma 라이브러리가 없거나, 불완전하거나, 오래되었을 때.
  • 새 컴포넌트 하나를 손으로 그리지 않고 배리언트와 변수 연결까지 갖춰 Figma에 제대로 만들어야 할 때.
  • CSS와 일치하는 라이트·다크 테마를 Figma 변수 모드로 설정할 때.
  • 코드와 Figma가 어긋나서 바뀐 토큰과 컴포넌트만 제자리에서 업데이트하고 싶을 때.

이럴 때는 맞지 않습니다

  • 기존 라이브러리로 화면이나 페이지를 만들고 싶을 때: 그건 figma-generate-design이 하는 일입니다.
  • Figma 디자인에서 코드를 얻고 싶을 때: 대신 figma-design-to-code를 쓰세요.
  • 참고할 코드나 토큰 소스가 없고 브랜드를 새로 만들어 주길 원할 때: 이 스킬은 코드가 정의한 것을 만들며, 추측하지 않고 묻습니다.
  • 공유 파일에서 View 또는 Collab 시트만 있을 때: 내 초안 밖에 쓰려면 Full 시트가 필요합니다.

필요한 것

  • Figma 계정과 편집할 수 있는 파일. Figma 문서에 따르면 내 초안 밖에 쓰려면 Full 시트가 필요하며, 캔버스 쓰기는 베타 기간에는 무료이고 이후 사용량 기반 유료 기능이 될 예정입니다.
  • 에이전트에 연결되고 Figma에 로그인된 원격 Figma MCP 서버(https://mcp.figma.com/mcp).
  • Figma의 figma-use 스킬. 이 스킬은 모든 캔버스 스크립트에 figma-use를 요구합니다. Figma 플러그인을 설치하면 둘 다 설치됩니다.
  • 기준이 되는 코드베이스(또는 토큰 파일). 읽기 도구는 Figma의 호출 한도에 포함됩니다: Starter 요금제나 View 또는 Collab 시트에서는 월 최대 20회입니다. 쓰기 도구는 한도에서 제외됩니다.
  • 전체 라이브러리라면 충분한 시간: 체크포인트가 있는 단계로 나뉘어 실행되며, 스킬이 새 채팅에서 이어 갈 수 있는 이어 하기 프롬프트를 줍니다.

스킬에 들어 있는 파일

파일 또는 폴더용도
SKILL.md범위 계약, 범위별 작업 흐름, 디자인 시스템 규칙 15가지, 상태 기록, 라이브러리 재사용 기준표, 그리고 사용자에게 물어야 할 때.
references/discovery-phase.md무엇이든 바꾸기 전에 코드와 Figma 파일을 분석하는 방법.
references/token-creation.md컬렉션, 모드, 별칭(alias), 범위, 코드 구문. 더 큰 멀티 브랜드 패턴도 포함합니다.
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를 바탕으로 Figma에 Button 컴포넌트를 만들어 줘. 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 서버를 추가한다면 폴더를 직접 복사해도 됩니다.

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

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

먼저 범위를 정하고, 거기서 멈추기

이 스킬은 범위가 불어나지 않도록 쓰였습니다. 컴포넌트 하나를 요청하면 전체 라이브러리로 커지지 않습니다: 그 컴포넌트에 필요한 빠진 토큰만 만들고, 검증하고, 요청한 상태를 작은 프레임 하나에 인스턴스로 보여 준 뒤 멈춥니다. 토큰만 요청하면 컴포넌트는 만들지 않습니다.

범위마다 완료 기준(배리언트 범위, 변수 범위와 별칭, 코드 구문, 연결, 시각적 확인)이 따로 있으며, 추가 문서나 점검은 시작하지 않고 후속 작업으로 보고합니다.

라이브러리를 깔끔하게 유지하는 규칙

모든 변수는 모든 속성 선택기에 나타나는 대신 명시적인 범위(배경, 텍스트, 테두리, 간격, 모서리 반경)를 가지며, 웹 코드 구문은 실제 CSS 변수 이름을 쓴 var() 형식을 씁니다. 시맨틱 색상은 원시 값을 반복하지 않고 프리미티브를 참조합니다.

정리 작업은 이름으로 추측하지 않고 기록에 있는 정확한 ID의 노드만 삭제하므로, 사용자가 만든 레이어는 지우지 않습니다.

figma-generate-library에 관한 질문

figma-generate-library와 figma-generate-design은 무엇이 다른가요?

figma-generate-library는 디자인 시스템의 재사용 가능한 부품(변수, 스타일, 컴포넌트, 배리언트 세트)을 만듭니다. figma-generate-design은 그 부품으로 화면과 페이지를 만듭니다. 작업에 둘 다 필요하면 Figma의 figma-use 스킬은 두 스킬을 모두 불러오라고 안내합니다.

라이트·다크 모드 변수를 만들 수 있나요?

네. 기본 토큰 패턴은 모드가 하나인 Primitives 컬렉션, 프리미티브를 참조하는 Light·Dark 모드의 Color 컬렉션, 그리고 별도의 Spacing, Typography 컬렉션입니다. 더 큰 시스템은 브랜드나 대비 배리언트처럼 모드를 더 쓸 수 있습니다.

라이브러리에 이미 있는 컴포넌트를 다시 만드나요?

아니요. 먼저 검색합니다. 속성, 토큰 모델, 이름이 맞으면 라이브러리 컴포넌트를 재사용하고, 겉모습은 맞지만 속성이 맞지 않으면 감싸서(wrap) 쓰며, API나 토큰 모델이 호환되지 않거나 라이브러리를 편집할 수 없을 때만 새로 만듭니다. 선택이 분명하지 않으면 사용자에게 묻습니다.

figma-use가 필요한가요?

네. 스킬에 따르면 모든 use_figma 호출에 figma-use를 불러와야 합니다. figma-generate-library는 무엇을 어떤 순서로 만들지 알고, figma-use는 Plugin API 규칙을 압니다. Figma 플러그인을 설치하면 둘 다 설치됩니다.

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

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

긴 작업이 중간에 끊기면 어떻게 되나요?

스킬은 만든 모든 ID를 JSON 파일의 상태 기록에 남기고, 실행 ID가 담긴 이어 하기 프롬프트를 줍니다. 새 채팅에서 그 파일을 다시 읽고 Figma 파일을 이름으로 검색해, 이미 있는 것을 중복하지 않고 멈춘 곳부터 이어 갑니다.

더 많은 AI 스킬

관련 스킬

스킬 카테고리