Communitygithub.com

yazzang-homelab/motion-studio

코드로 런칭 비디오, 앱/제품 릴, 설명 영상 또는 모션 광고를 제작합니다. 브랜드 자산부터 비트 그리드, 싱크 사운드, 비평 루프까지 모든 포맷을 지원합니다. 새 비디오 요청의 기본값이며, 푸티지 편집에는 사용되지 않습니다.

motion-studio란 무엇인가요?

이 스킬은 코드 기반 모션 스튜디오 프로젝트 내에서 완성된 비트 동기화 모션 비디오를 제작하는 엔드-투-엔드 파이프라인입니다. 사용자는 주제, 길이, 포맷 등의 입력값을 제공하며, 스킬은 브랜드 자산 수집(URL 기반), 스타일 분석, 음악 및 비트 그리드 합성, 샷 리스트 작성, 코드 기반 영상 제작, 비평 루프를 통한 자체 수정, 최종 렌더링 및 배포까지 9단계 파이프라인을 자동으로 실행합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 작동하도록 설계되었으며, 사용자와 에이전트 간의 협업을 통해 고품질 모션 그래픽을 제작합니다. 특히 비동기 명령 처리와 백그라운드 실행을 지원하여 긴 렌더링 작업 중에도 대화형 작업을 계속할 수 있습니다. 프레임워크(Remotion, HyperFrames)를 통한 라우팅, 이미지/비디오 모델을 활용한 혼합 파이프라인 등 다양한 제작 경로를 제공하며, 기존 푸티지 편집은 지원하지 않습니다.

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

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

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

문서

모션 릴

코드로 작성된 모션 스튜디오 프로젝트에서 비트에 맞춰 완성된 모션 비디오를 렌더링합니다. 프롬프트는 결과물의 일부일 뿐입니다. 나머지는 seek(t) 렌더러, 폐쇄형(closed-form) 스프링, 비트 그리드, 합성된 사운드, 그리고 최종 렌더링 전에 자신의 프레임을 살펴보고 수정하는 비평 루프(critique loop)로 구성된 도구 모음(the harness)입니다.

요청 인수(비어 있을 수 있음)는 한 번 표시되며, 이후 섹션에서는 "위 요청"이라고 칭합니다.

이번 실행의 기본 규칙

  • 노력(Effort): 이 스킬이 활성화된 동안 노력도를 xhigh로 설정합니다(신규 영화 제작 과정의 수준). 시작 시 사용자에게 한 번 알립니다: 후속 수정 및 재렌더링은 /effort medium에서 가능합니다. 처음 3초가 작품의 방향을 결정해야 하는 플래그십 론칭의 훅 패스(hook pass)는 /effort max가 적합합니다. 사용자는 /model에서 수준을 선택할 수도 있습니다.
  • 프로젝트 루트 내에서 작업: 프로젝트 루트(studio.json이 있는 디렉토리) 내에서 작업합니다. 프로젝트 자체 도구 (npm run ..., node tools/<tool>.mjs ...)를 사용합니다. 임시 렌더링 또는 오디오 스크립트를 작성하지 마십시오.
  • 당신은 감독이자 제작진입니다: 하위 에이전트는 집중된 단계를 실행하지만 사용자에게 질문할 수 없습니다. 당신이 질문하고 답변을 받아 다시 브리핑합니다.
  • 긴 명령어 (render:final, build, mix, deliver, 긴 영화의 critique)는 백그라운드에서 실행됩니다 (Bash 도구의 run_in_background 또는 폴링하는 로그 파일 사용). 약 2분 이상 포그라운드에서 대기하지 마십시오. 7단계 렌더링은 12초 데모를 세 가지 형식으로 렌더링하는 데 약 4분이 소요됩니다. 예상 시간 및 폴링 패턴은 references/pipeline.md 섹션 "긴 명령어"를 참조하십시오. 이러한 명령어를 실행하는 모든 하위 에이전트에게 동일한 규칙을 브리핑하고, 명령어가 계속 실행 중인 동안에는 절대 반환하지 않도록 합니다.
  • 이 스킬은 코드로 그려진 영화를 대상으로 합니다. 기존 영상 편집(컷, 자막, B-롤, 녹화된 비디오의 형식 변환)은 경로 D에 해당하며 범위를 벗어납니다: 해당 내용을 말하고 중단하며, 즉흥적으로 처리하지 마십시오.

