Communitygithub.com

motion-match

어떤 애니메이션의 참조 영상이나 GIF, 화면 녹화가 주어졌을 때 해당 움직임을 측정하고 재구축하여 일치 여부를 검증하거나, 정적 이미지로부터 클로드가 직접 부드러운 모션을 설계하도록 안내합니다. 또한 사용자 생성 콘텐츠나 AI 생성 영상을 캡션과 모션 그래픽이 있는 광고로 편집하는 데에도 사용됩니다.

motion-match란 무엇인가요?

Motion Match는 사용자가 제공한 참조 애니메이션(비디오, GIF, 화면 녹화)을 분석하여 모든 컷과 각 움직이는 요소의 시작, 지속 시간, 이징, 오버슈트, 이동, 회전, 형태 변화를 수치로 변환하는 AI 에이전트 스킬입니다. 이렇게 측정된 수치를 CSS, Web Animations API, Framer Motion, GSAP, Remotion, SwiftUI, After Effects 등 사용자가 작업 중인 도구로 재구축한 후, ±0.08초 오차 이내로 프레임 단위 비교를 통해 일치를 검증합니다. 참조 영상 없이 정적 이미지만 있는 경우 'Director 모드'와 'Story 모드'를 통해 Claude가 직접 모션을 설계하고 제작한 후 동일한 스크립트로 스무스함을 검증합니다. 또한 사용자 생성 콘텐츠나 AI 생성 영상을 광고로 편집해야 할 때는 'Edit 모드'를 사용하여 동일한 측정, Director 규칙, 리뷰 과정을 적용합니다. 이 스킬은 ffmpeg, Python 3(numpy, Pillow)이 필요하며, Director/Story 모드는 Playwright를 사용한 헤드리스 렌더링을 추가로 요구합니다. NiazMorshed2007/reanimate와 rossark0/rossark-motion-skill의 방법을 MIT 라이선스 하에 참조하였으며, 자체 스크립트를 사용합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/stazdev/motion-match/tree/HEAD/skills/motion-match

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

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

문서

Motion match: 모든 애니메이션 측정, 재구축, 동일한 움직임 증명

"이렇게 움직이게 해줘"를 숫자로 바꿉니다: 모든 컷, 그리고 각 움직이는 요소의 시작, 지속 시간, 이징, 오버슈트, 이동, 회전, 형태 변화. 이 움직임을 사용자가 작업하는 도구(CSS, Web Animations API, Framer Motion, GSAP, Remotion, SwiftUI, After Effects)에서 재구축한 후 프레임 단위로 비교하여 타이밍이 ±0.08초 이내로 일치할 때까지 반복합니다. 참조 움직임 없이 정지 이미지만 있나요? UI 진입에는 Director 모드(아래)를, 릴과 설명 영상에는 Story 모드를 사용하세요: Claude가 움직임을 설계하고, 제작한 다음 동일한 스크립트로 자체 렌더링을 측정하여 "부드러움"을 주장이 아닌 확인으로 만듭니다. 광고로 편집할 비디오 클립(UGC, AI 생성, 촬영 영상)이 있나요? Edit 모드를 사용하세요: 동일한 측정, Director 규칙 및 리뷰를 푸티지에 적용합니다. 방법은 NiazMorshed2007/reanimate 및 rossark0/rossark-motion-skill(MIT 라이선스)에서 적용하였습니다. 스크립트는 자체 제작입니다.

<skill>은 이 스킬의 폴더입니다. 작업은 현재 폴더의 ./motion-match/<name>/에 들어갑니다: ref/(참조 분석), ours/(우리 렌더링 분석), compare-N/(각 비교 라운드), spec.md.

설정 (처음 한 번)

