Communitygithub.com

yazzang-homelab/motion-studio

하나의 타임라인에서 모든 포맷을 내보내고 패키징합니다: layout() 리프레이밍(크롭 금지), 모든 포맷 렌더링, 포맷별 검사, deliver.mjs, 브랜드 스킬, 서비스 제안. '9:16과 16:9 내보내기', '전달', '스킬 만들기'에 사용합니다.

motion-studio란 무엇인가요?

motion-studio는 하나의 타임라인에서 여러 포맷(9:16, 1:1, 16:9, 4:5)으로 동시에 내보낼 수 있도록 설계된 AI 에이전트 스킬입니다. 크롭 대신 레이아웃 기반 리프레이밍을 사용하여 모든 포맷에서 동일한 순간이 같은 시간에 발생하도록 보장하며, 각 포맷에 맞게 타이포그래피와 UI가 자동으로 배치됩니다. 이 스킬은 Claude Code 환경에서 실행되며, 포맷별 검토, 최종 렌더링, 오디오 믹싱, 전달 파일 생성의 전체 파이프라인을 제공합니다. 특히 deliver.mjs는 프레임 수, 지속 시간, 오디오 음량, 파일 크기 등 여러 검사를 수행하여 내보내기 전에 오류를 조기에 발견합니다. 또한 이 스킬은 사용자가 자신의 브랜드 스킬을 생성하고 선택적으로 서비스로 전환할 수 있는 템플릿을 제공하여, 동영상 제작을 단순한 문장 하나로 실행할 수 있게 만듭니다.

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

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

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

문서

포맷, 스킬 및 서비스 출하하기 (코스 12단계)

세 가지 동작으로 좋은 클립을 반복 가능한 비즈니스로 전환하세요: 하나의 타임라인에서 모든 포맷을 내보내고, 파이프라인을 스킬로 패키징하여 다음 동영상이 한 문장으로 실행되도록 하며, 사용자가 원할 경우 판매합니다. 영화 프로젝트 루트에서 작업하세요. 인수는 한 번만 표시됩니다:

이 스킬의 파일은 ${CLAUDE_SKILL_DIR}에 있습니다 (템플릿은 assets/).

1. 포맷별 리프레이밍, 크롭 금지

씬은 레이아웃 L(ctx.L 팩토리, c.L 드로우)에 대해 그려지므로, 하나의 타임라인이 9:16, 1:1, 16:9(및 4:5)를 각 형태에 맞게 타이포그래피와 UI를 배치하여 렌더링합니다.

포맷크기레이블
9x161080x1920Reels, TikTok, Shorts
1x11080x1080X / 피드
16x91920x1080YouTube, 사이트
4x51080x1350피드 세로
도구사용법
L.u크기 단위: 1080px 짧은 변 기준 1; 120 * L.u는 모든 포맷에서 같은 크기로 읽힘
L.Sstudio.json safe[fmt]의 안전 영역 {x, y, w, h} (플랫폼 UI 여백)
L.pos(ax, ay)안전 영역 내부의 점, ax, ay는 0~1
L.pick({ '9x16': a, '1x1': b, '16x9': c, portrait, landscape, square, default })포맷별 값: 정확한 키, 그다음 방향, 그다음 기본값
L.split('auto', ratio, gap)두 영역: 세로 및 정사각형에서는 세로로 쌓고, 가로에서는 나란히 배치
L.cols(n, gap) / L.rows(n, gap)안전 영역 내부의 열 또는 행
fitFontSize(g, text, maxW, (s) => font(s, family, weight), lo, hi, { tracking, step })너비에 맞는 가장 큰 글꼴 크기 (lib/layout.js + lib/draw.js); 비트맵 폰트의 경우 step: 16
wrapText(g, text, maxW, font(size, family), { maxLines, ellipsis })여러 줄 복사를 위한 줄 바꿈, 한글 음절 내에서 절대 자르지 않음 (lib/draw.js)
draw(g, lt, c) {
  const { L, brand } = c;
  const { a, b } = L.split('auto', L.pick({ landscape: 0.45, default: 0.4 }), 32 * L.u);   // 제목 | 제품
  const size = Math.min(L.pick({ '9x16': 170, '1x1': 140, '16x9': 150 }) * L.u,
                        fitFontSize(g, 'MAKE IT MOVE.', a.w, (s) => font(s, brand.fonts.display, 400)));
  kinetic(g, 'MAKE IT MOVE.', a.x, a.y + a.h * 0.6, lt, { size, family: brand.fonts.display, weight: 400, color: brand.colors.fg, spring: 'default' });
  drawProduct(g, b, lt, c);                                         // 제품 UI가 모든 포맷에서 영역 b를 채움
}

