본문으로 건너뛰기

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.

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

하는 일

  1. 모든 use_figma 스크립트의 기본 규칙을 정합니다: 최상위 await를 쓰는 일반 JavaScript, 결과는 return으로 반환(console.log는 보이지 않음), 다음 호출이 찾을 수 있도록 만들거나 바꾼 모든 노드 ID를 반환.
  2. 흔한 실패를 막습니다: 텍스트를 편집하기 전에 글꼴 불러오기, 색상은 0–1 값으로, fills와 strokes는 새 배열로 다시 할당, 오토 레이아웃 크기는 노드를 부모에 추가한 뒤에만 설정, 새 최상위 프레임은 원점에서 떨어진 곳에 배치.
  3. 페이지 처리 방법(스크립트당 페이지 전환은 최대 한 번, 여러 페이지 작업은 병렬 호출로 나누기)과 Figma Design, FigJam, Slides 파일의 차이를 설명합니다.
  4. 에이전트가 어떤 짝 스킬을 불러올지 알려 줍니다: 눈에 보이는 디자인 변경은 figma-generate-design, 재사용 컴포넌트와 토큰은 figma-generate-library, 원근감과 기울이기는 3D 변형 스킬.
  5. 디자인 시스템 작업(컴포넌트, 변수, 텍스트·효과 스타일)을 전용 참고 문서로 다루고, 먼저 ID와 개수를 반환해 큰 읽기 작업을 작게 유지합니다.
  6. 오류 복구 방법을 정합니다: 실패한 스크립트를 다시 시도해도 안전한지, 아니면 에이전트가 먼저 캔버스를 읽어 무엇이 바뀌었는지 확인해야 하는지.

얻을 수 있는 결과물

  • 자체 결과물은 없습니다. 에이전트가 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.tsPlugin 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/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 업로드나 Claude API에는 맞지 않음

이 스킬은 Figma 원격 MCP 서버의 use_figma 도구가 있어야 의미가 있습니다. 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-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 이상).
신뢰할 수 있는 스킬만 설치하세요. Anthropic은 신뢰할 수 있는 출처의 스킬만 사용하고, 그 밖의 스킬은 사용하기 전에 모든 파일을 읽어 보라고 권합니다. 스킬은 설명에 나오지 않는 방식으로 에이전트에게 명령어 실행, 파일 읽기, 데이터 전송을 지시할 수 있기 때문입니다.

이 단계의 출처

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 스킬

관련 스킬

스킬 카테고리