Communitygithub.com

yazzang-homelab/motion-studio

폐쇄형 스프링 공식을 사용해 물리적인 느낌의 모션을 구현합니다. 프리셋, springFromFeel, track(), loopTrack, 인디케이터, 텍스트 교체 등을 지원하며 'feels linear', 'add bounce', 'easing to springs'에 활용됩니다.

motion-studio란 무엇인가요?

motion-studio는 물리 기반 모션을 구현하기 위한 JavaScript 스킬로, 폐쇄형 스프링(closed-form spring) 응답을 사용하여 시간에 따른 순수 함수로 동작합니다. 즉, 'frame 812'를 렌더링할 때 0부터 811까지의 프레임을 시뮬레이션할 필요 없이 즉시 계산되며, seek(t)는 항상 결정론적(deterministic)입니다. 이 스킬은 `lib/motion.js`에서 가져와 사용하며, 파일 경로는 `film/film.js`에서 `../lib/motion.js`, `film/scenes/*.js`에서 `../../lib/motion.js`와 같이 상대 경로로 설정됩니다. 주요 API로는 `sp(t, preset)`, `spring(t, k, d, m)`, `track(t, keys, spring)`, `loopTrack(t, keys, dur, spring, cycles)`, `indicator(t, stops, options)`, `swapAlpha(t, tIn, tOut, options)`, `stagger(i, step)`, `settleTime(spring, eps)` 등이 있습니다. 프리셋으로는 `snappy`(버튼, 토글), `default`(카드, 컨테이너, 카메라), `heavy`(큰 텍스트, 3D 객체, 로고), `playful`(마스코트, 스티커)을 제공하며, 각각 감쇠비, 오버슈트, 정착 시간이 다릅니다. House rule은 UI에는 미세한 오버슈트(snappy), 텍스트에는 오버슈트 없음(default/heavy), playful은 오버슈트가 개그 요소인 경우에만 사용합니다. 이 스킬은 Claude Code 환경에서 사용되며, 영화/애니메이션 프로젝트에서 물리적 모션을 구현하는 데 최적화되어 있습니다.

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

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

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

문서

스프링 (코스 스텝 08)

고정 곡선 위에서 A에서 B로 가는 저렴한 모션 이징. 질량을 가진 모션은 가속되고, 약간 오버슈트한 후 안정됩니다. lib/motion.js의 스프링은 폐쇄형(closed-form) 스텝 응답이므로 순수한 시간 함수로 유지됩니다. 즉, 812번 프레임을 렌더링할 때 0번부터 811번 프레임을 시뮬레이션할 필요가 없으며, seek(t)는 결정론적입니다.