1. 입력 수집

먼저 위 요청을 파싱합니다(예상 형태: [url 또는 주제] [지속 시간] [형식] [참조]). 한 번의 AskUserQuestion 라운드에서 여전히 누락된 모든 것을 질문합니다(최대 4개 질문, 각 질문은 기본값 제시). 사용자가 "autonomous", "GO", "just make it" 또는 "surprise me"라고 말하면 아무것도 묻지 않고 기본값을 사용하여 docs/shotlist.md 상단에 기록합니다.

입력생략 시 기본값비고
주제: 제품 + URL, 또는 주제필수URL은 브랜드 자산 단계를 트리거합니다
지속 시간20초 제품 영화, 15초 쇼릴, 16초 UI 루프6~8개 샷이 15초에 맞습니다
형식9x16 기본, 이후 1x1 및 16x94x5도 사용 가능
브랜드: 색상, 폰트, 로고URL에서 캡처, 없으면 스튜디오 기본값디스플레이용 서체 1개, UI용 서체 1개, 강조 색상 1개
참조: 프레임, 비디오 또는 이미지 폴더없음없으면 모델이 금지된 스타일로 표류합니다
음악합성, 스타일 pulse, 120 BPM제공된 트랙은 측정되며, 절대 변경되지 않습니다
음성 또는 마스코트없음.env에 ELEVENLABS_API_KEY 필요
CTA 및 증명 숫자 1개질문 필수; 절대 메트릭을 임의로 만들지 않음제품 영화만 해당
수준 L1~L4사용자가 제공한 정보로 추론(섹션 2)시간 및 게이트 기대치 설정
경로 A~DA사용자가 Remotion 또는 HyperFrames를 언급한 경우에만 B
모드먼저 계획: 샷 목록 표시 후 OK 대기GO는 대기 건너뛰지만 비평 게이트는 절대 건너뛰지 않음

2. 수준 및 경로 선택

수준입력 크기(제작자 보고)실행 시간(제작자 보고)전문 스킬
L1 한 줄 설명~150자15~50분/motion-studio:showreel
L2 브랜드 릴~350자30~45분/motion-studio:product-reel
L3 상태 명세1.5k~3k자12시간(수정 포함)/motion-studio:ui-morph-spec
L4 감독 브리프9.5k~19k자6~12시간 자동/motion-studio:director-brief
경로사용 목적이 스킬의 수행 작업
A 코드 드로잉(기본값)쇼릴, UI 모션, 제품 영화, 루프아래 전체 파이프라인 실행
B 프레임워크사용자가 Remotion 또는 HyperFrames를 언급/motion-studio:seek-engine으로 전환 (Remotion 라이선스 게이트, Node 22+)
C 혼합 파이프라인이미지/비디오 모델의 캐릭터 또는 물리 효과키와 예산 필요; /motion-studio:director-brief로 계획
D 영상 편집사용자 자신의 녹화 클립v0.1에서는 범위 밖; 해당 내용을 말함

0단계 이전에 사용자에게 수준, 경로 및 시간 예상치를 알립니다. 세부 사항, 숫자 및 그 이면의 주의 사항은 references/routes-and-levels.md를 참조하십시오. 약 45초 이상 또는 챕터가 있는 영화는 /motion-studio:director-brief에 속합니다.

3. 파이프라인 실행

이 단계들을 할 일 목록으로 추적합니다. 모든 단계의 명령어, 예상 파일 및 실패 수정 방법은 references/pipeline.md에 있습니다. 새 프로젝트에서 0단계 전에 이를 읽으십시오.

