Figma Implement Motion 스킬
Figma에서 만든 애니메이션을 코드로 바꾸는 Figma의 스킬입니다: React는 motion.dev, 다른 사이트는 CSS 키프레임으로, 타이밍과 이징 그대로.
공식 · 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-implement-motion 스킬은 Figma에서 디자인한 애니메이션을 프로젝트의 코드로 바꾸는 Figma의 공식 에이전트 스킬입니다. 프레임이 Figma Motion 키프레임이나 애니메이션 스타일을 쓰면, 에이전트는 Figma MCP 서버의 get_motion_context 도구로 모션 데이터를, get_design_context로 레이아웃을 가져온 다음, 둘을 노드 ID로 합쳐 작동하는 motion.dev(React)나 CSS 키프레임 코드로 만듭니다.
이 스킬의 목표는 충실도입니다: Figma의 정확한 타이밍, 이징 곡선, 스프링, 변형 기준점을 유지하고, Figma가 움직인다고 한 것만 움직이며, 방문자의 동작 줄이기(reduced motion) 설정을 존중합니다. Figma 레이어가 아니라 코드를 씁니다. Figma 안에서 애니메이션을 만들거나 편집하려면 Figma의 figma-use-motion 스킬을 쓰세요. Figma Motion은 공개 베타이며, 이 스킬은 디자인의 정적인 부분을 맡는 figma-design-to-code와 자연스럽게 짝을 이룹니다.
스킬의 SKILL.md에서: Translates Figma motion and animations into production-ready application code.
하는 일
- get_design_context로 프레임의 정적 구조를 가져오고(또는 이전 호출을 재사용하고), 이어서 get_motion_context로 움직이는 모든 레이어의 모션을 재귀적으로 가져옵니다.
- 모션 응답을 움직이는 요소의 완전한 목록으로 보고, 움직이는 각 노드를 노드 ID로 디자인 코드와 맞추며, 필요한 곳에서는 일반 요소를 motion 요소로 감쌉니다.
- Figma가 제공하는 스니펫(React는 motion.dev, 그 밖에는 CSS @keyframes)을 다시 만들지 않고 그대로 쓰며, 응답에 있는 텍스트 그룹 스태거 타이밍과 공유 타임라인(한 번, 반복, 부메랑)을 적용합니다.
- 까다로운 경우도 처리합니다: 같은 레이어의 정적 회전과 애니메이션 회전, 경로 단위 SVG 애니메이션(실제 경로를 움직이도록 SVG를 인라인으로 삽입), 애니메이션 변형과 충돌하는 레이아웃 변형.
- 프로젝트가 이미 쓰는 모션 라이브러리(Framer Motion, React Spring, GSAP, anime.js)에 맞추며, SwiftUI라면 이징을 실제 SwiftUI API에 대응시킵니다.
- prefers-reduced-motion 대체 동작을 추가하고, 나머지를 하기 전에 애니메이션 하나를 처음부터 끝까지 확인하며, 내보낼 수 없는 모션은 빼 버리지 않고 TODO 주석으로 표시합니다.
얻을 수 있는 결과물
- 저장소의 애니메이션 코드: motion.dev 컴포넌트, CSS 키프레임, 또는 사용하는 모션 라이브러리에 맞춘 코드와 내려받은 에셋.
- Figma 파일은 바뀌지 않습니다.
이럴 때 사용하세요
- 디자이너가 Figma에서 컴포넌트나 화면에 애니메이션을 넣었고, 앱에도 같은 움직임이 필요할 때.
- get_design_context가 모션을 언급하거나 에이전트에게 get_motion_context를 호출하라고 할 때.
- 이징과 지속 시간을 손으로 옮겨 적으면 디자인과 딱 맞지 않아서 Figma의 정확한 값이 필요할 때.
이럴 때는 맞지 않습니다
- Figma에서 애니메이션을 만들거나 바꾸고 싶을 때: 그건 figma-use-motion입니다.
- 디자인에 Figma Motion 애니메이션이 없을 때: 정적인 화면에는 figma-design-to-code를 쓰세요(이 스킬은 없는 모션을 지어내지 않습니다).
- 애니메이션이 컴포넌트 배리언트 전환, 애니메이션 마스크, 호(arc) 경로에 의존할 때: 스킬의 참고 문서는 이것들이 아직 깔끔하게 내보내지지 않는다고 하며 동영상이나 Lottie 대안을 제안합니다.
필요한 것
- 연결되어 로그인된 Figma MCP 서버(플러그인은 원격 서버를 쓰며, get_motion_context는 데스크톱 서버에도 있습니다).
- 프레임에 Figma Motion을 쓴 Figma 파일. Figma는 Figma Motion을 모든 요금제의 공개 베타로 소개합니다. 이 스킬은 읽기만 하므로 Full 시트는 필요 없지만, 읽기 호출에는 한도가 있습니다(Starter 요금제나 View 또는 Collab 시트에서는 월 최대 20회).
- 기존 모션 라이브러리와 컴포넌트에 맞출 수 있도록 코드베이스. 모션 라이브러리가 없는 React 프로젝트에는 motion.dev(motion 패키지)를 씁니다.
- 애니메이션이 있는 프레임이나 레이어 링크.
스킬에 들어 있는 파일
| 파일 또는 폴더 | 용도 |
|---|---|
SKILL.md | 도구의 역할, 5단계 작업 흐름(구조, 모션, 병합, 적용, 검증), 겹쳐진 변형, 핵심 규칙 7가지. |
references/examples-and-anti-examples.md | 병합 예시와 실패 패턴. 예를 들어 DOM을 다시 만들거나 요소별 변형 기준점을 잃는 경우. |
references/gotchas.md | Figma 특유의 모션 버그: 중첩 그룹의 기준점, hold 이징, 사용자 지정 스프링, 색상 보간. |
references/svg-and-path-motion.md | 감싸는 요소가 아니라 SVG 경로 자체를 움직이기(선 그리기 효과, 경로 길이). |
references/framework-recommendations.md | 스택별 기본 라이브러리, SwiftUI 이징 대응표, 그리고 색종이, 파티클, 스크롤 연동 모션 등에 어떤 라이브러리가 나은지. |
references/unsupported-and-fallbacks.md | 아직 깔끔하게 내보내지지 않는 것과 동영상이나 Lottie 대안. |
references/motion-lint-rules.md | 에이전트가 반드시 알려 줘야 하는, 알려진 내보내기 제한. |
2026-11-15 기준 저장소에 있는 라이선스: No licence file; Figma Developer Terms apply.
예시 프롬프트
설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.
- 이 Figma 프레임의 애니메이션을 우리 React 앱에 motion.dev로 구현해 줘: <frame URL>.
- 이 Figma 컴포넌트의 로딩 애니메이션을 Spinner.tsx에 넣어 줘. 우리는 이미 Framer Motion을 쓰고 있어.
- Figma의 이 애니메이션 히어로 섹션을 CSS 키프레임을 쓴 일반 HTML로 만들고, prefers-reduced-motion도 지켜 줘.
- Figma의 카드 뒤집기가 우리 구현과 달라. 모션 데이터를 가져와서 Card.tsx의 이징과 타이밍을 고쳐 줘.
figma-implement-motion 설치 방법
Figma MCP 서버 연결
Claude Code에서는 Anthropic 공식 마켓플레이스의 Figma 플러그인이 원격 MCP 서버와 함께 이 스킬을 Figma의 다른 스킬과 같이 추가합니다. 그다음 /mcp를 실행하고 Figma에 로그인하세요. 이 폴더만 복사해도 됩니다. 짝 스킬은 필요 없지만, 정적 레이아웃에는 figma-design-to-code를 함께 쓰면 좋습니다.
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-guideclaude.ai 업로드나 Claude API에는 맞지 않음
이 스킬은 Figma MCP 서버의 모션 도구와 design-context 도구에 의존합니다. 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-implement-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-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-implement-motion ~/.claude/skills/Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /figma-implement-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-implement-motion .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로 이어지는 두 도구
get_design_context는 각 레이어가 어떻게 생겼고 어디에 있는지 알려 주고, get_motion_context는 어떤 레이어가 어떻게 움직이는지 알려 줍니다. 스킬의 핵심은 이 둘을 노드 ID로 맞추는 것이며, 재사용된 컴포넌트 안의 레이어에는 대체 ID를 써서 각 애니메이션이 올바른 요소에 적용되고 한 컴포넌트의 두 인스턴스도 서로 다르게 움직일 수 있게 합니다.
두 도구의 타이밍, 이징, 값이 다르면 모션 도구가 우선입니다.
값은 그대로, 코드는 깔끔하게
타이밍, 이징, 키프레임, 변형 기준점은 Figma 스니펫에서 그대로 복사합니다. 다시 만들면 사용자 지정 곡선과 스프링의 오버슈트가 사라지기 때문입니다. 그 주변 코드는 무작정 복사하지 않습니다: 여러 레이어가 지연만 다른 같은 애니메이션을 공유하면, 요소마다 같은 블록을 붙여 넣는 대신 재사용 가능한 컴포넌트나 variants 객체로 한 번만 만듭니다.
figma-implement-motion에 관한 질문
figma-implement-motion은 figma-use-motion과 무엇이 다른가요?
서로 반대쪽에서 작동합니다. figma-implement-motion은 Figma에서 애니메이션을 읽어 앱의 코드로 씁니다. figma-use-motion은 use_figma를 통해 Figma 파일 안에서 애니메이션을 만들거나 편집합니다. 보통은 figma-use-motion으로 디자인에 애니메이션을 넣고, figma-implement-motion으로 출시합니다.
어떤 애니메이션 라이브러리로 출력하나요?
Figma의 get_motion_context는 motion.dev와 CSS @keyframes 스니펫을 반환합니다. 스킬은 기본적으로 React에는 motion.dev를, 다른 웹 프로젝트에는 CSS를 쓰지만, Framer Motion, React Spring, GSAP, anime.js처럼 프로젝트가 이미 쓰는 라이브러리에 맞춥니다. SwiftUI는 CSS 스니펫을 바탕으로 변환합니다.
동작 줄이기(reduced motion)를 지원하나요?
네, 기본으로 지원합니다. 규칙에 따르면 추가하는 모든 모션은 prefers-reduced-motion에서 약해지거나 꺼져야 하며, 보통 정지 상태를 렌더링하거나 지속 시간을 거의 0으로 줄입니다.
아직 코드로 내보낼 수 없는 것은 무엇인가요?
스킬의 참고 문서에는 호(arc) 경로, 생성형 효과, 일부 경로 트림 타이밍, 컴포넌트 배리언트 전환, 애니메이션 마스크, 복잡한 불리언·벡터 네트워크 모션이 나와 있습니다. 이런 경우 동영상이나 Lottie 같은 대안을 제안하거나 사용자에게 묻습니다.
figma-implement-motion 스킬은 무료인가요?
스킬 파일은 무료로 설치할 수 있지만 오픈 소스는 아닙니다. 라이선스 파일이 없으며 Figma의 Developer Terms가 적용됩니다. Figma 계정이 필요하고, Figma 읽기 도구 호출 한도에 포함됩니다. Figma Motion 자체는 공개 베타입니다.
더 많은 AI 스킬
관련 스킬
Figma Use Motion 스킬
공식 · FigmaAI로 Figma 파일 안의 레이어에 애니메이션을 넣는 Figma의 스킬입니다: 키프레임, 애니메이션 스타일, 이징, 텍스트 등장 효과, 타임라인 길이.Figma Design to Code 스킬
공식 · FigmaFigma 프레임을 프로젝트의 코드로 바꾸는 Figma의 스킬입니다. 생성된 마크업을 붙여 넣는 대신 기존 컴포넌트와 에셋을 재사용합니다.Figma Generate Design 스킬
공식 · Figma코드를 바탕으로 디자인 시스템의 컴포넌트와 변수를 써서 Figma 파일에 화면을 만들거나 업데이트하는 Figma의 스킬입니다.썸네일 디자인 스킬
커뮤니티 · Frank Heijdenrijk내용에 충실하고 모바일에서 읽기 좋은 영상 썸네일을 기획하고 기본 비교 테스트를 계획합니다.디자인과 템플릿 스킬
커뮤니티 · Frank Heijdenrijk반복 SNS 그래픽용 재사용 브랜드 키트, 템플릿 묶음, 제작 절차를 정의합니다.인용 카드와 텍스트 그래픽 스킬
커뮤니티 · Frank Heijdenrijk출처 있는 한 줄을 고르고 인용을 꾸며내지 않는 읽기 좋은 타이포 카드를 기획합니다.