영화 프로젝트의 lib/motion.js에서 가져옵니다 (파일 기준 상대 경로: film/film.js에서는 ../lib/motion.js, film/scenes/*.js에서는 ../../lib/motion.js). 전체 프리셋 번호는 ${CLAUDE_SKILL_DIR}/references/presets.md에 있습니다 (references/presets.md).

1. API

함수반환값설명
sp(t, preset = 'default')0 ~ 1일상적인 호출; t는 릴리스 이후 시간(lt - 0.2), 릴리스 전에는 0
spring(t, k, d, m = 1) / springVel(...) / springPV(...)x / v / [x, v]원시 k/d 형태; 부족 감쇠, 임계 감쇠, 과감쇠 정확히 처리
SPRINGS{ snappy, default, heavy, playful }{k, d} 쌍, 아래 표 참조
resolveSpring(p){k, d}프리셋 이름, {k, d} 또는 {duration, bounce}를 받아 스프링이 필요한 모든 곳에서 사용
springFromFeel({ duration, bounce }) / feelFromSpring({k, d}){k, d} / {duration, bounce}디자이너 친화적인 매개변수 (Apple 규칙)
track(t, keys, spring = 'default') / trackVel(...)값 / 속도keys = [[time, value], ...] 정렬됨; 변경당 하나의 스프링, 합산됨; 세 번째 요소로 해당 변경의 스프링을 재정의 가능 ([2.4, 420, 'heavy'])
loopTrack(t, keys, dur, spring = 'default', cycles = null)값매끄러운 루프. 키 시간은 한 주기 0..dur 내에 있으며 감싸지지 않음 (범위 밖은 오류 발생). 마지막 값은 첫 번째 값과 같아야 함. 정확히 dur에 있는 키는 이음매 변경 지점
indicator(t, stops, { width = 120, lead = 'snappy', trail = {k: 140, d: 22} }){ left, right }늘어나는 탭 표시기: 가장자리가 다른 스프링 위에 있음
swapAlpha(t, tIn, tOut, { inDelay = 0.08, inDur = 0.12, outLead = 0.1, outDur = 0.1 })0 ~ 1모핑 박스 내부의 텍스트: 형태 변화가 시작된 후에 나타나고, 다음 형태 변화 전에 사라짐
stagger(i, step = 0.03)초항목 i의 지연 시간
stepTime(t, rate = 12)계단식 t"2프레임 단위" 애니메이션용, 카메라나 전체 페이드에는 사용하지 않음. c.frameLt (또는 c.frameT) 전달, 출력 프레임 시간, 스텝 사이의 하드 컷용; c.t / lt는 서브프레임 시간이며 스텝이 변경되는 프레임에서 두 스텝을 혼합
loopT(t, dur)t가 [0, dur)로 감싸짐시간 감싸기; 스프링에 단독으로는 충분하지 않음 (loopTrack 사용)
settleTime(spring, eps = 0.01) / overshoot(spring)초 / 비율홀드 및 컷 포인트 계획
easeOutCubic, easeInOutCubic0 ~ 1비물리적 페이드(불투명도)에만 사용; 움직이는 요소에는 절대 사용하지 않음

2. 프리셋

프리셋k / d감쇠비오버슈트안정화 시간 (1%)용도
snappy320 / 300.8390.79%0.24 초버튼, 토글, 선행 가장자리, 커서
default170 / 260.99700.51 초카드, 컨테이너, 카메라
heavy90 / 201.05400.78 초큰 글자, 3D 객체, 로고 락업
playful220 / 140.47218.6%0.59 초마스코트, 스티커

하우스 룰: UI에는 약간의 오버슈트 (snappy), 텍스트에는 오버슈트 없음 (default 또는 heavy를 히어로 텍스트의 크기와 위치에 사용), playful은 오버슈트 자체가 개그인 경우에만 사용. 전체 숫자, 느낌 변환 및 공식: references/presets.md.

3. 레시피

씬 draw(g, lt, c) 내부: lt는 씬이 시작된 이후 시간, c.t는 필름 시간, c.L은 레이아웃, c.brand는 브랜드 토큰, c.grid는 비트 그리드, c.film.dur은 필름 길이 (c.dur는 씬 길이). 모션 블러가 켜져 있으면 c.t와 lt는 칠해지는 서브프레임 시간 (모션 블러 자체); c.frameT / c.frameLt는 출력 프레임의 시간이고 c.frame은 그 인덱스이며, 모든 서브프레임에 대해 동일합니다. 스니펫은 const { t, L } = c;와 lib/motion.js, lib/draw.js 및 lib/rng.js의 임포트를 가정합니다.

원샷 진입 (씬 시작 후 0.15초에 릴리스):

const s = sp(lt - 0.15, 'snappy');
withTransform(g, { x: L.cx, y: lerp(L.cy + 80 * L.u, L.cy, s), s: lerp(0.92, 1, s) }, () => { /* 그리기 */ });

이 코드는 처음부터 보입니다: 스프링이 0인 동안 위치와 크기가 시작 값에 있으므로 프레임 0이 비어 있지 않습니다. 만약 s가 불투명도나 클립을 통해 화면의 유일한 것을 구동한다면 비어 있을 것입니다. 프레임 0에서 화면에 표시되는 씬(후크)의 경우, 씬 이전에 스프링을 릴리스하여 중간 동작부터 시작합니다: sp(lt + 0.3, 'snappy'), 또는 kinetic(g, '움직여라.', x, y, lt + 0.3, { ... }), 또는 kinetic(..., { delay: -0.3 }). lt = 0에서 텍스트는 그려지지 않는 대신 상승 시작 후 0.3초 지점에 있습니다 (kinetic은 스프링이 여전히 0인 모든 글리프를 건너skip). 크리틱은 빈 프레임 0을 P0으로 플래그합니다 (frame 0 is nearly empty).

여러 대상을 가진 값 (스프링을 다시 시작하지 마세요; 변경당 하나씩 추가):

// 논리적 px 단위의 커서 x: 200에서 정지, 1.0초와 2.4초에 이동, 3.6초에 복귀
const cx = track(t, [[0, 200 * L.u], [1.0, 640 * L.u], [2.4, 420 * L.u], [3.6, 200 * L.u]], 'snappy');

