Communitygithub.com

yazzang-homelab/motion-studio

하나의 UI 요소가 변형되는 모프 필름(morph film)을 위한 6부분 XML 상태 명세서(입력, 방향, 구조, 빌드, 주의사항, 시작)를 작성합니다. 다운비트(downbeat)의 상태 전환, 커서 기반 변경, 끊김 없는 루프, 승인 게이트(approval gate)를 포함합니다. 'UI 모프', '상태 목록'에 사용합니다.

motion-studio란 무엇인가요?

**Motion Studio**는 하나의 UI 요소(버튼, 로더, 플레이어, 차트 등)가 시간에 따라 모양과 색상, 크기를 연속적으로 변화시키는 **모프 루프(morph loop) 애니메이션**을 설계하는 AI 에이전트 스킬입니다. 이 스킬은 총 6개의 섹션(XML 입력 요청, 방향, 구조, 빌드, 주의사항, 시작)으로 구성된 명세서를 작성하며, 사용자의 실제 제품 데이터와 브랜드 색상, 폰트를 사용합니다. 각 상태는 특정 다운비트에 커서 클릭으로 전환되며, 마지막 프레임이 첫 번째 프레임과 같아 무한 루프가 됩니다. 명세서 작성 후 상태 목록을 비트 그리드에 정렬하고, 사용자의 승인을 받은 후 실제 film.js 코드를 생성합니다. 지원하는 플랫폼은 Claude Code, Cursor, Codex 등이며, 최종적으로 /motion-studio:motion-reel 서브스킬을 통해 최소 3라운드의 품질 검토(비평, 루프 정합성, 커서 접촉점 확인)를 거쳐 배포합니다.

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

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

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

문서

UI 모프 명세 (코스 06단계, 레벨 L3)

상태 목록을 작성하세요, 분위기가 아닙니다. Opus 5.5 출시 주간에 가장 많이 북마크된 프롬프트는 한 줄짜리가 아니었습니다: @twoclipping의 UI 모프 루프와 @verbove의 MakerMap 영화 모두 XML 명세를 사용했으며, 입력 요청, 방향, 비트별 상태 목록, 빌드 규칙 및 주의사항이 포함되었습니다. 이들의 아이디어: 하나의 도형이 끊기지 않는 것. 단일 요소가 상태마다 크기, 반경, 색상을 변경하며(버튼, 로더, 플레이어, 차트, 명령 팔레트), 커서가 실제 클릭으로 각 변경을 일으키고, 마지막 프레임이 첫 번째와 같아 영화가 루프됩니다.

요청 인수(비어 있을 수 있음), 한 번 표시:

크레딧: 6개 섹션 구성은 @twoclipping의 공개 템플릿(https://x.com/twoclipping/status/2103273003555402193; XML은 코스에서 말한 대로 스레드 답글이 아닌 본문에 있습니다)과 @verbove의 MakerMap 명세(https://x.com/verbove/status/2103483957266268381)를 따릅니다. 이 스킬의 템플릿은 motion-studio의 자체 언어로 작성되었습니다: assets/spec-template.xml

1. 입력 요청

AskUserQuestion 한 번으로 요청합니다(하위 에이전트는 요청할 수 없음, 당신이 합니다):

입력기본값규칙
제품 + URL필수실제 UI를 캡처하고 URL이 있으면 /motion-studio:product-reel 3단계로 복사
스토리 순서대로 8~12개 상태로고, CTA, 이메일 필드, 로더, 체크, 카드, 차트, 명령 팔레트다운비트당 하나
상태당 실제 데이터요청제품의 레이블, 숫자, 이름; 플레이스홀더 없음
브랜드 색상, 글꼴, 강조색 하나캡처 또는 studio.json에서강조색 하나
트랙minimal 120 BPM 합성제공된 트랙은 이 사용을 허용하고 다운비트에서 시작해야 함
포맷9x16, 1x1, 16x9동일 타임라인, 리프레임
루프예마지막 상태가 첫 번째로 다시 모프됨

2. 명세 작성

프로젝트에 docs/spec.xml로 템플릿을 복사하고 모든 [...]를 답변으로 채웁니다. 6개 섹션 모두 유지: <inputs>, <direction>, <structure>, <build>, <gotchas>, <start>. 모션 디렉터 하위 에이전트(motion-studio:motion-director)가 브리핑에서 초안을 작성할 수 있습니다. docs/ 아래에만 작성합니다.

3. 비트 그리드에 상태 배치

  1. 프로젝트: 필요한 경우 --loop로 스캐폴드 (node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<제품> morph" --loop --duration <초> --install; 스킬 전용 설치에서는 동일한 플래그로 node "${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs" ...를 사용하거나 studio-init 스킬을 호출합니다).

  2. 그리드: node tools/score.mjs --style minimal --bpm 120 --dur <초>, 또는 제공된 트랙을 node tools/beats.mjs audio/<track>으로 측정합니다.

  3. 정확한 다운비트 시간, 루프 검사 및 경고가 포함된 상태 목록:

    node "${CLAUDE_SKILL_DIR}/scripts/statelist.mjs" --states "로고,CTA 버튼,이메일 필드,로더,체크,카드,차트,팔레트" --out docs/statelist.md
    
    플래그사용
    --states "a,b:2,c" 또는 --file list.txt순서대로 상태; :2는 상태를 두 마디 동안 유지
    --beats audio/beats.json측정된 그리드(파일이 존재할 때 기본값); --beats none 무시
    --bpm N, --beats-per-bar N그리드 재정의
    --no-loop루프 대신 종료되는 영화
    --json각 상태의 시작, 종료 및 콘텐츠 타이밍을 포함한 한 줄 JSON

    루프 길이가 studio.json의 duration과 다를 때, 첫 번째 상태가 0초에 없을 때(트랙의 픽업), 또는 상태가 1초 미만으로 유지될 때 경고합니다. 계속하기 전에 지속 시간을 수정하거나 트랙을 자릅니다.

  4. docs/statelist.md의 커서 동작, 데이터 및 사운드 열을 채우고 테이블을 docs/shotlist.md로 복사합니다.

4. 게이트

비트 그리드의 상태 목록을 보여주고 영화 코드를 작성하기 전에 사용자의 확인을 기다립니다(<start> 섹션에 명시되어 있으며 코스에도 그렇게 되어 있습니다). 거부된 목록은 코드로 우회하지 않고 다시 작성합니다. 결정을 docs/shotlist.md의 Status: 줄에 기록합니다.

5. 검증된 예제에서 빌드

assets/morph-loop.film.js를 film/film.js로 복사하고 적응시킵니다: 120 BPM에서 16초, 8상태 루프이며 모든 포맷으로 렌더링됩니다. STATES(1080px 단위 크기, 채우기 토큰), COPY 및 content 페인터를 승인된 목록과 실제 데이터로 교체합니다; 메커니즘은 유지:

메커니즘API규칙
상태 시간grid.bar(i)절대 초 사용 금지
컨테이너 크기, 반경, 색상 채널, 카메라 줌loopTrack(t, keys, dur, spring)키는 [0, duration] 범위; 이음매는 첫 번째 다운비트(이 예제) 또는 t = duration에서 한 번 변경
콘텐츠 인/아웃swapAlpha(t, start, nextStart)모프 시작 후 인, 다음 모프 전 아웃
커서x, y에 대한 loopTrack, cursor(g, x, y, { pressed })다운비트에서 현재 요소 클릭
탭 및 목록 하이라이트indicator(t, stops, { width })다른 스프링의 가장자리
사운드grid.bar 및 grid.beat의 cues누를 때 클릭, 모프 아래 스우시
그레인 및 기타 프레임 인덱스 노이즈grain(g, W, H, c.frame % LOOP_FRAMES, ...) (LOOP_FRAMES = Math.round(dur * fps))비평은 hash(0)과 hash(duration, { wrap: false })를 비교합니다; 원시 프레임 인덱스로 시드된 노이즈는 끝이 프레임 0과 달라 루프 검사에 실패합니다

모든 패턴과 그 이유: references/morph-recipes.md. studio.json에 "loop": true 및 duration을 루프 길이로 설정한 후 npm run lint를 실행합니다.

6. 비평 및 전달

/motion-studio:motion-reel에서 비평 루프를 실행합니다(최소 3라운드, 모든 축 >= 8, 미해결 P0 없음; 각 라운드는 혼합 렌더를 빌드하고 두 증명 패스를 먼저 실행합니다, 파이프라인 실행북 참조). 모프 루프의 경우 out/review/<fmt>/loop.png(라이브 패스만 해당; video/ 패스는 루프 창 없음)와 "루프 이음매" 메트릭(hash(0)이 hash(duration, { wrap: false })와 같음, 연속성 비율 <= 1.5; |end - first| 창은 검정색이어야 하며, 프레임 인덱스 그레인은 인덱스가 래핑되지 않으면 이를 깨뜨림), strip.png의 각 전환 중 레이블, contact.png의 각 다운비트에서 커서 위치를 확인합니다. 이음매 점프는 P0입니다. 그런 다음 npm run build를 실행합니다.

모프 영화 규칙

  • 하나의 컨테이너, 절대 컷 금지. 상태는 크기, 반경, 채우기 및 내용만 다릅니다.
  • 모든 변경은 커서가 일으킵니다; 상태가 스스로 변경되지 않습니다.
  • 모든 비트에서 무언가 움직입니다: 누름, 타이핑, 카운터, 선 그리기, 하이라이트 단계.
  • 실제 제품 데이터만 사용. 스프링은 최소한의 오버슈트만 허용; 타입에는 없음.
  • 금지: 바운시 이징, 글로우, UI 크롬의 그라데이션, 입자 버스트, 데드 비트.
  • 카메라가 스케일하는 모든 것에 will-change(또는 래스터화 트릭) 사용 금지.

다음: /motion-studio:springs 느낌 조정; /motion-studio:ship-formats 포맷별 리프레임 및 전달.

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

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

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'.

관련 스킬