Motion Render Pro
스타일 규칙: 작성하는 모든 것(답변, 명세, 캡션, 파일)에 em 대시나 en 대시를 절대 사용하지 마세요. 대신 쉼표, 콜론, 마침표, 괄호, 또는 일반 하이픈을 사용하세요.
Claude가 코드로 제작하는 모션 비디오를 위한 스튜디오 급 렌더링 표준입니다. 기본 Claude 애니메이션(CSS 전환, linear/ease, 불투명도 페이드, 블러 없음)은 웹사이트처럼 보입니다. 이 규칙들은 영화처럼 보이게 만듭니다.
사용자의 언어로 답변하세요. 이 스킬은 RENDER 레이어입니다. 장면 계획에는 motion-story-director, 오디오에는 motion-sound-design, 참조 비디오 복사에는 motion-reverse-engineer를 사용하세요.
0. 이 스킬의 파일
| 파일 | 사용 시기 |
|---|---|
scripts/engine.mjs | 모든 렌더링: 결정론적 프레임, 서브 프레임 모션 블러, 이징, 키프레임, 비트 그리드, 카메라 스무딩, 타이핑, 글로우, 마스크 텍스트, ffmpeg 출력 |
assets/scene-template.mjs | 새 장면 파일 시작 시 |
assets/DESIGN.template.md | 프로젝트의 DESIGN.md 시작 시 |
설정 (프로젝트당 한 번)
- 프로젝트 폴더를 만들고 엔진을 복사하세요:
mkdir -p motion-tools && cp <이 스킬>/scripts/engine.mjs motion-tools/. Node가 프로젝트의node_modules를 찾을 수 있도록 프로젝트 내부에 존재해야 합니다. 복사본을 편집하지 마세요; 장면 코드는 자체 파일에 작성합니다. cd로 프로젝트로 이동한 후,npm init -y && npm i @napi-rs/canvas(사전 빌드, 시스템 종속성 없음)를 실행하세요. ffmpeg는render()를 위해 존재해야 합니다(which ffmpeg);still()은 ffmpeg 없이 작동합니다.assets/DESIGN.template.md를DESIGN.md로 복사하고 작성하세요(팔레트 헥스, 폰트, 히어로 오브젝트, 모션 어휘, 금지 목록). 그리고CLAUDE.md를 만들고 한 줄로 이를 가리키도록 하여, 세션 간에도 디자인이 유지되도록 하세요.- 폰트:
@napi-rs/canvas의GlobalFonts.registerFromPath(path, family)로 실제 폰트를 등록하세요(Google Fonts .ttf는@fontsource/*npm 패키지를 통해 다운로드하거나 사용자에게 요청). 최종 결과물에 기본 serif/sans에 의존하지 마세요.
채팅 내에서 Motion/Design 아티팩트 유형이 존재하고 사용자가 MP4 파일을 요청하지 않은 경우, 해당 아티팩트 유형이 더 나은 전달 방식일 수 있습니다; 이 스킬은 코드로 렌더링된 MP4를 위한 것입니다.
1. 6가지 불가침 규칙
- 모든 프레임은 시간의 순수 함수입니다.
draw(ctx, t)만 사용하세요. 타이머,Math.random()(rng(seed)사용), 프레임 간 상태 저장 금지. 이렇게 하면 렌더가 반복 가능하고, 프레임 정확하며, 블러 가능합니다. - 진정한 모션 블러. 각 출력 프레임 = 셔터 전체에 걸친 N개의 서브 프레임 평균(기본 180° =
shutter: 0.5). 일반 모션에는 8개의 서브 프레임, 빠른 움직임에는 16-32개 사용;subframes는t의 함수가 될 수 있어 빠른 부분에만 적용됩니다. 액체/모양 가장자리는 서브 프레임별로 평가되어 정지 시 선명하게 유지됩니다. - 오브젝트나 텍스트에 페이드 없음. 요소는 이동, 원인에서 스케일링, 한 점으로 수축, 라인 마스크(
maskedText)에서 굴러 나오기, 모양으로 드러나기, 가장자리를 지나 떠나기 등의 방식으로 등장하고 퇴장합니다. 불투명도는 빛(글로우, 후광, 블룸)과 명세가 명시적으로 요청하는 경우에만 허용됩니다. - 명명된 이징만 사용. 보이는 모든 것에 대해 절대 linear를 사용하지 마세요(일정한 회전 제외). 아래 어휘에서 선택하고 계획에 이름을 명시하세요.
- 카메라는 절대 정지하지 않고 절대 흔들리지 않습니다. 글로벌 카메라 = 키프레임의
smoothPath()(가우시안 시그마 ≈ 0.16초, ≤ 25 px/프레임); 악센트는 객체에 있으며 카메라 충격이 아닙니다. - 애니메이션 전에 스틸을 승인받으세요. 주요 순간에
still()로 2-4개의 키 프레임을 렌더링하고, 이를 보여주고, 승인을 받은 후 모션을 렌더링하세요. 렌더링 후, 동일한 타임스탬프를 다시 추출하여 체크포인트로 사용하세요.
2. 이징 어휘 (모두 E에 있음)
| 이름 | 사용 | 느낌 |
|---|---|---|
E.start | 움직임을 시작하는 객체 | 첫 움직임 프레임에서 ~35% 점프, 긴 제동 |
E.drop = bezier(.42,0,.25,1) | 낙하, 기어가기, 이동 | 가속, 7-8%/프레임 피크, ~15 프레임 제동 |
E.camera = bezier(.42,0,.36,1) | 샷 간 카메라 이동 | 이벤트 시점 또는 그 이전에 완료 |
E.spread | 웅덩이, 채움, 확장 | 최대 속도까지 가속, +10% 오버슛, 반동 |
E.push | 리스트, 스택, 컨베이어 | 속도 20u(1-u)³; 오버랩 푸시로 리스트가 멈추지 않음 |
E.spring(t, z, w) | UI 요소 착지 | 작은 오버슛(z 0.6-0.8) |
E.critical(t, w) | 로고, 코인, 프리미엄 공개 | 임계 감쇠, 오버슛 없음 |
E.sine | 호흡, 흔들림, 루프 | 대칭 인-아웃 |
pop(t, t0, fps, 1.18) | 배지, 아이콘, 체크마크 | 2-3프레임에 115-120%, 7프레임에 안정, 바운스 없음 |
지속 시간: 대부분의 입/출 이동은 7-12프레임(30fps에서 0.23-0.4초). 어떤 것도 한 프레임에 나타나거나 사라지지 않습니다.
3. 스타일별 물리 (절대 혼합 금지)
- UI / 그래픽 스타일: 팝, 오버슛, 착지 시 10-15% 스쿼시, 스프링, 액체 메타볼, 블룸하는 빛.
- 포토리얼 / 3D 스타일: 실제 중력(y = ½gt²), 모든 접촉 = 충격 + 하나의 작은 반동, 스쿼시 없음, 어떤 것도 0에서 스케일링되지 않음, 미끄러짐 없는 구름, 공기 저항이 있는 종이(펄럭임, 미끄러짐, 절대 떠다니지 않음). Blender에서는 강체/천 시뮬레이션 또는 이 공식에서 키프레임을 사용하고, Cycles + 디노이저, 180° 셔터 모션 블러, 가이드 객체에 초점을 맞춘 f/2.8 스타일 DOF로 렌더링하세요.
4. 빛, 글로우 및 타이포그래피
- 글로우 =
glow()(globalCompositeOperation 'lighter')를 사용하여 ~2.1 R까지의 가산성 후광(1.2 R에서 절반 강도, 2 R에서 사라짐). 흰색 배경에서 가산성 빛은 사라집니다; 대신 객체 뒤에 크고 채도 높은 부드러운 반점을 칠하세요. - 빛만 투명합니다. 반사 하이라이트는 왼쪽 위, 광택 객체에는 희미한 프레넬 림.
- 타이포그래피: 최대 2개 패밀리; 히어로 단어에는 디스플레이(굵은/좁은 또는 이탤릭 세리프), 보조 텍스트에는 깔끔한 산세리프. 큰 숫자는 좁은 자간. iOS/시스템 UI는 절대 타이핑되지 않습니다; 전체적으로 슬라이드하거나 롤인합니다.
- 타이핑:
typing()은 글자별 지터를 제공하고(평균의 0.55-1.45배, 공백 뒤 더 김), 각 글자는 마스크에서 2프레임에 걸쳐 올라옵니다; 캐럿은 마지막 글자 후 0.35초 동안 고체, 그 다음 부드러운 블링크(caret()). 새 글자는 악센트 색상으로 도착하여 약 6자에 걸쳐 흰색으로 식을 수 있습니다. - 숫자용 주행 거리계: 하드 마스크 아래 바퀴의 숫자, 프레임당 ≤ 0.5자리, 마지막 자리가 가장 늦게 착지합니다.
5. 구성 규칙
- 별도 지시가 없으면 1080×1920 세로; 텍스트/아이콘을 가장자리에서 ≥ 75px(또는 0.11 W) 유지; Instagram UI 영역: 상단 ~250px, 하단 ~420px, 오른쪽 ~120px.
- 히어로 요소는 프레임 안에서 크게; 가장자리 너머로 잘리는 것은 좋습니다. 시차와 디포커스가 있는 2-3개의 깊이 레이어.
- 그룹을 프레임 중심에 그리고 서로에 대해서도 중심에 맞춥니다.
- 금지 목록(기본 AI 슬롭): 이모지, 일반 파티클, 펄스 링, 점선, 아웃라인 아이콘, 발명된 로고, 모든 곳에 있는 재고 "테크" 글로우, 그려진 사람/얼굴. 명세가 요청하는 것만 허용합니다.
- 루프: 요청 시, 마지막 프레임은 프레임 0과 같아야 합니다(motion-reverse-engineer
analyze로 검증 → 첫 번째/마지막 유사도 > 0.95).
6. 작업 흐름
- 시간이 지정된 명세를 얻거나 작성합니다(motion-story-director).
assets/scene-template.mjs를scene.mjs로 복사하고 그 위에 빌드합니다: 상수(W, H, FPS, D, 팔레트),grid(bpm), 카메라smoothPath, 장면당 하나의 함수, 시간별로 디스패치하고 전환을 위해 오버랩을 처리하는draw(ctx,t).- 주요 순간에
still()(node scene.mjs --stills템플릿 사용) → 보여주기 → 승인. - 드래프트 렌더: 절반 해상도,
subframes: 1,preset: 'ultrafast'로 타이밍 확인. - 최종: 전체 해상도, 서브 프레임 8(빠른 부분 16-32), crf 16-18,
preset: 'veryfast'(최고 품질이 요청된 경우에만 'slow' 사용). - motion-sound-design으로 오디오 믹싱 및 먹싱.
- 체크포인트: 계획된 타임스탬프에서 프레임을 추출하고 스틸/참조와 비교. MP4를 사용자에게 전송합니다.
렌더 비용 가이드(1080×1920, Node, 단일 코어): 간단한 2D의 경우 서브 프레임당 ~0.05-0.15초. 15초 × 30fps × 8 서브 프레임 ≈ 3600 서브 프레임 ≈ 3-9분. 15분 이상 렌더 전에 사용자에게 경고; from/to 프레임 범위 옵션을 사용하여 청크로 렌더링하고 필요한 경우 ffmpeg로 연결하세요.
7. 최소 장면 템플릿
assets/scene-template.mjs: 배경, E.camera의 카메라 푸시, 비트 1에서 팝하고 글로우와 함께 E.drop으로 이동하는 아이콘. node scene.mjs --stills는 체크 프레임을 쓰고, node scene.mjs는 빠른 이동 중에 16개의 서브 프레임과 다른 곳에서 8개로 out.mp4를 렌더링합니다.