Communitygithub.com

0n6k4v-Coder/skills

After Effects 타임라인 데이터로부터 모션 사양 주석을 생성합니다. 사용자가 '모션', '모션 사양', '애니메이션 사양', '타임라인'을 언급하거나 컴포넌트의 애니메이션 속성을 문서화하려 할 때 사용하세요.

skills란 무엇인가요?

이 스킬은 Figma에 모션 주석을 직접 생성하여, After Effects 컴포지션의 애니메이션 속성을 타임라인 바와 상세 테이블로 문서화합니다. 다른 `create-*` 스킬과 달리, 이 스킬은 Figma 컴포넌트 워크 대신 After Effects 타임라인 내보내기 JSON을 입력으로 사용하므로 사전에 컴포넌트 마크다운(.md) 파일이 필요하지 않습니다. 주로 `export-timeline.jsx` 스크립트로 내보낸 JSON 데이터를 붙여넣거나 파일로 참조하여 작동하며, Figma 링크를 선택적으로 받아 주석을 배치할 대상 페이지를 지정할 수 있습니다. 이 스킬은 figma-console 및 figma-mcp 두 가지 MCP 어댑터를 모두 지원하며, 유효성 검사, 데이터 변환, 템플릿 가져오기 및 해제, 헤더 필드 채우기, 시간 눈금자 생성, 타임라인 레이어 렌더링, 테이블 행 생성, 시각적 검증 등 14단계의 정교한 워크플로우를 통해 정확하고 일관된 모션 사양 문서를 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0n6k4v-Coder/skills/tree/HEAD/figma/uSpec/create-motion

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

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

문서

모션 스펙 생성

After Effects 컴포지션에서 모든 애니메이션 속성을 문서화하는 타임라인 바와 세부 테이블을 Figma에 직접 생성합니다.

컴포넌트 마크다운(.md) 소비자 계약 범위 밖입니다. 다른 create-* 스킬은 컴포넌트 .md({{skill:create-component-md}}로 생성됨)가 필요하며 render-meta를 기반으로 렌더링합니다. create-motion은 의도적으로 예외입니다: 입력은 After Effects 타임라인 내보내기({{ref:motion/export-timeline.jsx}})이며 Figma 컴포넌트 워크가 아닙니다. _base.json, extract-motion, .md의 모션 섹션이 없습니다. 이 스킬은 .md가 필요하지 않으며 .md 필요/빠른 실패/허용 목록 읽기 리팩터에 참여하지 않습니다.

실행 계약(먼저 읽으십시오).

  • 이 파일은 편집할 문서가 아닌 실행 지침입니다. 스킬 호출 = After Effects 타임라인 JSON에서 Figma로 모션 스펙을 렌더링합니다.
  • 이 SKILL.md 또는 다른 스킬 파일을 응답으로 편집하지 마십시오. 에디터에서 열려 있거나 포커스되어 있어도 마찬가지입니다. 사용자가 스킬 자체를 변경하도록 명시적으로 요청하는 경우에만 수정하십시오.
  • 입력 타임라인 JSON은 읽기 전용 진실 공급원입니다. 절대 편집하지 마십시오. 이 스킬이 생성하는 유일한 아티팩트는 Figma 주석입니다. Figma로 렌더링 요청을 보내고 파일 편집으로는 보내지 마십시오.
  • AskQuestion 호출, 확인 요청, 또는 입력 대기(Figma 쓰기 및 예상 출력 전 포함)를 절대 하지 마십시오. 모호한 경우 가장 방어 가능한 옵션을 선택하고 계속 진행하십시오.
  • 합법적인 중단은 두 가지뿐입니다: (a) 누락되거나 유효하지 않은 AE 타임라인 JSON(4/5단계 수집 및 검증 게이트); (b) Figma MCP 연결이 끊어진 경우 한 줄 중단.

MCP 어댑터

uspecs.config.json → mcpProvider를 읽으십시오. 이 스킬의 모든 MCP 호출에 대해 일치하는 열을 따르십시오.