PATH에 ffmpeg/ffprobe와 numpy 및 Pillow가 있는 Python 3이 필요합니다.

  • 확인: python3 -c "import numpy, PIL". 실패하면 해당 라이브러리가 있는 Python(기존 프로젝트 venv)을 찾고, 없으면 사용자에게 한 번 물어본 후: python3 -m venv ~/.motion-match/venv && ~/.motion-match/venv/bin/pip install numpy pillow를 실행하고 python 아래에서 ~/.motion-match/venv/bin/python을 사용하세요. 모든 스크립트는 -I와 함께 실행하세요.
  • Director 및 Story 모드는 페이지를 헤드리스로 렌더링합니다: pip install playwright && python -m playwright install chromium (한 번 물어보기). 설치할 수 없으면 대신 페이지를 화면 녹화하고 타이밍이 덜 정확하다고 말하세요.
  • 다른 설치는 없습니다. 어떤 것도 업로드되지 않습니다.

0. 범위 (측정 전 spec.md 상단에 작성)

  • 대상: 사용자가 말한 대로 정확히 파일 + 시간 범위 (+ 크롭) ("처음 3초", "버튼만").
  • 충실도: 모션 충실(기본값): 순서, 타이밍(±0.08초), 이징 패밀리, 오버슈트, 요소 크기 대비 이동, 스태거. 사용자 자신의 아트, 색상, 글꼴 및 단어. 픽셀 충실은 사용자가 요청하고 개인 연습용일 때만: 타인의 디자인, 로고, 캐릭터 및 음악은 그들의 것입니다. 복사본 게시를 돕지 마세요.
  • 대상 도구: 모션이 들어갈 도구 또는 코드 (명확하지 않으면 한 번 물어보기: 출력 형식을 결정합니다).
  • 참조 얻기: 사용자가 제공한 파일, 또는 사용자가 만든 화면 녹화(웹사이트 및 앱: 상호작용 녹화; 스킬은 사이트의 코드가 아닌 프레임에서 작동). 사용자가 특정 비디오를 요청한 경우에만 YouTube 또는 사이트에서 다운로드하여 자체 폴더에 저장하고 개인 참조 자료로 취급합니다.

1. 분석

python -I <skill>/scripts/ref_frames.py REF.mp4 --out motion-match/<name>/ref [--start S --end E --crop x:y:w:h] → 소스 fps의 모든 프레임, sheets/timing_NN.png(모든 프레임: 타이밍, 이징, 후속 동작) 및 sheets/poses.png(초당 2개: 발생 상황). 모든 시트를 읽으세요. GIF도 동일하게 작동합니다.

2. 측정

  • 컷 및 섹션: python -I <skill>/scripts/motion_compare.py motion-match/<name>/ref motion-match/<name>/ref --out motion-match/<name>/self --no-align 참조의 컷(장면 전환) 및 움직임을 시간과 함께 나열합니다. 절대 정지하지 않는 참조는 컷에서 분할됩니다.
  • 정확한 색상: python -I <skill>/scripts/track_motion.py <ref>/frames --sample X,Y --at T (전체 크기 프레임의 픽셀 좌표, 콘택트 시트 아님).
  • 각 움직이는 요소: track_motion.py <ref>/frames --name btn --colors HEX,HEX --tol 35 --region x,y,w,h [--save-masks] (또는 배경이 아닌 모든 것에 --not-bg HEX). 빛나거나 복잡한 참조에는 항상 --region과 요소 고유의 색상을 제공하고, 인쇄된 visible-frame 범위가 합리적인지 확인하세요. 프레임별로 위치(cx cy), 크기(w h), 스쿼시(aspect), 가장자리, 페이드/성장(presence), 색상 및 회전(angle)을 기록합니다.
  • 각 움직임: python -I <skill>/scripts/fit_easing.py <ref>/track_btn.json --prop cy --from A --to B (컷을 넘지 않는 하나의 움직임 창당 하나) → 시작, 끝, 지속 시간(ms 및 프레임), 이징 패밀리, 오버슈트, 안정화 시간 및 CSS, WAAPI, Framer Motion, GSAP 및 Remotion용 붙여넣기 준비 코드. 오류 ≤ 0.03이면 근접 일치; "단일 이징으로 맞지 않음"은 창을 분할하거나 포즈 체인(키프레임)임을 의미합니다.
  • 작은 움직임(2% 스쿼시, 5px 부동)은 시트에 표시되지 않지만 추적 번호에는 표시됩니다: 읽으세요.
  • 작게 페이드 인하는 텍스트는 활동 곡선의 노이즈 근처에 있습니다: 대신 track_motion으로 측정하세요.