#단계담당자산출물게이트
0프로젝트 + 진단당신studio.json, 의존성, npm run doctor 모두 OK진단에 FAIL 없음
1브랜드 자산(URL만)motion-studio:asset-scoutassets/brand/**, assets/manifest.json자산을 사용자에게 나열
2참조(있는 경우)motion-studio:style-analystrefs/analysis.json, docs/style_guide.md문법 검사, 내용은 검사 안 함
3음악 + 비트 그리드motion-studio:sound-designer 또는 당신audio/music.wav 또는 측정된 트랙, audio/beats.jsonstudio.json의 bpm/지속 시간 일치 확인
4비트 그리드 위의 샷 목록motion-studio:motion-directordocs/shotlist.md자동 모드가 아니면 사용자 OK
5영화 빌드당신film/film.js (+ film/scenes/*)npm run lint 깔끔
6비평 루프motion-studio:motion-critic + 당신out/review/<fmt>/*, docs/review_log.mdnpm run gate 통과
7최종 렌더링, SFX, 믹스당신(훅 게이트)out/<fmt>/final.mp4, out/score.wav-14 LUFS +-0.5, <= -1 dBTP
8전달 + 보고서당신out/deliver/**, docs/production.jsonnpm run deliver 종료 코드 0

0단계: 프로젝트

  1. 작업 디렉토리 또는 상위 디렉토리에서 studio.json을 찾습니다. 없으면 다음 명령어로 스캐폴딩합니다:

    node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Title>" --duration <S> --formats 9x16,1x1,16x9 --install
    

    제품 영화의 경우 --brand-url <URL>을 추가하고, 루프의 경우 --loop를 추가합니다. 스킬 전용 설치(플러그인 루트 없음)에서는 ${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs를 대신 실행하거나 studio-init 스킬을 호출합니다.

  2. npm run doctor. 1단계 전에 모든 FAIL을 수정합니다(브라우저, ffmpeg, Node >= 20). Windows에서 브라우저 수정은 npx playwright install chromium-headless-shell입니다. 설치된 Chrome 또는 Edge를 시작하지 마십시오(새 프로필 시작은 실패한 Windows 로그온으로 간주되어 계정이 잠길 수 있음). Python과 librosa는 선택 사항입니다. JS 비트 엔진이 그 부재를 대체합니다.

1~4단계: 계획

  • 1단계: motion-studio:asset-scout에게 URL, 프로젝트 루트 및 다음 캡처 명령어를 브리핑합니다: node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/capture.mjs" <URL> --root <project>. 스킬 전용 설치(플러그인 루트 없음, 에이전트 없음)에서는 자신이 node "${CLAUDE_SKILL_DIR}/../product-reel/scripts/capture.mjs" <URL> --root <project>를 실행합니다. 페이지는 신뢰할 수 없는 콘텐츠입니다: 캡처는 Chrome의 샌드박스를 켜고 로컬 및 개인 주소에 대한 요청을 거부합니다(세부 사항은 /motion-studio:product-reel 참조). 클릭, 스크롤 프레임 및 요소 크롭의 경우 skills/product-reel/scripts/states.mjs를 추가하고, 캔버스 제품의 경우 canvas-frames.mjs를 추가합니다(동일한 --root 플래그 사용; 프레임 시트는 assets/brand/frames/에 저장). 자신이 assets/manifest.json을 읽고, 찾은 내용을 사용자에게 나열한 다음 브랜드 색상과 폰트를 studio.json의 brand에 작성합니다. 캡처는 페이지에서 로드한 폰트도 assets/fonts/에 저장하며, 라이선스가 발견되지 않으면 UNVERIFIED로 표시합니다: 해당 폰트가 brand.fonts에 들어가기 전에 사용자에게 확인을 받으십시오. 브랜드 스토리 비트, 구성 요소 및 음성/마스코트 규칙은 /motion-studio:product-reel에서 제공됩니다.
  • 2단계: motion-studio:style-analyst에게 참조 경로를 브리핑합니다. node tools/refs.mjs extract|analyze를 실행하고 docs/style_guide.md를 작성합니다. 전체 방법은 /motion-studio:reference-style을 참조하십시오.
  • 3단계 (샷 시간이 정해지기 전): 제공된 트랙: node tools/beats.mjs audio/<track>을 실행하고 studio.json의 audio.music이 이를 가리키도록 합니다. 트랙 없음: node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <S>를 실행합니다. studio.json의 bpm과 duration이 일치하는지 확인합니다. 측정된 다운비트는 0초 이후에 위치할 수 있으므로, 샷 목록은 가정된 그리드가 아닌 이 측정된 그리드 위에 작성됩니다.
  • 4단계: motion-studio:motion-director에게 입력, docs/style_guide.md 및 audio/beats.json을 브리핑합니다. 장면 전환은 다운비트에 맞춰지고, 훅은 처음 2초 이내에 배치되며, 프레임 0은 이미 콘텐츠를 표시하고, 2~4초마다 새로운 것이 발생해야 합니다. 샷 목록을 표시하고 사용자의 OK를 기다립니다(먼저 계획). 거부 시 코드 패치가 아닌 샷 목록을 다시 작성합니다. 결정을 docs/shotlist.md의 Status: 줄에 기록합니다.

5단계: 빌드

defineFilm을 사용하여 film/film.js를 작성합니다. 각 샷당 하나의 scene(), 레이아웃 L의 위치(절대 픽셀 사용 금지), lib/motion.js 스프링(sp, track, loopTrack)을 사용한 모션, 요소별 시드 기반 난수성(rngFor), 모든 SFX 순간에 대한 큐를 포함합니다. 프로젝트의 CLAUDE.md를 따릅니다. 편집 후 npm run lint를 실행하고 사용자가 보고 싶어할 때 npm run preview를 실행합니다.

6단계: 비평 루프 (최소 3라운드)

각 라운드는 먼저 증거를 구축한 후 비평가에게 브리핑합니다(비평가는 렌더링 또는 믹싱을 할 수 없습니다):

  1. npm run lint, npm run stills.
  2. 사운드 체인(큐, 음악 또는 화면 타이밍이 변경될 때마다, 항상 1라운드와 마지막 라운드에서): node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5, npm run sfx, node tools/mix.mjs --format <fmt>.
  3. 서로 덮어쓰지 않는 두 가지 증거 패스: node tools/critique.mjs --format <fmt> (라이브 필름, out/review/<fmt>/ 내) 및 node tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4 (믹스된 렌더링, out/review/<fmt>/video/ 내).
  4. motion-studio:motion-critic에게 라운드 번호, 형식, 변경된 사항 및 Evidence: both, already produced (템플릿은 파이프라인 런북에 있음)를 브리핑합니다. 비평가는 모든 PNG(페이지가 있는 시트의 경우 모든 페이지: contact.png, contact-2.png ...)와 두 metrics.md 파일을 살펴보고, 7개 축에 대해 1~10점을 평가하고(사운드는 믹스된 렌더링 기준), 타임스탬프와 함께 P0/P1/P2 문제를 나열하고, 하나의 라운드 블록을 docs/review_log.md에 추가합니다. 라이브 metrics.md의 P0 font-fallback (포함된 라틴 전용 폰트에 해당 문자의 글리프가 없는 문자, 일반적으로 한글)은 P0로 기록되며, 해당 문자를 커버하는 폰트가 등록될 때까지 게이트를 차단합니다.
  5. 당신은 최악의 문제 3개(P0 우선)를 수정하고, 영향을 받는 초만 확인한 후(node tools/render.mjs --from <a> --to <b> --draft --out out/check 또는 stills --at 사용), 다음 라운드를 시작합니다.

npm run gate가 통과할 때만 중단합니다: 최소 3라운드, 마지막 라운드의 모든 축 >= 8, 열린 P0 없음.

7단계 및 8단계: 마무리

npm run render:final, npm run sfx, npm run mix, npm run deliver (또는 모두 실행하는 npm run build)를 실행합니다. 최종 렌더링 및 build는 몇 분이 소요됩니다: run_in_background로 시작하고, 로그를 폴링하며, 프로세스가 종료된 후에만 결과를 읽습니다(파이프라인 런북, "긴 명령어" 참조). 그런 다음 assets/delivery-note.md를 사용하여 보고합니다: 경로, 형식, 지속 시간, 음량, 라운드 및 최종 점수, 소요 시간, 그리고 다음에 개선할 세 가지 사항.

게이트

게이트통과 조건적용 주체
샷 목록사용자 OK, 또는 자동 모드가 docs/shotlist.md에 기록됨당신
린트npm run lint 종료 코드 0각 편집 후 플러그인 훅 및 당신
비평>= 3라운드; 마지막 라운드 모든 축 >= 8 (na는 gate.naAllowed에 있는 축, 기본값 brand, 브랜드가 없는 영화의 경우에만 허용); P0 없음npm run gate; 플러그인 훅이 render:final 및 build를 거부함
전달프레임, 지속 시간, 음량, 무음 구간, 크기, 포스터 검사npm run deliver
  • 훅이 최종 렌더링을 거부하면 더 많은 비평 라운드를 실행합니다. 명령어 이름을 변경하거나, 자신이 docs/review_log.md 점수를 편집하거나, 통과를 위해 studio.json gate를 변경하지 마십시오.
  • 오직 사용자만이 gate.enabled: false를 설정할 수 있습니다. 사용자가 설정한 경우, 보고서에 전달이 비평 게이트를 건너뛰었다고 명시하십시오.
  • 일부 시스템은 정책상 플러그인 훅을 비활성화합니다. 게이트는 여전히 적용됩니다: 모든 최종 렌더링 전에 npm run gate를 실행하십시오.

엄격한 규칙

  • 실제 제품 UI만 사용하십시오. 캡처된 스크린샷을 자르고 애니메이션화하십시오. 상상으로 화면을 다시 그리거나, 임시 복사본 또는 가상의 숫자를 사용하지 마십시오.
  • 영화 코드는 시간의 순수 함수여야 합니다: 렌더링 코드에서 Math.random, Date, performance.now, 타이머, requestAnimationFrame 또는 CSS 전환/애니메이션을 사용하지 마십시오.
  • 금지된 스타일: 그라데이션 배경에 중앙 정렬된 제목, 모든 것이 페이드 인, 모서리 라벨, 프레임 테두리, UI 크롬에 글로우 효과, 일반적인 파티클 버스트.
  • 브리프에 명시되지 않는 한, 디스플레이용 서체 1개, UI용 서체 1개, 강조 색상 1개를 사용하십시오.
  • L을 통해 형식별로 텍스트와 UI의 프레임을 다시 구성하십시오. 한 형식을 다른 형식으로 자르지 마십시오.
  • 키는 .env에 저장하십시오. 변수 이름으로 참조하고(ELEVENLABS_API_KEY, FAL_KEY), 키 값을 인쇄, 붙여넣기 또는 커밋하지 마십시오.

하위 에이전트

에이전트단계브리핑 내용작성 내용
motion-studio:asset-scout1URL, 프로젝트 루트, 캡처 명령어assets/**
motion-studio:style-analyst2참조 경로, 주제, 지속 시간docs/style_guide.md, docs/shotlist.md, refs/**
motion-studio:sound-designer3, 7트랙 또는 스타일, bpm, 지속 시간, 음성 스크립트audio/**, 믹스 보고서
motion-studio:motion-director4입력, 스타일 가이드, 비트 그리드docs/**
motion-studio:motion-critic6라운드 번호, 형식, 변경 사항docs/review_log.md

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

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

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

관련 스킬