작업figma-consolefigma-mcp
연결 확인figma_get_status건너뜀 — 암시적. 첫 번째 use_figma 호출이 실패하면 사용자에게 MCP 설정을 확인하도록 안내합니다.
파일로 이동URL로 figma_navigateURL에서 fileKey 추출 (figma.com/design/:fileKey/...). 이동 필요 없음.
스크린샷 촬영figma_take_screenshotfileKey + nodeId로 get_screenshot
플러그인 JS 실행code로 figma_executefileKey, code, description으로 use_figma. JS 코드는 동일 — 래퍼 변경 없음.
컴포넌트 검색figma_search_componentsquery + fileKey + includeComponents: true로 search_design_system
파일/컴포넌트 데이터 가져오기figma_get_file_data / figma_get_componentfileKey + nodeId로 get_metadata 또는 get_design_context
변수 가져오기(파일 전체)figma_get_variablesuse_figma 스크립트: return await figma.variables.getLocalVariableCollectionsAsync();
토큰 값 가져오기figma_get_token_values모드/컬렉션별 변수 값을 읽는 use_figma 스크립트
스타일 가져오기figma_get_stylesincludeStyles: true로 search_design_system, 또는 use_figma: return figma.getLocalPaintStyles();
선택 항목 가져오기figma_get_selectionuse_figma 스크립트: return figma.currentPage.selection.map(n => ({id: n.id, name: n.name, type: n.type}));

figma-mcp는 모든 호출에 fileKey가 필요합니다. 워크플로우 시작 시 사용자의 Figma URL에서 한 번 추출하십시오. 분기 URL(figma.com/design/:fileKey/branch/:branchKey/:fileName)의 경우 :branchKey를 fileKey로 사용하십시오.

figma-mcp 페이지 컨텍스트: use_figma는 모든 호출에서 figma.currentPage를 첫 번째 페이지로 재설정합니다. 이전 단계에서 getNodeByIdAsync(ID)를 통해 노드에 액세스할 때 페이지 콘텐츠가 로드되지 않을 수 있습니다. 페이지가 활성화될 때까지 findAll, findOne, characters는 TypeError로 실패합니다. getNodeByIdAsync 직후 이 페이지 로딩 블록을 삽입하십시오:

let _p = node; while (_p.parent && _p.parent.type !== 'DOCUMENT') _p = _p.parent;
if (_p.type === 'PAGE') await figma.setCurrentPageAsync(_p);

이것은 PAGE 조상까지 올라가서 콘텐츠를 로드합니다. 콘솔 MCP에는 이것이 필요하지 않습니다. figma_execute는 데스크톱 페이지 컨텍스트를 상속합니다.

예상 입력

사용자는 다음 패턴 중 하나로 이 스킬을 트리거합니다:

  • {{skill:create-motion}} + 붙여넣은 JSON(클립보드에서 {{ref:motion/export-timeline.jsx}}를 통해 내보내짐)
  • {{skill:create-motion}} + 파일 참조(예: @motion-ex.json 또는 .json 파일 경로)
  • {{skill:create-motion}} + Figma 링크(주석을 배치할 대상 페이지/파일)

필수: 내보낸 JSON 데이터 — 인라인으로 붙여넣거나 파일로 참조.

선택 사항:

  • 대상 페이지에 대한 Figma 링크(제공되지 않으면 뷰포트 중앙의 현재 페이지에 배치)
  • 애니메이션의 스크린샷 또는 녹화본
  • 애니메이션 목적에 대한 설명

워크플로우

이 체크리스트를 복사하여 진행 상황을 업데이트하십시오:

작업 진행 상황:
- [ ] 1단계: 지침 파일 읽기
- [ ] 2단계: MCP 연결 확인
- [ ] 3단계: uspecs.config.json에서 템플릿 키 읽기
- [ ] 4단계: 컨텍스트 수집(붙여넣기, 파일 참조 또는 사용자 프롬프트에서 JSON)
- [ ] 5단계: JSON 구문 분석 및 검증(segments[] 및 hasAnimatedSegments 포함)
- [ ] 6단계: 데이터 변환(미리 계산된 세그먼트 읽기, 트랙 너비, 타임라인 위치 계산)
- [ ] 7단계: 지침 파일 다시 읽기(오류 및 안티패턴, 검증 체크리스트) 및 감사
- [ ] 8단계: 모션 템플릿 가져오기 및 해제
- [ ] 9단계: 헤더 필드 채우기
- [ ] 10단계: 시간 눈금자 생성
- [ ] 11단계: 타임라인 레이어 렌더링(레이어당 하나의 figma_execute)
- [ ] 12단계: 템플릿 숨기기
- [ ] 13단계: 테이블 행 렌더링
- [ ] 14단계: 시각적 검증