어떤 숫자가 어떤 종류의 움직임을 측정하는지

움직임측정 방법참고
이동, 슬라이드, 부동cx, cy피팅당 하나의 축
스케일, 성장, 스쿼시w, h, aspect
페이드presence (--colors와 함께)
회전, 스핀angle (도, 시계 방향 +, 360도 초과 연속)실루엣에서; 원형은 None: 원 위의 표시를 자체 요소로 추적하고 cx/cy를 피팅합니다. n-겹 대칭 도형(정사각형: 4)은 프레임당 < 180/n도가 필요하므로 빠른 스핀은 높은 fps 소스가 필요합니다. 영역 내 다른 같은 색상의 도형이 방해합니다: --region을 좁히세요
모프 (도형 → 도형)--save-masks, 그 다음 shape_compare.py아래 참조
3D 뒤집기/카드 돌리기w (cos처럼 수축) + presence; 중간 지점에서 색상 반전뒷면은 자체 요소입니다
경로 움직임 (호, 곡선)cx 및 cy 모두, 경로를 따라 회전하면 angle도 포함각 축을 피팅; 경로 모양은 시트에 있습니다
클립/마스크 공개, 와이프x1 또는 y1 (선행 가장자리), w/h
선 그리기presence
텍스트 분할 (단어/글자별)첫 번째와 마지막 단어 추적; 스태거는 시작 간격 ÷ (개수 − 1)
카운터, 차트 막대막대: h/y0; 숫자: 시트 (눈대중)

모프. track_motion.py ... --name blob --save-masks는 모든 프레임의 실루엣을 저장합니다(중앙 정렬, 동일 면적으로 스케일 조정). 그 다음:

  • python -I <skill>/scripts/shape_compare.py <ref>/track_blob_masks.npz --from A --to B는 track_blob.json에 morph 시리즈(0 = 첫 번째 도형, 1 = 마지막)를 추가합니다. fit_easing.py ... --prop morph는 시작, 끝 및 지속 시간을 제공합니다. 모프 진행은 면적을 따르므로 타이밍은 신뢰할 수 있지만 이징 이름은 붙여넣기 할 값이 아닙니다: 사양에서, 또는 추적할 수 있는 매개변수(w, aspect, angle)에서 이징을 가져오세요.
  • 우리 것 대 참조: shape_compare.py REF_masks.npz --vs OURS_masks.npz --from A --to B [--rotate] → 도형 경로: 참조의 모든 중간 도형이 시간과 관계없이 우리 것에도 있는가 (PASS: 평균 ≤ 10%, 최악 ≤ 25% 전체 모프). 그런 다음 fit_easing.py REF_TRACK --prop morph --vs OUR_TRACK는 타이밍을 확인합니다. --rotate는 모프가 동시에 회전할 때 회전을 무시합니다(angle로 확인).

3. 모션 사양 작성 (spec.md; 모든 행이 체크 항목이 됨)

| # | 요소 | 속성 | 시작 → 끝 | 시작 s | 지속 s (프레임) | 이징 | 오버슈트 | 스태거 / 참고 | 출처 |
| 1 | card | translateY | 40 → 0 px | 0.20 | 0.60 (18) | easeOutCubic / cubic-bezier(.33,1,.68,1) | 0% | 카드당 +0.08 s | track + fit_easing |
| 2 | icon | rotate | 0 → 180 deg | 0.40 | 0.30 (9) | easeOutCubic | 0% | — | track angle + fit_easing |
| 3 | blob | morph | square → circle | 0.50 | 0.40 (12) | easeInOutCubic | — | shape path PASS | shape_compare |
| c | — | 컷 | — | 1.77, 2.33 | — | — | — | — | motion_compare self |