첫 번째 키의 시간은 무시됩니다: 해당 값은 시작부터의 정지 값입니다. 그 이후의 모든 변경은 자체 시간에 자체 스프링을 시작하며, 마지막 스프링이 안정되기 전에 새 대상이 도착하더라도 합계는 위치와 속도에서 연속성을 유지합니다.

원샷 형태 변화 (컨테이너는 절대 끊기지 않음; 모든 속성은 동일한 키 시간의 트랙):

const K = [0, 1, 2, 3].map((n) => c.grid.bar(n));       // 그리드에서 다운비트의 상태 변경
const w = track(t, [[K[0], 320], [K[1], 120], [K[2], 760], [K[3], 320]].map(([k, v]) => [k, v * L.u]));
const h = track(t, [[K[0], 96], [K[1], 120], [K[2], 480], [K[3], 96]].map(([k, v]) => [k, v * L.u]));
const r = track(t, [[K[0], 48], [K[1], 60], [K[2], 32], [K[3], 48]].map(([k, v]) => [k, v * L.u]));
fillRoundRect(g, L.cx - w / 2, L.cy - h / 2, w, h, Math.max(0, r), c.brand.colors.fg);
withAlpha(g, swapAlpha(t, K[1], K[2]), () => ring(g, L.cx, L.cy, 36 * L.u, sp(t - K[1] - 0.1), { color: c.brand.colors.accent }));

색상: 0-to-1 진행률을 스프링하고 lib/draw.js의 mixColor(a, b, p)와 혼합 (p를 클램프함). 또는 여러 대상을 가진 색상의 경우 각 채널을 트랙하고 0~255로 클램프합니다. 0 미만으로 오버슈트할 수 있는 반경 및 크기는 Math.max(0, ...)가 필요합니다.

스탑 사이를 늘어나는 탭 표시기:

const { left, right } = indicator(t, [[0, x0], [1.5, x1], [3.0, x2]], { width: 140 * L.u });
fillRoundRect(g, left, y, right - left, 6 * L.u, 3 * L.u, c.brand.colors.accent);

매끄러운 루프 (값과 속도가 이음매에서 일치):

// 6초 루프: a에서 정지, 1.5초에 b, 3초에 c2, 4.5초에 a로 복귀
const x = loopTrack(t, [[0, a], [1.5, b], [3, c2], [4.5, a]], c.film.dur, 'default');
// 복귀를 이음매 변경으로 하는 동일한 루프: 마지막 키가 정확히 dur에 위치
const y = loopTrack(t, [[0, a], [1.5, b], [3, c2], [c.film.dur, a]], c.film.dur, 'default');

loopTrack 규칙 (lib/motion.js에 대해 확인됨):

규칙세부사항
키 시간은 0..dur 내에 유지주기 상대적이며 절대 감싸지지 않음; 범위 밖의 시간은 loopTrack: key <i> time <t> is outside 0..<dur> 오류 발생 (그리드 산술에서 dur을 약간 초과하는 것은 허용됨)
첫 번째 키는 정지 값해당 시간은 무시됨 (여전히 0..dur 내에 있어야 함); 값은 첫 번째 변경이 시작되는 값
마지막 값은 첫 번째 값과 같음그렇지 않으면 the last value (...) must equal the first (...) 오류 발생
dur에 있는 키는 이음매 변경스프링은 다음 주기의 t = 0에서 시작: 프레임 0 (= 프레임 dur)은 이음매 이전 값을 표시하고 첫 번째 값으로 이징됩니다. [[0, pre], [0, post], ...]를 작성하는 것과 같음. 이음매 변경을 0 또는 dur에 한 번만 작성
dur 직전의 변경은 프레임 0에서 여전히 움직일 수 있음합계는 정확히 주기적이므로 타이밍에 관계없이 위치와 속도가 이음매에서 일치합니다. 정지 프레임에서 열려면 마지막 변경을 dur보다 최소 settleTime(preset) 이전에 유지 (기본값의 경우 0.51초)
주기(cycles)합산된 이전 주기의 수는 안정화 시간과 최신 키를 따르므로 늦은 키도 안전함; cycles는 이를 재정의

