Communitygithub.com

Devon-AXIS/iPolloWork

Figma 모션과 애니메이션을 프로덕션 준비된 애플리케이션 코드로 변환합니다. Figma 디자인의 모션/애니메이션을 구현할 때 사용합니다.

iPolloWork란 무엇인가요?

이 스킬은 Figma의 애니메이션과 전환(트랜지션)을 실제 실행 가능한 코드(motion.dev, CSS 키프레임, 프레임워크별 라이브러리)로 변환하는 과정을 안내합니다. `get_motion_context` 도구를 권위 있는 모션 데이터 소스로 활용하여 애니메이션 노드 목록, 사전 계산된 코드 스니펫, 폴백 키프레임 데이터, 타임라인 조정 힌트를 제공합니다. `get_design_context`는 정적 레이아웃, 스타일, 에셋 정보를 제공하며, 두 도구는 공통 노드 ID를 기반으로 연결되어 애니메이션 데이터를 정적 구조에 병합하는 전체 워크플로우를 구성합니다. 이 스킬은 Figma 디자인에서 추출한 모션 데이터와 정적 디자인 컨텍스트를 병합하는 방법을 설명합니다. 각 애니메이션 노드는 정확한 nodeId 또는 fallbackNodeId를 사용하여 디자인 컨텍스트의 해당 요소에 매핑되며, 코드 스니펫이 우선 사용되고 스니펫이 없는 경우 폴백 트랙 데이터를 기반으로 코드가 생성됩니다. 복잡한 변환 처리, SVG 경로 모션, 타임라인 코호트 기반의 다중 노드 조정에 대한 구체적인 지침도 포함되어 있습니다. 이 스킬은 사용자 저장소에 모션 코드를 제공하는 것을 목표로 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/examples/plugin-packages/figma/skills/figma-implement-motion

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

모션 구현

개요

이 스킬은 Figma 애니메이션과 전환을 실행 가능한 코드(motion.dev, CSS 키프레임 또는 프레임워크별 라이브러리)로 변환하는 과정을 안내합니다.

Figma는 두 가지 도구를 통해 모션을 제공합니다:

  • get_motion_context — 권위 있는 모션 도구입니다. 완전한 애니메이션 노드 인벤토리, 미리 계산된 코드 스니펫(CSS @keyframes + motion.dev), 스니펫을 사용할 수 없는 경우의 폴백 키프레임 바인딩, 그리고 재귀적 타임라인 조정 힌트(timelineCohorts)를 반환합니다. 애니메이션 데이터와 어떤 노드 ID가 애니메이션되는지에 대한 진실 공급원(source of truth)입니다.
  • get_design_context — 디자인의 구조: 레이아웃, 크기 조정, 에셋, 스타일링, Code Connect 힌트, 스크린샷 컨텍스트, 그리고 때로는 애니메이션 요소에 대한 모션 배치 마커(data-node-id, 분할 노드의 경우 data-motion-keys / data-motion-wrapper-for / data-motion-transform-template)를 제공합니다. 애니메이션 노드를 일반 요소(div, p, span 등) 또는 모션 요소(motion.div)로 렌더링할 수 있습니다. 애니메이션 값은 인라인으로 포함하지 않습니다.

두 도구는 노드 ID로 연결되며, 이것이 전체 워크플로우입니다. get_motion_context는 어떤 노드가 애니메이션되는지 알려주고 키프레임 값, 이징, 타이밍 및 스니펫을 제공합니다. get_design_context는 해당 노드가 어떻게 보이고 어디에 위치하는지 알려줍니다. get_motion_context.nodes의 모든 노드에 대해 디자인 컨텍스트에서 일치하는 data-node-id를 찾아 모션을 해당 구조에 병합합니다. 구조적 요소가 일반 요소인 경우 motion.{tag}를 추가하거나 래핑합니다. 디자인 컨텍스트가 Figma 컴포넌트를 재사용한 경우 모션 노드에는 fallbackNodeId도 포함될 수 있습니다. 정확한 nodeId를 먼저 시도한 후에만 폴백으로 사용하십시오.