1단계: 지침 읽기

agent-motion-instruction.md 읽기

2단계: MCP 연결 확인

uspecs.config.json에서 mcpProvider를 읽어 사용할 Figma MCP를 결정합니다.

figma-console인 경우:

  • figma_get_status — 데스크톱 브리지 플러그인이 활성 상태인지 확인
  • 연결 실패 시: "Figma 데스크톱을 열고 데스크톱 브리지 플러그인을 실행하십시오. 그런 다음 다시 시도하십시오."

figma-mcp인 경우:

  • 연결은 첫 번째 use_figma 호출에서 암시적으로 확인됩니다. 명시적 확인은 필요하지 않습니다.
  • 첫 번째 호출이 실패하면: "MCP 구성에서 FIGMA_API_KEY가 올바르게 설정되었는지 확인하십시오."

3단계: 템플릿 키 읽기

uspecs.config.json 파일을 읽고 다음을 추출합니다:

  • templateKeys 객체의 motionSpec 값 → MOTION_TEMPLATE_KEY로 저장

템플릿 키가 비어 있으면 사용자에게 알립니다:

모션 스펙 템플릿 키가 구성되지 않았습니다. 먼저 Figma 템플릿 라이브러리 링크와 함께 {{skill:firstrun}}을 실행하십시오.

4단계: 컨텍스트 수집

사용자가 제공한 내용을 확인합니다:

  1. JSON이 이미 제공됨(인라인으로 붙여넣거나 @motion-ex.json과 같은 파일 참조로) → 읽고 즉시 5단계로 진행합니다. 다시 묻지 마십시오.
  2. Figma 링크(대상)만 있고 JSON은 없음 → 프롬프트:

    내보낸 JSON을 붙여넣거나 .json 파일(예: @motion-ex.json)을 참조해 주십시오.

  3. 아무것도 제공되지 않음 → 프롬프트:

    export-timeline.jsx에서 내보낸 JSON을 붙여넣거나 .json 파일을 참조해 주십시오.

Figma 대상 링크가 제공된 경우 렌더링(8단계) 전에 figma_navigate를 사용하여 엽니다.

또한 사용자가 추가 컨텍스트를 위해 제공하는 선택적 스크린샷, 녹화본 또는 설명을 수락합니다.

5단계: JSON 구문 분석 및 검증

클립보드 JSON을 지침 파일의 스키마 및 검증 규칙(JSON 스키마 및 JSON 검증 규칙 섹션)에 대해 검증합니다. 검증에 실패하면 정확히 어떤 필드가 누락되었거나 잘못되었는지 사용자에게 알리고 다시 내보내도록 요청합니다.

6단계: 데이터 변환

내보내기 스크립트는 세그먼트, 값 형식 지정, 막대 레이블, 이징 레이블 및 변경 없음 필터링을 미리 계산합니다. 에이전트는 이를 직접 읽고 레이아웃 종속 값만 계산합니다.

6a. 애니메이션되지 않은 레이어 건너뛰기 — layer.hasAnimatedSegments를 확인합니다. false이면 타임라인 및 테이블에서 레이어를 생략합니다.

6b. 미리 계산된 세그먼트 읽기 — 각 속성에는 startMs, endMs, durationMs, fromValue, toValue, barLabel, easing 및 easingType이 있는 segments[] 배열이 있습니다. 이 값을 직접 사용하십시오. 수동 계산이 필요하지 않습니다.

6c. 트랙 너비 및 pxPerMs 계산 — pxPerMs는 고정 속도입니다. trackWidth는 눈금 레이블에 대한 오른쪽 패딩으로 동적입니다:

compDurationMs = composition.durationMs   // JSON에서 직접 읽기
pxPerMs = 0.64                           // 고정 속도 — 500ms 틱당 ~320px
trackWidth = max(compDurationMs * pxPerMs + 50, 1600)   // 데이터 영역 + 50px 레이블 패딩, 최소 1600

trackWidth 및 pxPerMs를 Figma 렌더링 코드에 전달합니다. pxPerMs는 trackWidth / compDurationMs에서 파생되지 않은 고정 속도(0.64)입니다. 막대 위치(barX, barWidth)는 렌더링 시 Figma 코드 내에서 계산됩니다. 에이전트는 세그먼트별 위치를 계산하지 않습니다.

렌더링 시 #track-area 및 #ruler-track을 모두 이 계산된 trackWidth로 크기 조정합니다. 상위 컨테이너는 HUG 크기 조정을 사용하며 자동으로 확장됩니다.

6d. 작곡 메타 형식 지정 — 지침 파일의 작곡 메타 규칙에 따라 형식을 지정합니다. COMPOSITION_META로 저장합니다.

7단계: 감사

지침 파일을 다시 읽고 다음에 중점을 둡니다:

  • 오류 및 안티패턴 섹션
  • 출력 전 검증 체크리스트

각 규칙에 대해 변환된 데이터를 확인합니다. 위반 사항을 수정합니다.

8단계: 템플릿 가져오기 및 해제

figma_execute를 통해 실행합니다(__MOTION_TEMPLATE_KEY__ 및 __COMPONENT_NAME__ 대체):

const TEMPLATE_KEY = '__MOTION_TEMPLATE_KEY__';

const templateComponent = await figma.importComponentByKeyAsync(TEMPLATE_KEY);
const instance = templateComponent.createInstance();
const { x, y } = figma.viewport.center;
instance.x = x - instance.width / 2;
instance.y = y - instance.height / 2;
const frame = instance.detachInstance();
frame.name = '__COMPONENT_NAME__ 모션';
figma.currentPage.selection = [frame];
figma.viewport.scrollAndZoomIntoView([frame]);
return { frameId: frame.id };

반환된 frameId를 저장하십시오 — 모든 후속 단계에 필요합니다.

9단계: 헤더 필드 채우기

figma_execute를 통해 실행합니다(__FRAME_ID__, __COMPONENT_NAME__, __COMPOSITION_META__ 대체):

const FRAME_ID = '__FRAME_ID__';

const frame = await figma.getNodeByIdAsync(FRAME_ID);
const textNodes = frame.findAll(n => n.type === 'TEXT');
const fontSet = new Set();
const fontsToLoad = [];
for (const tn of textNodes) {
  try {
    const fn = tn.fontName;
    if (fn && fn !== figma.mixed && fn.family) {
      const key = fn.family + '|' + fn.style;
      if (!fontSet.has(key)) { fontSet.add(key); fontsToLoad.push(fn); }
    }
  } catch {}
}
await Promise.all(fontsToLoad.map(f => figma.loadFontAsync(f).catch(() => {})));

const compName = frame.findOne(n => n.name === '#component-name');
if (compName) {
  const t = compName.type === 'TEXT' ? compName : compName.findOne(n => n.type === 'TEXT');
  if (t) t.characters = '__COMPONENT_NAME__';
}

const compDesc = frame.findOne(n => n.name === '#component-description');
if (compDesc) {
  const t = compDesc.type === 'TEXT' ? compDesc : compDesc.findOne(n => n.type === 'TEXT');
  if (t) t.characters = '모션 사양';
}

const compMeta = frame.findOne(n => n.name === '#composition-meta');
if (compMeta) {
  const t = compMeta.type === 'TEXT' ? compMeta : compMeta.findOne(n => n.type === 'TEXT');
  if (t) t.characters = '__COMPOSITION_META__';
}

return { success: true };

10단계: 시간 눈금자 생성

figma_execute를 통해 실행합니다. 이상적인 트랙 너비를 계산하고 #ruler-track 및 모든 #track-area 노드의 크기를 조정한 다음 각 간격에 대해 #tick을 복제합니다.

__FRAME_ID__, __COMP_DURATION_MS__(composition.durationMs에서 읽음), __TRACK_WIDTH__(6c단계에서 계산), __PX_PER_MS__(0.64로 고정)를 대체합니다:

const FRAME_ID = '__FRAME_ID__';
const COMP_DURATION_MS = __COMP_DURATION_MS__;
const TRACK_WIDTH = __TRACK_WIDTH__;
const PX_PER_MS = __PX_PER_MS__;

const frame = await figma.getNodeByIdAsync(FRAME_ID);
const rulerTrack = frame.findOne(n => n.name === '#ruler-track');
if (!rulerTrack) return { error: '#ruler-track을 찾을 수 없습니다' };

// 계산된 너비로 눈금자 트랙 크기 조정
rulerTrack.resize(TRACK_WIDTH, rulerTrack.height);

// 모든 #track-area 노드 크기 조정(레이어 템플릿 및 복제된 레이어)
const trackAreas = frame.findAll(n => n.name === '#track-area');
for (const ta of trackAreas) {
  ta.resize(TRACK_WIDTH, ta.height);
}

// 눈금자 트랙 내에서 #tick 템플릿 찾기
const tickTemplate = rulerTrack.findOne(n => n.name === '#tick');
if (!tickTemplate) return { error: '#ruler-track에서 #tick 템플릿을 찾을 수 없습니다' };

// 틱 템플릿의 텍스트 노드에서 글꼴 로드
const tickTextNodes = tickTemplate.findAll(n => n.type === 'TEXT');
for (const tn of tickTextNodes) {
  if (tn.characters.length > 0) {
    try { await figma.loadFontAsync(tn.fontName); } catch {}
  }
}

// 틱 간격: 6–12개의 틱을 목표로 함
const tickInterval = COMP_DURATION_MS <= 300 ? 50
  : COMP_DURATION_MS <= 600 ? 100
  : COMP_DURATION_MS <= 1500 ? 250
  : COMP_DURATION_MS <= 4000 ? 500
  : COMP_DURATION_MS <= 10000 ? 1000
  : 2000;

for (let ms = 0; ms <= COMP_DURATION_MS; ms += tickInterval) {
  const xPos = ms * PX_PER_MS;
  const tick = tickTemplate.clone();
  rulerTrack.appendChild(tick);
  tick.name = ms + 'ms';
  tick.visible = true;
  tick.x = xPos;

  const label = tick.findOne(n => n.type === 'TEXT');
  if (label) {
    try { await figma.loadFontAsync(label.fontName); } catch {}
    label.characters = ms + 'ms';
  }
}

tickTemplate.visible = false;
return { success: true, trackWidth: TRACK_WIDTH, tickInterval: tickInterval };

11단계: 타임라인 레이어 렌더링

시간 초과를 방지하기 위해 레이어당 하나의 figma_execute 호출을 실행합니다. 각 레이어(hasAnimatedSegments가 true인 경우)에 대해 #layer-template을 복제하고 레이어 이름을 설정한 다음 각 애니메이션 속성에 대해 #property-template을 복제하고 막대를 배치합니다.

모든 __PLACEHOLDER__ 값을 대체합니다.

…(번역을 위해 잘림)

Individual skills in this repo

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

0n6k4v-Coder/skills

Translates Figma motion and animations into production-ready application code. Use when implementing animation/motion from a Figma design — user mentions "implement this motion", "add animation from Figma", "animate this component", provides a Figma URL whose node is animated, or when `get_design_context` returns motion data or instructs you to call `get_motion_context`.

0n6k4v-Coder/skills

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.

0n6k4v-Coder/skills

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the `cacheComponents` flag, work through a flood of blocking-prerender / instant validation errors, run the `cache-components-instant-false` codemod, or decide between opting routes out with `export const instant = false` and fixing them in place.

0n6k4v-Coder/skills

Optimize a Next.js app that has `cacheComponents: true` — either the static shell on first paint, or the in-app navigation between routes. Picks the matching diagnostic loop and runs it.

0n6k4v-Coder/skills

Verify Next.js runtime behavior after editing app code. Use this skill to confirm a change actually works in a running app — not just that it compiles or type-checks. Combines /_next/mcp (Next.js's view) with agent-browser (the browser's view). Requires a running `next dev`.

관련 스킬