행에 "?"가 있으면 프레임을 아직 읽지 않았음을 의미합니다. 움직이지 않는 것도 기록하세요. 작업이 큰 경우 빌드하기 전에 사양을 사용자에게 보여주세요.

4. 빌드

사용자의 도구에서, 그들의 디자인으로. 사양에서 타이밍을 복사하고 해당 도구에 대한 피터의 출력에서 이징을 복사하세요. 레이아웃이 다를 때 요소 또는 프레임을 기준으로 거리를 매핑하세요. 포즈 체인: 부드럽고 오버슈트하지 않는 보간이 있는 키프레임; 참조가 오버슈트하고 안정화되면 스프링.

  • 회전: transform-origin을 명시적으로 설정하세요 (피벗 측정: cx, cy가 고정된 지점).
  • 모프: SVG 경로는 양 끝에 동일한 수와 종류의 명령이 필요합니다(또는 flubber / GSAP MorphSVG 사용); UI 레이아웃 모프(버튼 → 카드, 썸네일 → 페이지)는 FLIP 또는 공유 요소 전환(Framer layoutId, View Transitions API)을 사용합니다; 모서리 반경/크기 모프는 일반 CSS입니다.
  • 3D: 부모에 perspective 800–1200 px, backface-visibility: hidden, 두 면을 별도 레이어로.

5. 비교 및 수정 (2-5 라운드)

  1. 동일한 fps로 동일한 창 위에 우리 것을 렌더링하거나 화면 녹화합니다(참조와 동일한 방식으로 웹 페이지 녹화).
  2. ref_frames.py OURS.mp4 --out motion-match/<name>/ours --like motion-match/<name>/ref/frames.json (동일한 창, 크롭, fps 및 프레임 크기).
  3. motion_compare.py motion-match/<name>/ref motion-match/<name>/ours --out motion-match/<name>/compare-N → 오프셋, 모든 컷 및 시작/끝/지속 시간/피크 오류가 있는 움직임, ±0.08초 이내이면 PASS, activity.png(두 곡선) 및 sheets/compare_NN.png(참조 | 우리 것 | 차이). 매 라운드 시트를 읽으세요.
  4. 사양 행별: 같은 방식으로 우리 것을 추적한 다음 fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK → 움직임별 타이밍 PASS/FAIL, 이동 및 이징 패밀리 일치. 모프 행: shape_compare.py --vs도 함께.
  5. 증거가 가리키는 가장 작은 것을 수정하고, 다시 렌더링하고, 반복하세요. 5 라운드 후에도 여전히 실패하는 항목을 해당 숫자와 이유와 함께 보고하세요. 절대 묵묵히 허용 오차를 느슨하게 하지 마세요.
증상일반적인 원인수정
모든 것이 하나의 오프셋만큼 이동됨시작 지연 또는 트리거 대기 시간첫 번째 지연 조정
우리 것이 더 짧고 앞쪽에 치우침이징이 너무 강함(expo 대 cubic)피팅된 베지어 사용
참조는 오버슈트하지만 우리 것은 아님스프링/back 대 일반 이징측정된 오버슈트에 맞춰진 back.out / 스프링
우리 것에서 움직임이 일찍 멈춤보조 움직임 누락(드리프트, 푸시인)해당 창의 시트 확인
우리 것에 추가 움직임 또는 컷이 있음참조에서 정지된 것이 애니메이션됨제거 또는 지연
요소 번호가 점프함추적이 다른 요소를 잡음--region 좁히기, 고유한 색상 사용
회전 이동은 맞지만 우리 것이 cx/cy에서 흔들림잘못된 transform-origin측정된 정지 지점으로 피벗 이동
모프 타이밍 PASS, 도형 경로 FAIL경로가 다르게 보간됨(점 순서, 시작점)경로 점 재정렬/명령 일치; 모프 라이브러리 사용

6. 보고

충실도; 일치된 것과 사용자 자신의 것; 마지막 비교 테이블(컷 및 오류가 있는 움직임, PASS/FAIL); 요소별 행; activity.png 및 비교 시트 경로; 숫자와 이유가 포함된 모든 남은 차이점; 그리고 측정된(스크립트가 생성) 체크와 눈대중(시트를 본) 체크.