일반 loopT와 track은 끝 근처에서 해제된 스프링이 t = 0에서 여전히 움직이기 때문에 이음매에서 점프합니다. loopTrack은 또한 이전 주기의 스프링을 합산하며 (안정화에 충분한 양) 키가 [[0, 0], [2, 100], [4, 40], [6, 0]]이고 dur이 6인 경우 t = 1 / 3 / 5에서 값 0.001 / 99.997 / 40.002를 제공합니다. npm run critique 후 out/review/<fmt>/loop.png에서 이음매를 확인하세요: |last - first|는 일반적인 한 단계처럼 보여야 하고 |end - first| (감싸지지 않은 최종 상태)는 검은색이어야 합니다.

지연 팝 (요소별 시드, 절대 공유 스트림 없음):

for (let i = 0; i < n; i++) {
  const r = rngFor('tile', i);
  const s = sp(lt - stagger(i, 0.035) - range(r, 0, 0.06), 'playful');
  // 타일 i를 s로 스케일링하여 그리기
}

키네틱 타입: kinetic(g, str, x, y, lt, { size, family, weight, color, spring: 'snappy', stagger: 0.035, rise: 0.6, by: 'char' | 'word', mask, delay, alpha, align, baseline, style, tracking }). family는 기본적으로 brand.fonts.display로 설정되고 weight는 패밀리가 등록한 가장 가까운 weight로 설정되므로, 디자인에 다른 얼굴이 필요하지 않으면 둘 다 생략하세요. mask: true는 실행을 라인 상자로 클리핑하여 글리프가 페이드 대신 가장자리 뒤에서 떠오르도록 합니다; delay는 전체 실행을 이동시킵니다 (음수는 중간 동작에서 시작). 히어로 타입의 경우, 상승이 0.8% 오버슈트를 볼 수 있을 만큼 클 때는 spring: 'default' 또는 'heavy'를 전달하세요. 여러 줄 복사: wrapText(g, text, maxW, font(size, family))는 줄을 반환합니다 (한글 음절 내부에서 절단하지 않음); y + i * 1.2 * size 이상으로 그리고 각 줄에 자체 delay를 부여하여 그립니다.

2프레임 단위 드로잉 (손으로 그린 느낌): const td = stepTime(c.frameLt, 12) (출력 프레임 시간, 모션 블러가 켜져 있어도 각 단계가 하드 컷); 카메라 이동, 페이드 및 UI는 연속적인 lt로 유지하거나, 팬은 초당 12번 스텝하여 지연으로 읽힙니다.

4. 전체 영화 리팩터링

프로젝트의 프롬프트 템플릿을 사용하세요: prompts/refactor-springs.txt를 읽고 따르세요 (또는 작업으로 붙여넣으세요). 이 템플릿은 무언가를 움직이는 모든 선형 보간 및 기본 이징을 프리셋, track(), loopTrack(), indicator() 및 swapAlpha()로 대체하고, 타이밍을 유지하며 각 변경 사항을 보고합니다. 그런 다음:

  1. npm run lint (오류 없어야 함).
  2. npm run stills 및 node tools/critique.mjs --strip-at <t>를 가장 바쁜 순간에 실행: strip.png는 12개의 연속 프레임을 보여주며, 콘택트 시트가 숨기는 팝, 재시작 및 슬라이드를 노출합니다.
  3. 다음 크리틱 라운드 (/motion-studio:critique-loop)에서 변경 사항을 기록합니다.

5. 잡아야 할 실수

실수어떻게 보이는가수정 방법
각 대상에서 스프링 다시 시작 (sp(t - tNew)를 이전 값에서 사용)속도가 0으로 스냅, 눈에 띄는 꺾임track()에 모든 대상 포함
자체 시작 값을 가진 스프링을 수동으로 합산두 변경이 겹칠 때 점프값당 하나의 track(); 변경별 프리셋은 키의 세 번째 요소에 입력
스프링 값에 loopT 단독 사용이음매에서 점프키가 0..dur 내에 있고 마지막 값 == 첫 번째 값인 loopTrack() 사용
텍스트에 오버슈트텍스트 흔들림, 저렴해 보임텍스트에는 default / heavy 사용
UI 크롬에 playful 사용장난감 같은 인터페이스UI에는 snappy 사용
위치는 선형인데 불투명도에만 스프링 적용페이드는 좋지만 슬라이드는 저렴해 보임위치를 스프링; 불투명도는 easeOutCubic을 따를 수 있음
모든 것이 동일한 프리셋과 지연 시간 사용기계적, 계층 구조 없음snappy로 선도하고, default로 후행하며, 나머지는 stagger() 처리

다음: /motion-studio:sound-design으로 모션을 비트에 고정, 그런 다음 /motion-studio:critique-loop.

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

관련 스킬