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 값으로, fills와 strokes는 새 배열로 다시 할당, 오토 레이아웃 크기는 노드를 부모에 추가한 뒤에만 설정, 새 최상위 프레임은 원점에서 떨어진 곳에 배치.
- 페이지 처리 방법(스크립트당 페이지 전환은 최대 한 번, 여러 페이지 작업은 병렬 호출로 나누기)과 Figma Design, FigJam, Slides 파일의 차이를 설명합니다.
- 에이전트가 어떤 짝 스킬을 불러올지 알려 줍니다: 눈에 보이는 디자인 변경은 figma-generate-design, 재사용 컴포넌트와 토큰은 figma-generate-library, 원근감과 기울이기는 3D 변형 스킬.
- 디자인 시스템 작업(컴포넌트, 변수, 텍스트·효과 스타일)을 전용 참고 문서로 다루고, 먼저 ID와 개수를 반환해 큰 읽기 작업을 작게 유지합니다.
- 오류 복구 방법을 정합니다: 실패한 스크립트를 다시 시도해도 안전한지, 아니면 에이전트가 먼저 캔버스를 읽어 무엇이 바뀌었는지 확인해야 하는지.
얻을 수 있는 결과물
- 자체 결과물은 없습니다. 에이전트가 use_figma 스크립트를 쓰는 방식을 정할 뿐이며, 결과는 작업이 요청한 대로 Figma 파일에 만들어지거나 편집된 내용입니다.
이럴 때 사용하세요
- Figma MCP 서버를 통해 Figma 파일에 쓰는 모든 에이전트 작업: use_figma 전에 자동으로 불러옵니다.
- 디자이너에게는 번거로운 프로그래밍 방식 편집: 레이어 이름 일괄 변경, 색상을 변수에 연결, 오토 레이아웃 수정, 파일 구조 점검.
- 직접 Figma 스킬을 만들면서 공식 스킬이 바탕으로 삼는 기본 규칙이 필요할 때.
이럴 때는 맞지 않습니다
- 화면 전체나 디자인 시스템 라이브러리를 만들 때: figma-use를 스스로 불러오는 figma-generate-design이나 figma-generate-library를 쓰세요.
- Figma 디자인을 코드로 바꿀 때: 파일을 읽기만 하는 작업이라 figma-design-to-code가 맡습니다.
- Figma 데스크톱 MCP 서버만 쓸 때: 캔버스에 쓸 수 없으므로 거기서는 use_figma를 쓸 수 없습니다.
필요한 것
- 연결되어 로그인된 원격 Figma MCP 서버(https://mcp.figma.com/mcp). Figma 문서에 따르면 캔버스 쓰기는 원격 서버에서만 작동합니다.
- 파일 편집 권한이 있는 Figma 계정. 내 초안 밖에 쓰려면 Full 시트가 필요합니다. 쓰기는 베타 기간에는 무료이며, 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는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /figma-use를 입력하거나 작업을 설명하면 됩니다.
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-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를 반환합니다. 다시 시도해도 문제없는 관련 작업은 한 번의 호출로 묶을 수 있으며, 작업은 페이지 경계나 실제 실패가 난 뒤에 나눕니다.
확인은 단계마다 스크린샷을 찍는 대신 스크립트가 반환한 근거(ID, 개수, 이름, 크기)와, 보통 구성 후 한 장, 시각적 수정 후 한 장의 스크린샷으로 합니다.
응답이 커지지 않는 큰 파일 다루기
넓은 범위를 읽을 때는 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는 범위를 벗어나며, 잘못된 setter로 페이지를 전환하면 오류가 나고, 노드 ID를 반환하지 않는 스크립트는 다음 호출이 아무것도 모르게 만듭니다. 이 스킬은 그런 규칙을 미리 알려 줘서 에이전트가 시행착오로 배우지 않게 합니다.
FigJam 보드와 Figma Slides도 편집할 수 있나요?
use_figma는 세 에디터 모두에서 작동하지만, 에디터마다 허용하는 노드 유형이 다릅니다. figma-use는 Figma Design과 그 차이점을 다루며, FigJam과 Slides용으로는 Figma가 figma-use-figjam과 figma-use-slides 스킬을 제공합니다.
figma-use 스킬은 무료인가요?
파일은 무료로 설치할 수 있지만 오픈 소스는 아닙니다. 라이선스 파일이 없으며 Figma의 Developer Terms가 적용됩니다. Figma 계정과, 내 초안 밖에 쓰려면 Full 시트가 필요합니다. 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 그래픽용 재사용 브랜드 키트, 템플릿 묶음, 제작 절차를 정의합니다.