스킬 경계

  • 사용자 저장소에 모션 코드를 제공하는 것이 결과물일 때 이 스킬을 사용하십시오.
  • 사용자가 Figma 자체 내에서 애니메이션을 만들거나 편집하도록 요청하는 경우, figma-use로 전환하여 해당 스킬을 따르십시오.
  • 이 스킬은 현재 get_motion_context가 내보내는 애니메이션(스니펫과 폴백 키프레임 트랙, 프리셋으로 작성된 모션을 해당 형태로 해결한 것을 포함)을 다룹니다. 더 광범위한 대화형 변형 플로우는 코드에서 제품별 상태 처리가 여전히 필요할 수 있습니다.

전제 조건

  • Figma MCP 서버가 연결되어 있고 접근 가능해야 합니다.
  • 사용자가 제공한 Figma URL에서 파싱된 노드 ID. URL 형식: https://figma.com/design/:fileKey/:fileName?node-id=1-2 — fileKey( /design/ 다음 세그먼트)와 nodeId( node-id 쿼리 매개변수의 값, 예: 42-15)를 추출합니다.
  • 대상 코드베이스. 모션 출력 형식은 스택에 맞게 조정됩니다(프레임워크 권장 사항 참조).

도구 선택

모션 구현을 위해 두 도구를 각각 다른 역할로 사용하십시오:

상황도구이유
정적 구조, 에셋, 스타일, Code Connect 또는 시각적 레이아웃 이해get_design_context애니메이션 노드를 올바르게 배치하는 데 필요한 컴포넌트/페이지 코드 참조 및 에셋 URL을 제공합니다.
모든 노드의 애니메이션 데이터 가져오기get_motion_context모션 전용으로 제작되었으며 타이밍, 이징, 스니펫 및 키프레임에 대한 진실 공급원입니다.
노드에 모션 마커(data-motion-keys, data-motion-wrapper-for)가 있음배치를 위한 마커는 분할, get_motion_context는 값을 위한 것분할 마커는 어떤 트랙이 어떤 요소에 적용되는지 알려줍니다. 키프레임/이징/타이밍 및 애니메이션 노드 인벤토리는 get_motion_context에서 가져옵니다.

get_motion_context는 한 번의 호출로 하위 요소의 모션이 필요할 때 recursive: true(최대 500개 노드로 제한)를 허용합니다.

필수 워크플로우

1단계: 정적 디자인 컨텍스트 사용 가능 여부 확인

get_design_context(fileKey=":fileKey", nodeId="<node-id>")

이 노드에 대해 get_design_context가 이미 호출된 경우 해당 출력을 재사용하십시오. 그렇지 않은 경우 지금 정상적으로 호출하십시오.

이를 기록 구조로 사용하십시오 — 계층, 크기 조정, 스타일링, 에셋, Code Connect 힌트, 스크린샷 컨텍스트 및 포함될 수 있는 모든 모션 배치 마커(3단계). 애니메이션 노드 인벤토리 및 애니메이션 값은 get_motion_context(2단계)에서 가져옵니다.

2단계: 권위 있는 모션 데이터 가져오기

get_motion_context(fileKey=":fileKey", nodeId="<node-id>", recursive=true)

응답 형태(애니메이션 노드당 하나의 항목):

  • codeSnippets — 사전 생성된 CSS @keyframes 및 motion.dev 문자열입니다. 이것들을 직접 사용하십시오. 폴백 트랙 데이터에서 다시 생성하지 마십시오.
  • keyframeBindings — 바인딩된 키프레임 트랙. 프리셋에서 파생된 모션이 트랙 데이터로 해결된 것을 포함하며, 두 스니펫 형식이 모두 누락된 경우에만 폴백 데이터로 포함됩니다.
  • motionSummary — 애니메이션의 한 줄짜리 자연어 설명입니다. 스니펫이 없을 때만 제공됩니다(키프레임 바인딩 전용 모션 코드 생성이 CSS/motion.dev로 표현할 수 없는 경우). 있을 때 빌드에 사용하고, 스니펫이 있으면 무시하십시오.
  • fallbackNodeId — 컴포넌트화된 디자인 컨텍스트 매칭을 위한 선택적 폴백 ID입니다. nodeId가 I4005:6111;30:8005와 같은 인스턴스 한정 ID인 경우, D2R은 재사용 가능한 컴포넌트 본문을 대신 백업 컴포넌트 ID(예: 4002:3957)로 렌더링할 수 있습니다. 이 경우 fallbackNodeId는 정확한 nodeId 조회가 실패할 경우 찾을 data-node-id입니다.

