Communitygithub.com

reels-motion — 릴스 모션 그래픽

로우(raw) 세로 클립에서 헤드톡 릴스를 자동으로 편집합니다. 오디오 기반 컷, 모션 그래픽, 키네틱 캡션, 스톱모션 커버, 반응 스티커 등을 지원하며 Reels, Shorts에 최적화되어 있습니다.

reels-motion — 릴스 모션 그래픽란 무엇인가요?

이 스킬은 사용자의 로우(raw) 세로형 말하는 사람 영상을 입력받아 오디오 파형 기반 자동 컷, 단어 단위 자막, 모션 그래픽(플래시, 후프, 펀치인 등), 스톱모션 커버(손가락 제스처 포함), 반응 스티커 및 SFX·배경음악 합성, -14 LUFS 오디오 마스터링, QA 프레임 검수까지 전 과정을 로컬에서 처리합니다. kid, premium, sticker, kinetic 등 사전 설정 스타일을 제공하며, 사용자가 스타일을 혼합하거나 설명·레퍼런스로 새 스타일을 생성할 수도 있습니다. 템플릿 A(후크→리드→3블록 루프→CTA)와 템플릿 B(질문→감정→영역→답변)를 지원하고, 편집 과정에서 사용자와 대화하며 선택합니다. fal.ai Whisper(유료)로 음성 인식을 하고, 그 외 모든 처리는 ffmpeg, headless Chromium, numpy 등 오픈소스 도구로 이뤄집니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add IliaBatko39/reels-motion

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

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

문서

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

시트를 이미지로 보여주세요. 응답 옵션:

  1. 프리셋: premium (유리, 따뜻한 악센트), sticker (스티커, 마커), kinetic (3D, 깊이에서 나오는 판), base (중립).
  2. 혼합: 예: 플래시는 sticker, 자막은 premium — "extends": "sticker", "components": {"*": "sticker", "captions": "premium"} 형식의 style.json.
  3. 설명 또는 레퍼런스로 새 스타일 (스크린샷, 다른 릴스) — reference/styles.md, «단계별» 섹션:
    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
    
    테스트 — 4초: 스톱모션 커버 + 플래시, 리드, 자막, CTA; mp4 및 0.25초 간격 프레임 시트. 직접 프레임을 보고 사용자에게 보여주세요. 전체 렌더링은 사용자가 «확인»한 후에만 진행합니다.

사용자가 원하는 바를 모를 경우, 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 참조.

관련 스킬