reels-motion — 릴스 모션 그래픽 (모션 그래픽으로 꾸며진 릴스)
로우(raw) 세로형 카메라를 보며 말하는 사람의 영상으로부터 완성된 릴스를 만듭니다: 오디오 기반 편집, 손가락 제스처가 있는 스톱모션 커버, 선택한 스타일의 플래시 및 반응, 단어 단위 자막, 카메라 움직임, 사운드. 모든 작업은 로컬에서 이뤄집니다: ffmpeg, headless Chromium, numpy. 유료 단계는 음성 인식(fal whisper)뿐입니다.
이 파일과 함께 있는 파일:
${CLAUDE_SKILL_DIR}/engine/reel.py— 단일 CLI, 각 하위 명령어는--help지원${CLAUDE_SKILL_DIR}/styles/— 스타일 프리셋,${CLAUDE_SKILL_DIR}/examples/— 템플릿 A, B의 타임라인${CLAUDE_SKILL_DIR}/reference/— 각 단계별 상세 설명; 해당 단계에 도달했을 때 읽을 것
이하 R은 python3 ${CLAUDE_SKILL_DIR}/engine/reel.py를 의미합니다. 사용자 프로젝트 폴더에서 작업하세요. 스킬 폴더 내부에서 작업하지 마세요.
0. 환경 설정 — 한 번만
python3 ${CLAUDE_SKILL_DIR}/scripts/check_env.py
Python 모듈, ffmpeg(필터 포함), Chromium, 폰트를 확인합니다. 각 문제에 대해 설치 명령어를 출력합니다. 전체 파이프라인의 빠른 확인은 다른 사람의 영상 없이 합성 데모로 진행합니다 (5~10분):
R demo --style sticker --out ./reels-demo
1. 소스 분석
R probe src/*.mov --sheets work/sheets
해상도, 프레임 레이트, 회전, HDR 태그, 오디오; 각 파일의 프레임 시트는 직접 눈으로 확인(Read)하여 어떤 장면이 촬영되었고 사람이 어디를 보는지 파악합니다. 아이폰 HDR(arib-std-b67)은 엔진이 자동으로 BT.709로 변환합니다.
2. 음성 인식
# fal 키는 환경 변수 FAL_KEY에만 저장 (사용자가 설정)
R stt src/*.mov --out work/stt
fal whisper의 단어 단위 인식. FAL_KEY 없으면 실행되지 않으며(오류 코드 2와 함께 명확한 메시지 출력), 그 경우 fal 형식의 chunks JSON으로 단어를 제공합니다. 1.2초보다 긴 단어는 거의 항상 숨은 반복이나 말실수입니다. 명령어가 직접 출력하므로, 느리게 2배 재확인하려면:
R stt src/take3.mov --out work/stt --slow 20.0:22.2
3. 테이크 선택 및 배치
템플릿 A 또는 B — reference/templates.md 참조. 각 구절에 대해 마지막으로 완전히 진행된 테이크를 선택합니다. 각 컷의 이유를 단어로 설명합니다(«반복 제거», «장소 변경»). 유용한 테이크는 1초 미만의 일시 정지를 위해 자르지 않습니다. 배치는 EDL(JSON, 형식은 engine/rm/cut.py에 있음): {src, in, out, stage} 조각, 손가락 끝이 있는 스톱모션 커버 프레임, 단어 수정 사항.
4. 오디오 엔벨로프 기반 컷 및 프레임 그리드
R cut --scan src/take1.mov:2.0:11.0 # 해당 윈도우에서 음성 및 조용한 지점 탐색
R cut edl.json --out work
음성 인식은 어디서 찾을지 알려주고, 엔벨로프는 어디서 자를지 결정합니다. cut은 각 경계를 오디오 레벨로 검증합니다(음성 중간 자르면 오류, cut_report.json), 프레임 번호로 자르고, 기본 프레임 수를 assert한 후 base.mov, words.json, beats.json, freeze.png를 작성합니다. 그런 다음: R words work/words.json — 앵커용 단어 번호, R faces timeline.json — 샷별 얼굴.
5. 플래시가 포함된 스톱모션 커버
프레임 0 — 커버. «첫 번째 프레임에 손가락이 플래시를 가리키는» 기법: EDL에서 freeze: {src, t, fingertip}, 타임라인에서 freeze.hold 0.4~0.7초. 후크 플래시는 손가락 왼쪽에 배치하거나 손가락 끝에서 선으로 연결됩니다. 모든 시간은 스톱모션에 맞춰 자동으로 조정됩니다.
6. 타임라인
단일 JSON: 템플릿 단계, 단어, 스톱모션, 요소, 카메라, 자막 — reference/timeline-schema.md, 예제 examples/template-a.timeline.json, examples/template-b.timeline.json. 시간은 단어 앵커({"w": 13}, {"word": "프랜차이즈"}) 및 컷({"cut": 2})으로 지정합니다. 자유 요소 — elements: 반응 🔥 😮 👍, 스티커, 화살표 및 설명선, «댓글에 답변» 버블, 강조 단어, 진행률, 카운터.
R plan timeline.json --style base --verbose # 앵커, 읽기 시간, 숫자 확인
7. 스타일 선택 — 렌더링 전 필수
스타일을 묻지 않고 기본값으로 설정하지 마세요. 사용자에게 어떤 스타일로 할지 물어보고 미리보기를 보여주세요:
R styles # 스타일 목록
R styles --preview --out work/preview # 시트: 스톱모션 커버 + 플래시 · 리드 + 자막 · 각 스타일의 CTA
시트를 이미지로 보여주세요. 응답 옵션:
- 프리셋:
premium(유리, 따뜻한 악센트),sticker(스티커, 마커),kinetic(3D, 깊이에서 나오는 판),base(중립). - 혼합: 예: 플래시는 sticker, 자막은 premium —
"extends": "sticker", "components": {"*": "sticker", "captions": "premium"}형식의style.json. - 설명 또는 레퍼런스로 새 스타일 (스크린샷, 다른 릴스) —
reference/styles.md, «단계별» 섹션:테스트 — 4초: 스톱모션 커버 + 플래시, 리드, 자막, CTA; mp4 및 0.25초 간격 프레임 시트. 직접 프레임을 보고 사용자에게 보여주세요. 전체 렌더링은 사용자가 «확인»한 후에만 진행합니다.R style-new neon --from base # ~/.reels-motion/styles/neon/style.json 에 템플릿 생성 # tokens / motion / captions / camera / transitions / audio 수정 (필요시 자체 컴포넌트 추가) R style-test neon --project timeline.json --out work/style-test-neon
사용자가 원하는 바를 모를 경우, 2~3가지 대조적인 옵션(예: premium, sticker, 새 스타일 하나)을 제안하고 미리보기를 나란히 보여주세요.
8. 오버레이, 자막, 카메라
R render timeline.json --style <스타일> --work work/<스타일> # overlay.mov + boxes.json + meta.json
R render timeline.json --style <스타일> --frames 0,45,300 --png-dir work/stills # 개별 프레임 확인용
R compose timeline.json --style <스타일> --work work/<스타일> # video.mp4
프레임은 시간의 순수 함수(setTime(t))입니다. 움직임 블러는 입/출력 시 4개의 서브프레임만 사용합니다. 단어 단위 자막은 words.json에서, 스타일에 따라 표시됩니다(reference/captions.md). 카메라: 샷 스케일이 컷을 마스킹하고, 키워드에 펀치인, 비트에 한 번 흔들림; 단계 경계에 후프 및 플래시 (reference/motion.md). 무거운 단계는 머신당 하나씩 실행: --lock /tmp/reels_motion.lock 또는 REEL_LOCK.
9. 사운드
R audio timeline.json --style <스타일> --work work/<스타일>
목소리 — 위생 처리만 (하이패스 80Hz, 컴프레서 ≤ 3:1, 노이즈 게이트 없음). SFX — 합성, 정확히 등장 프레임에 맞춤. 배경음악 — 목소리에 사이드체인 적용한 합성. 최종 −14 LUFS, true peak ≤ −1, alimiter level=false. 두 가지 버전: 배경음악 포함 및 미포함 (reference/sound.md).
10. 최종 조립 및 검수
R finalize timeline.json --style <스타일> --work work/<스타일> --out out --name reel
R qa timeline.json --style <스타일> --work work/<스타일> --out out --name reel --stt
R sheet timeline.json --style <스타일> --work work/<스타일> --out out --name reel
또는 한 번에: R build timeline.json --style <스타일> --work work/<스타일> --out out.
검수 — reference/qa.md, 최종 작업:
qa: 프레임 = 베이스 + 스톱모션, BT.709, LUFS/TP, 텍스트가 안전 영역 내, 오버레이가 얼굴 위에 없음, SFX가 등장 프레임 ±1 이내;--stt— 역음성 인식: 구절이 완전한지 확인.- 직접 눈으로 확인(Read): 0.25초 간격 시트와 등장 및 컷 주변의 모든 프레임(
out/sheets/). 프레임 0 — 플래시가 있는 커버. - 파일은 임시 이름으로 작성되고 끝에 이름이 변경됩니다.
11. 결과물
out/reel.mp4 (H.264, AAC 256k, faststart), out/reel_nomusic.mp4, out/reel_tg.mp4 (≤ 6Mbps, < 45MB), out/reel_cover.jpg, 프레임 시트. 보고서: 사용된 스타일, 각 컷과 이유, qa 측정값, 직접 확인한 사항.
반드시 지켜야 할 규칙
- 프레임 내 숫자는 목소리에서만, 그리고 발화 순간에만 표시됩니다. 사실에 대한 카운터는 금지됩니다.
- 무엇이든 지어내지 마세요: 사실, 약속, 수익은 작성자가 말한 대로만 표시합니다.
- 텍스트는 얼굴 위에 있지 않아야 하며 안전 영역 내에 있어야 합니다. 텍스트 크기 ≥ 40px. 표시 시간 ≥ 0.3 × 단어 수 + 0.5초.
- «네모난 플래시» 금지: 형태, 오버플로우 인입, 미세 움직임 —
reference/motion.md참조. - 알려진 함정 (alimiter,
-frames:v,fps없는setpts, HDR, Chromium의 blur, 미완료 파일, jump cut) —reference/pitfalls.md참조.