규칙: 리터럴 픽셀 사용 금지; 주요 콘텐츠는 L.S 내부에 배치; 동일한 순간이 모든 포맷에서 같은 시간에 발생(배치와 크기만 변경); 다른 포맷을 크롭한 것처럼 보이는 포맷은 비평에서 P1으로 처리. studio.json에서 safe 여백을 조정하고, 코드에서는 조정하지 마세요. npm run preview로 각 포맷을 미리보기(F 키로 포맷 순환, G 키로 안전 가이드 표시).

2. 모든 포맷 검토

비평 루프는 기본 포맷에서 실행됩니다. 최종 전에 다른 각 포맷에 대해 최소 한 라운드를 실행하고, 각각 자체 증거를 포함하세요(라이브 패스당 약 115초 도구 시간, --video 패스당 약 85초, 12~20초 영화 기준):

node tools/stills.mjs --format 1x1
node tools/render.mjs --format 16x9 --draft --sub 1 --scale 0.5     # 약 20초; 그다음: npm run sfx, node tools/mix.mjs --format 16x9
node tools/critique.mjs --format 16x9                                 # 라이브 영화 -> out/review/16x9/
node tools/critique.mjs --format 16x9 --video out/16x9/final.mp4      # 혼합 렌더링 -> out/review/16x9/video/

