포맷, 스킬 및 서비스 출하하기 (코스 12단계)
세 가지 동작으로 좋은 클립을 반복 가능한 비즈니스로 전환하세요: 하나의 타임라인에서 모든 포맷을 내보내고, 파이프라인을 스킬로 패키징하여 다음 동영상이 한 문장으로 실행되도록 하며, 사용자가 원할 경우 판매합니다. 영화 프로젝트 루트에서 작업하세요. 인수는 한 번만 표시됩니다:
이 스킬의 파일은 ${CLAUDE_SKILL_DIR}에 있습니다 (템플릿은 assets/).
1. 포맷별 리프레이밍, 크롭 금지
씬은 레이아웃 L(ctx.L 팩토리, c.L 드로우)에 대해 그려지므로, 하나의 타임라인이 9:16, 1:1, 16:9(및 4:5)를 각 형태에 맞게 타이포그래피와 UI를 배치하여 렌더링합니다.
| 포맷 | 크기 | 레이블 |
|---|---|---|
9x16 | 1080x1920 | Reels, TikTok, Shorts |
1x1 | 1080x1080 | X / 피드 |
16x9 | 1920x1080 | YouTube, 사이트 |
4x5 | 1080x1350 | 피드 세로 |
| 도구 | 사용법 |
|---|---|
L.u | 크기 단위: 1080px 짧은 변 기준 1; 120 * L.u는 모든 포맷에서 같은 크기로 읽힘 |
L.S | studio.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:final | studio.json formats의 모든 포맷에 대해 out/<fmt>/silent.mp4, poster.png, render.json |
| 믹스 및 머지스 | npm run mix | out/score.wav, out/<fmt>/final.mp4, out/final.mp4(기본), out/poster.png |
| 검사 및 패키징 | npm run deliver | out/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 render | npm 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초, 세로):
- 이름 선택:
<브랜드>-reel, 소문자, 숫자 및 하이픈. - 브랜드 저장소에
.claude/skills/<브랜드>-reel/SKILL.md생성(프로젝트 범위, git을 통해 공유) 또는~/.claude/skills/<브랜드>-reel/SKILL.md(개인).${CLAUDE_SKILL_DIR}/assets/brand-skill-template.md(assets/brand-skill-template.md)에서 시작. - 이 프로젝트에서 채우기(메모리에서 하지 않음):
studio.json브랜드 값,docs/style_guide.md, 승인된docs/shotlist.md(스토리 비트 패턴으로),docs/review_log.md의 교훈(비평가가 계속 지적한 것이 하드 규칙이 됨). 로고를.claude/skills/<브랜드>-reel/assets/에 복사. - 설명은 약 230자 이내로 유지하고 구체적인 트리거 구문을 포함, 본문은 약 200줄 이내.
- 새 세션에서 실제 요청으로 테스트하고 동영상마다 변경되는 사항만 물어보는지 확인.
- 하나의 저장소를 넘어 공유하려면 플러그인(
.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 스킬로 시작하세요.