재귀 응답에는 timelineCohorts도 포함됩니다. 이는 하나의 타임라인을 공유하는 노드들의 최상위 배열(노드별 아님)입니다: { rootNodeId, durationMs, loopMode: 'once' | 'loop' | 'boomerang', memberNodeIds[] }. 조정된 다중 노드 모션의 경우, durationMs(초로 변환하려면 ÷1000)와 loopMode를 사용하여 모든 memberNodeIds를 하나의 공유 수명 주기로 구동하십시오. 형제 순서에서 타이밍을 유추하지 마십시오.

LLM에 중요한 구현 세부 사항:

  • 스니펫이 존재하는 경우, 페이로드를 줄이기 위해 motionSummary, timelineDurationMs 및 transformOrigin이 생략될 수 있습니다. 스니펫에는 이미 duration + transform-origin(motion.dev duration / style={{ transformOrigin }} 또는 CSS animation / transform-origin)이 포함되어 있고 코호트에는 durationMs가 포함되어 있습니다. 누락된 필드가

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

Devin-AXIS/iPolloWork

Create deterministic animation and transitions for the active iPollo Video project.

Devin-AXIS/iPolloWork

Inspect, validate, preview, and render the active iPollo Video project with its bundled HyperFrames CLI.

Devin-AXIS/iPolloWork

Apply the core composition, timing, media, and determinism contract used by iPollo Video.

Devin-AXIS/iPolloWork

Plan visual direction, typography, pacing, audio, and composition for iPollo Video projects.

Devin-AXIS/iPolloWork

Build seek-safe keyframe animation for the active iPollo Video timeline.

Devin-AXIS/iPolloWork

Reuse approved HyperFrames blocks and components inside the active iPollo Video project.

Devin-AXIS/iPolloWork

Route video creation and editing through the active iPollo Video project and its built-in HyperFrames runtime.

Devin-AXIS/iPolloWork

Create or edit the active iPolloWork video's visual assets, installed recipes, editable composition and seek-safe motion; use for assembly or local picture/text/theme changes.

Devin-AXIS/iPolloWork

Add or revise music, sound effects and their mix in the active iPolloWork video, using authorized sources, real editable tracks and measured event cues.

Devin-AXIS/iPolloWork

Write or revise the active iPolloWork video's native STORYBOARD.md, with source coverage, content-led sequence and provisional timing; use for script-only work.

Devin-AXIS/iPolloWork

Route the active iPolloWork video request to its current storyboard, compose, voiceover or soundtrack work, preserving the client-owned delivery flow.

Devin-AXIS/iPolloWork

Add or revise scene-bound narration or speech-linked captions in the active iPolloWork video using actual voice settings, measured audio and alignment.

Devin-AXIS/iPolloWork

Create product launch and promotional videos through the active iPollo Video workflow.

Devin-AXIS/iPolloWork

Develop or update reusable visual components for iPolloWork Video, including maps, charts, rankings, diagrams, openings and endings. Use for component authoring rules, manifests, editable variables, shared data forms, inherited design themes, AI editing slots and seekable HyperFrames timelines. Not for producing a whole video, authoring a full-project template, or packaging a DeepSeek host plugin.

Devin-AXIS/iPolloWork

Motion / animation context for the `use_figma` MCP tool — animating Figma nodes via manual keyframes, animation styles, easing, and timeline duration. Load alongside figma-use whenever a task involves adding, editing, or inspecting animation on a node.

Devin-AXIS/iPolloWork

Plan and create short videos using the installed short-video-studio workspace app. Manage its creative canvas, scripts, storyboards, characters and local assets, generate images or video through connected Work channels, and hand off editable tracks to Work Video Studio.

Devin-AXIS/iPolloWork

Find, generate, process, and reuse media through the active iPollo Video session's media services.

관련 스킬