Figma Use Motion 스킬
AI로 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-use-motion 스킬은 Figma Motion으로 Figma 파일 안의 레이어에 애니메이션을 넣는 Figma의 공식 에이전트 스킬입니다: 키프레임 추가와 편집, 채우기와 선 색상 애니메이션, 애니메이션 스타일 적용, 이징과 스프링 설정, 타자기 효과 같은 텍스트 등장 효과 만들기, 타임라인 길이 변경. figma-use의 추가 기능이며 항상 함께 불러옵니다.
시간 축만 다루며, 도형, 컴포넌트, 레이아웃은 figma-use가 맡습니다. 모션은 아직 제한되어 있습니다: Figma Motion은 공개 베타이며, 스킬은 계정에서 해당 API가 켜져 있지 않을 수 있다고 경고합니다. 그 경우 에이전트는 멈추고 사용자에게 알립니다. Figma 애니메이션을 코드로 출시하려면 짝이 되는 figma-implement-motion 스킬을 쓰세요.
스킬의 SKILL.md에서: Motion APIs might not be enabled for the calling user.
하는 일
- 먼저 모션을 쓸 수 있는지 확인하고, 첫 번째 "not a supported API" 오류에서 다시 시도하지 않고 멈춥니다. 모션, 사용자 지정 애니메이션 스타일, 3D 모션은 사용자마다 각각 꺼져 있을 수 있기 때문입니다.
- Figma의 공개 필드 이름으로 레이어에 키프레임 트랙(위치, 회전, 크기, 불투명도, 채우기, 선, 효과)을 추가, 편집, 삭제합니다.
- 애니메이션 스타일을 적용, 편집, 삭제하기 전에 Figma의 기본 애니메이션 스타일과 파일 자체의 사용자 지정 애니메이션 스타일을 찾습니다.
- Figma의 기본 텍스트 스태거로 글자, 단어, 줄, 문단 단위로 텍스트에 애니메이션을 넣으며, 텍스트는 편집 가능한 상태로 서식도 그대로 유지합니다.
- Figma의 공개 이징 형태(ease out, ease in and out, 사용자 지정 3차 베지어, 스프링, hold)로 이징을 설정하고, 타임라인은 초 단위로 늘리며 요청이 없으면 줄이지 않습니다.
- 스크린샷은 정지 상태만 보여 주므로, 최상위 프레임을 작고 프레임 레이트가 낮은 MP4로 내보내고 ffmpeg로 로컬에서 프레임을 뽑아 모션을 검증합니다.
얻을 수 있는 결과물
- Figma 파일의 레이어에 적용된 키프레임, 애니메이션 스타일, 타임라인 변경.
- 선택 사항으로, Figma에서 내보낸 MP4 미리 보기와 내 컴퓨터에서 그 영상에서 뽑은 정지 프레임(에이전트가 모션을 검증하고 ffmpeg가 설치된 경우에만).
이럴 때 사용하세요
- 에이전트가 Figma에서 디자인에 애니메이션을 넣게 하고 싶을 때: 버튼 호버, 로딩 스피너, 카드 등장, 텍스트 등장 효과.
- 파일 전체에 재사용 가능한 애니메이션 스타일을 적용하거나 정리해야 할 때.
- Figma 프로토타입의 타이밍과 이징을 여러 레이어에서 한꺼번에 고쳐야 할 때.
이럴 때는 맞지 않습니다
- 애니메이션을 앱의 코드로 원할 때: figma-implement-motion을 쓰세요.
- 정적인 디자인 작업(도형, 컴포넌트, 변수, 레이아웃): figma-use만, 화면은 figma-generate-design을 쓰세요.
- Figma 계정에서 모션이 켜져 있지 않을 때: 스킬은 이를 우회할 수 없으며 그렇다고 알려 줍니다.
- 완전히 새로운 사용자 지정 프리셋 모듈을 처음부터 작성해야 할 때: 스킬은 그것이 범위 밖이라고 합니다.
필요한 것
- 연결되어 로그인된 원격 Figma MCP 서버. 캔버스 쓰기는 원격 서버에서만 작동합니다.
- 계정에서 켜진 Figma Motion(공개 베타)과 파일 편집 권한. 내 초안 밖에 쓰려면 Full 시트가 필요합니다. Figma에 따르면 캔버스 쓰기는 베타 기간에는 무료이며 이후 사용량 기반 유료 기능이 될 예정입니다.
- 함께 불러온 Figma의 figma-use 스킬. 3D 기울이기, 뒤집기, 원근감에는 figma-3d-transforms 스킬과 Figma의 3D API도 필요합니다.
- 선택 사항: 에이전트가 영상 내보내기에서 프레임을 뽑아 모션을 확인할 수 있도록 내 컴퓨터의 ffmpeg. 내보내기는 Figma 서버에서 렌더링되며 약 10초에서 몇 분까지 걸립니다.
스킬에 들어 있는 파일
| 파일 또는 폴더 | 용도 |
|---|---|
SKILL.md | 실행 시 사용 가능 여부 확인, 스킬을 불러올 때, 모션 API 범위, 영상 내보내기로 검증하는 방법, 모션 사전 점검 체크리스트. |
references/motion-patterns.md | 키프레임 트랙, 애니메이션 가능한 필드, 색상·효과 트랙, 애니메이션 스타일, 타임라인 길이. |
references/motion-custom-styles.md | 파일 자체의 재사용 가능한 애니메이션 스타일 찾기, 만들기, 편집, 적용, 삭제. |
references/text-animation.md | 기본 텍스트 스태거를 쓴 타자기 효과와 순차 텍스트 등장 효과. 텍스트는 편집 가능하게 유지합니다. |
references/motion-easing.md | 이징 객체, 사용자 지정 3차 곡선과 스프링 곡선, hold. |
references/3d-transforms.md | 3D 접근 권한도 필요한 기울이기, 뒤집기, 원근감 애니메이션. |
2026-11-15 기준 저장소에 있는 라이선스: No licence file; Figma Developer Terms apply.
예시 프롬프트
설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.
- 이 Figma 파일에서 기능 카드 세 개가 150 ms 간격으로 하나씩 페이드되며 위로 올라오게 해 줘. ease-out 곡선으로: <frame URL>.
- Hero 프레임의 헤드라인에 1.2초 동안 단어 단위로 나타나는 타자기 효과를 넣어 줘.
- Onboarding 페이지의 모든 배지에 우리 "Pop in" 사용자 지정 애니메이션 스타일을 적용해 줘.
- 로딩 스피너가 계속 회전하게 하고 타임라인을 2초로 늘려 줘. 짧은 미리 보기를 내보내서 확인해 줘.
figma-use-motion 설치 방법
Figma MCP 서버를 연결하고 figma-use도 설치
Claude Code에서는 Anthropic 공식 마켓플레이스의 Figma 플러그인이 원격 MCP 서버와, 이 스킬이 함께 불러오는 figma-use를 포함한 Figma의 모든 스킬을 추가합니다. 그다음 /mcp를 실행하고 Figma에 로그인하세요. 폴더를 직접 복사한다면 아래 명령어가 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 서버로 연결합니다.
/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guide내 계정에서 모션이 작동하는지 확인
큰 요청을 하기 전에 레이어 하나를 페이드 인하는 것처럼 작은 작업을 먼저 요청해 보세요. 에이전트가 모션 속성이 지원되지 않는 API(not a supported API)라고 보고하면 아직 모션이 켜져 있지 않은 것이며, 스킬의 어떤 설정으로도 바꿀 수 없습니다.
스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.
Claude Code: 플러그인 마켓플레이스에서 설치
- 터미널에서
claude로 Claude Code를 시작합니다. - 이 플러그인은 Anthropic의 공식 마켓플레이스에 있으며, Claude Code를 처음 시작할 때 자동으로 추가됩니다.
- 플러그인을 설치합니다. Claude Code가 먼저 세부 정보를 보여 줍니다. 무엇이 추가되는지(스킬, 훅, MCP 서버) 확인한 다음, 나만 쓸지, 이 저장소의 모든 사람이 쓸지, 이 저장소에서 나만 쓸지 고르세요.
/plugin install figma@claude-plugins-official - /를 입력해
/figma:figma-use-motion가 있는지 확인하거나, 그냥 작업을 요청하세요.
세션 대신 셸에서 설치하려면:
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, figma-use-figjam, 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-motion ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /figma-use-motion를 입력하거나 작업을 설명하면 됩니다.
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-motion .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 이상). |
이 단계의 출처
2026-11-14에 각 업체의 문서와 대조해 확인했습니다:
모션 체크리스트
스킬의 사전 점검 목록은 모션 스크립트에서 가장 흔한 오류를 잡아냅니다: 공개 이름 대신 내부 이징 이름 쓰기, ease-in-and-out의 잘못된 별칭, 안쪽 레이어 대신 최상위 프레임에 애니메이션 넣기, 초 대신 밀리초로 쓴 타임라인 값, 오류를 일으키는 내부 변형 필드 이름.
텍스트 애니메이션은 항상 기존 텍스트 레이어에 기본 텍스트 스태거를 써서 글자를 편집 가능하게 유지하며, 지속 시간은 글자당 시간이 아니라 스태거 전체 길이입니다.
영상 내보내기를 한 번 한 번 알차게
내보내기는 느리고 실제 렌더링 시간이 들기 때문에, 스킬은 먼저 확인할 순간(보통 단계마다 한 장씩 4~6프레임)을 고르고, 작고 낮은 프레임 레이트로 렌더링한 다음, 모든 프레임을 읽고 모든 수정을 한 번에 묶어 처리한 뒤에야 다시 렌더링합니다.
figma-use-motion에 관한 질문
figma-use-motion은 figma-implement-motion과 무엇이 다른가요?
figma-use-motion은 Figma 파일 안에서 애니메이션을 만들고 편집합니다. figma-implement-motion은 Figma에서 애니메이션을 읽어 프로젝트의 코드로 씁니다. 앞의 것으로 모션을 디자인하고, 뒤의 것으로 출시하세요.
에이전트가 모션이 지원되지 않는다고 하는 이유는 무엇인가요?
Figma Motion은 공개 베타이며, 스킬은 그 API가 모든 사용자에게 켜져 있지 않을 수 있다고 경고합니다. 사용자 지정 애니메이션 스타일과 3D 모션은 따로 쓸 수 없을 수도 있습니다. 호출이 "is not a supported API"로 실패하면, 스킬은 에이전트에게 다시 시도하지 말고 멈춰서 사용자에게 알리라고 지시합니다.
에이전트가 자신이 만든 애니메이션을 볼 수 있나요?
정지 상태만 보여 주는 스크린샷으로는 볼 수 없습니다. 모션을 확인하려면 Figma의 export_video 도구로 프레임을 작고 프레임 레이트가 낮은 MP4로 내보내고 ffmpeg로 프레임 몇 장을 뽑습니다. 내보내기는 Figma 서버에서 렌더링되며 몇 분이 걸릴 수 있으므로, 스킬은 렌더링마다 계획을 세우고 뻔한 변경에는 건너뜁니다.
figma-use가 필요한가요?
네. figma-use에는 모든 use_figma 스크립트를 위한 Plugin API 규칙이 들어 있고, figma-use-motion은 모션 전용 규칙을 더합니다. 스킬은 둘을 함께 불러오라고 안내합니다. Figma 플러그인을 설치하면 둘 다 설치됩니다.
figma-use-motion 스킬은 무료인가요?
파일은 무료로 설치할 수 있지만 오픈 소스는 아닙니다. 라이선스 파일이 없으며 Figma의 Developer Terms가 적용됩니다. Figma Motion을 쓸 수 있는 Figma 계정과, 내 초안 밖에 쓰려면 Full 시트가 필요합니다. Figma에 따르면 캔버스 쓰기는 베타 이후 사용량 기반 유료 기능이 될 예정입니다.
더 많은 AI 스킬
관련 스킬
Figma Implement Motion 스킬
공식 · FigmaFigma에서 만든 애니메이션을 코드로 바꾸는 Figma의 스킬입니다: React는 motion.dev, 다른 사이트는 CSS 키프레임으로, 타이밍과 이징 그대로.Figma Use 스킬 (use_figma)
공식 · FigmaFigma에 쓰는 모든 작업의 바탕이 되는 스킬: 에이전트가 use_figma로 파일에서 Plugin API 스크립트를 실행할 때 따르는 규칙입니다.Figma Generate Design 스킬
공식 · Figma코드를 바탕으로 디자인 시스템의 컴포넌트와 변수를 써서 Figma 파일에 화면을 만들거나 업데이트하는 Figma의 스킬입니다.썸네일 디자인 스킬
커뮤니티 · Frank Heijdenrijk내용에 충실하고 모바일에서 읽기 좋은 영상 썸네일을 기획하고 기본 비교 테스트를 계획합니다.디자인과 템플릿 스킬
커뮤니티 · Frank Heijdenrijk반복 SNS 그래픽용 재사용 브랜드 키트, 템플릿 묶음, 제작 절차를 정의합니다.인용 카드와 텍스트 그래픽 스킬
커뮤니티 · Frank Heijdenrijk출처 있는 한 줄을 고르고 인용을 꾸며내지 않는 읽기 좋은 타이포 카드를 기획합니다.