Director 모드: 정지 이미지 입력, 이에 맞게 설계된 모션

사용자가 참조 모션 없이 이미지(UI 스크린샷, 목업, 포스터, 제품 사진)를 제공하거나 Claude가 모션을 선택하도록 요청할 때 사용합니다. 작업은 평소와 같이 ./motion-match/<name>/에 들어갑니다(ours/, spec.md, check-N/). UI 진입이 아닌 비디오 조각의 경우 아래 Story 모드 내부의 단계를 따르세요.

  1. 이미지 읽기. 모든 요소(배경, 네비게이션, 헤드라인, 본문, 이미지, CTA, 카드, 아이콘)를 px 단위의 박스, 역할 및 순위와 함께 나열하세요: 하나의 초점, 그 다음 보조, 그 다음 크롬. 읽기 순서, 그룹(카드 행, 목록), 분위기(차분한/고급, 중립/제품, 장난기 있는) 및 특별한 모션을 암시하는 모든 것(토글 아이콘, 차트, 로고 마크, 곡선 경로, 뒤집을 수 있는 카드)을 기록하세요.
  2. 성격 선택 사용자가 지정하지 않으면 분위기에서 선택하세요. 옵션을 요청하면 세 가지를 모두 빌드하세요.
성격진입지속 시간이징이동스태거오버슈트
차분페이드 + 상승400–600 mseaseOutQuart / cubic-bezier(.25,1,.5,1)8–16 px60–80 ms없음
중립페이드 + 상승, 또는 스케일 .97→1250–400 mseaseOutCubic / cubic-bezier(.33,1,.68,1)12–24 px40–60 ms없음
장난기상승 + 스케일 .9→1스프링스프링 (강성 300–400, 감쇠 20–26)16–32 px50–70 ms3–8%
  1. 역할별 특수 모션 선택 (용어; 값은 시작점이며 성격에 따라 스케일됨):
모션사용처기본값
모프아이콘 토글(메뉴 ↔ 닫기, 재생 ↔ 일시정지), 카드나 시트로 확장되는 버튼, 도형 로고300–500 ms easeInOutCubic; FLIP/공유 요소를 통한 레이아웃 모프
회전토글/쉐브론 아이콘, 새로고침, 기울어진 진입아이콘 90–180° 200–300 ms easeOutCubic; 진입 −6…−10° → 0, 성격의 이징 사용; 로더 360° 선형 0.8–1.2 s 루프
3D 뒤집기 / 기울이기두 면이 있는 카드, 가격 토글, 호버 깊이뒤집기 rotateY 180° 500–700 ms easeInOutCubic; 호버 기울이기 ≤ 8°
경로 모션이동하는 것(비행기, 경로를 따라가는 점, 커서)easeInOutSine, 경로 따라 회전, 0.8–1.6 s
클립 / 마스크 공개히어로 이미지, 큰 헤드라인inset 또는 원형 클립, 500–800 ms easeOutQuart
텍스트 분할주요 헤드라인만단어 간격 40–60 ms, 글자 간격 15–30 ms; 전체 줄 ≤ 1 s
선 그리기아이콘, 서명, 차트, 밑줄stroke-dashoffset, 600–1000 ms easeInOutCubic
카운터 / 차트 성장숫자, 막대, 링숫자 800–1200 ms easeOutExpo; 막대 기준선부터, 스태거 40–60 ms
시차 / 깊이레이어드 히어로, 스크롬 장면레이어 속도 스크롤의 0.2–0.6; 지원 시 스크롤 타임라인
  1. 다음 규칙에 따라 안무:
    • 순서: 배경/컨테이너 → 초점 → 헤드라인 → 보조 → CTA. 크롬(네비게이션)은 마지막, 또는 페이지를 프레임하는 경우 첫 번째에 빠른 150 ms 페이드로.
    • 크기가 지속 시간을 결정합니다 (아이콘은 하한에 ...

관련 스킬