각각을 별도의 라운드로 기록합니다(## Round <n> — 16x9 — ...). 게이트는 마지막 라운드를 읽으므로 통과 라운드로 마무리하세요.

3. 렌더링, 믹싱, 전달

몇 분이 소요됩니다: 12초 데모를 60fps로 세 포맷 렌더링하는 데 약 4분(영화 1초당 약 20초), mix는 40~80초, deliver는 약 40초가 걸립니다. npm run build, render:final, mix 및 deliver는 Bash 도구의 run_in_background 옵션과 로그로 시작하고, 로그를 폴링(tail -n 3)하고, exit 줄 이후 결과를 읽으며, 포그라운드에서 약 2분 이상 기다리지 마세요. 세 개 이상의 포맷 또는 약 30초 이상의 최종 렌더링에 --chunk 10을 추가하세요. 모션 릴 런북("긴 명령어")에 패턴이 있습니다.

단계명령어출력
모든 것, 순서대로npm run build점수(없는 경우), sfx, 모든 포맷의 최종 렌더링, 믹스, 전달
최종 렌더링(게이트 통과 필요)npm run render:finalstudio.json formats의 모든 포맷에 대해 out/<fmt>/silent.mp4, poster.png, render.json
믹스 및 머지스npm run mixout/score.wav, out/<fmt>/final.mp4, out/final.mp4(기본), out/poster.png
검사 및 패키징npm run deliverout/deliver/<slug>_<fmt>.mp4 + 포스터 + 연락처 시트의 모든 페이지(<slug>_<fmt>_contact.png, 그다음 _contact-2.png ...), out/deliver/manifest.json, docs/production.json

deliver.mjs는 포맷별로 out/<fmt>/final.mp4를 현재 studio.json과 비교하여 검사합니다: 프레임 수(지속 시간 x fps), 포맷 크기, fps 및 정확한 지속 시간(duration 또는 fps 편집 전에 렌더링된 컷은 stale render로 실패; 드래프트 또는 스케일 렌더링도 실패), 통합 음량 및 실제 피크(audio.lufs +- audio.lufsTolerance 및 audio.truePeak 기준), 무음 구간(1초 이상 -50dB 이하 구간은 silence로 실패, 예: silence 2.2 s at 00:02.1, 단 첫 0.3초 이내, 마지막 1초 이내, 또는 critique.allowSilence 구간 내에 위치한 경우 제외), 파일 크기(deliver.maxBytes 기준, 기본 x: 536,870,912바이트 = X의 512MB 업로드 제한; 다른 플랫폼 제한도 추가 가능), 포스터 존재 여부, 루프 영화의 루프 이음새, 비평 게이트. 영화 소스가 렌더링보다 최신이면 경고(실패 아님). 실패 시 exit 1을 반환하고 실패한 각 검사를 명명합니다. 읽을 수 없는 final.mp4도 실패합니다. --json 사용 시 실패는 한 줄 { ok: false, error, failed: [...] }을 출력하며, 실행을 시작할 수 없는 경우(유효하지 않은 studio.json, 알 수 없는 포맷, 잘못된 플래그)에도 마찬가지입니다. --format 1x1은 해당 포맷만 재전달하고 다른 포맷의 전달 파일과 매니페스트 항목은 유지합니다(carriedOver). 게이트 실패 시 모든 전달 파일이 철회됩니다. docs/production.json은 제목, 포맷, 지속 시간, 음량, 라운드, 마지막 점수, 노력 수준(CLAUDE_EFFORT 설정 시) 및 도구 버전을 기록합니다.

실패한 검사수정 방법
프레임 또는 지속 시간 불일치, 또는 stale rendernpm run render:final 재실행; 부분 렌더링 전달 금지
음량 또는 실제 피크/motion-studio:sound-design (믹스 보고 테이블)
silence스템이 일찍 끝나거나 배드가 무음 아래에서 재생됨: 재생성(npm run score, sfx, voice), npm run mix, 다시 전달
크기 제한 초과node tools/render.mjs --format <f> --final --crf 18 후 npm run mix 재실행
포스터 누락studio.json poster(초) 설정 또는 --no-poster 제거
게이트/motion-studio:critique-loop

사용자에게 보고: out/deliver/의 모든 파일, 매니페스트의 포맷별 수치, 마지막 라운드 점수, 다음에 개선할 사항.

4. 파이프라인을 사용자 고유의 스킬로 패키징

다음 동영상이 한 문장이 되도록(/acme-reel dark mode용 출시 동영상, 20초, 세로):

  1. 이름 선택: <브랜드>-reel, 소문자, 숫자 및 하이픈.
  2. 브랜드 저장소에 .claude/skills/<브랜드>-reel/SKILL.md 생성(프로젝트 범위, git을 통해 공유) 또는 ~/.claude/skills/<브랜드>-reel/SKILL.md(개인). ${CLAUDE_SKILL_DIR}/assets/brand-skill-template.md(assets/brand-skill-template.md)에서 시작.
  3. 이 프로젝트에서 채우기(메모리에서 하지 않음): studio.json 브랜드 값, docs/style_guide.md, 승인된 docs/shotlist.md(스토리 비트 패턴으로), docs/review_log.md의 교훈(비평가가 계속 지적한 것이 하드 규칙이 됨). 로고를 .claude/skills/<브랜드>-reel/assets/에 복사.
  4. 설명은 약 230자 이내로 유지하고 구체적인 트리거 구문을 포함, 본문은 약 200줄 이내.
  5. 새 세션에서 실제 요청으로 테스트하고 동영상마다 변경되는 사항만 물어보는지 확인.
  6. 하나의 저장소를 넘어 공유하려면 플러그인(.claude-plugin/plugin.json 및 skills/<name>/SKILL.md가 있는 저장소)으로 게시. buildwithhanif/claude-animation-skill 및 이 플러그인이 게시된 방식과 동일.

5. 서비스로 전환 (선택 사항)

${CLAUDE_SKILL_DIR}/assets/service-offer.md(assets/service-offer.md)는 작성 가능한 제안서입니다: 포함 사항(음악, 모든 스타일의 마스코트, 제품 기능, 마지막 제안, 모든 언어, 최대 3회 수정), 포맷, 처리 시간, 클라이언트 제공 사항, 권리 및 공개, 가격. 가격 기준: Tony Dinh는 Opus 5.5로 30분 이내에 제작하기 1년 전에 유사한 출시 동영상에 약 $1,000+를 지불했다고 보고함(https://x.com/tdinh_me/status/2103703135902740699). 사용자가 작성하도록 도움; 대신 게시하거나 보내지 마세요.

다음: 다음 영화를 /motion-studio:motion-reel 또는 사용자의 새 /<브랜드>-reel 스킬로 시작하세요.

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

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

관련 스킬