/stick-figure
┌──────────────────────┐
│ ☀ ☁ │ 밝은 하늘, 바다, 코드로 그려진 소품
│ ◯ ◯ │ 큰 흰색 머리와 표정을 가진 막대인간
│ /|\ /|\ │
│ / \ / \ 🛢 │
│ 안대 │ 1~2단어 자막, 소문자, 약 70% 아래쪽
└──────────────────────┘
작업 예제가 함께 제공됩니다: engine/template은 완성된 37초 릴로, "만약 해적 안대가 실명과 관련이 없었다면?"이라는 주제를 다룹니다.
첫 사용
이 스킬의 폴더는 Claude Code가 로드할 때 표시하는 "Base directory"입니다.
SKILL_DIR="<이 스킬의 기본 디렉토리>"
ENGINE="$SKILL_DIR/engine"
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
[ -x "$KIT/.venv/bin/python" ] && [ -d "$KIT/models" ] || bash "$KIT/setup.sh" --voice # 약 1GB 음성 모델, 한 번만
PY="$KIT/.venv/bin/python"; export NODE_PATH="$KIT/node_modules"
ffmpeg, Node 및 Python 3.9+가 필요합니다. 예제를 보려면: cp -r "$ENGINE/template" ~/reels/pirate && bash "$ENGINE/make.sh" ~/reels/pirate.
구성 방식
릴은 하나의 폴더입니다:
script.json: 음성 내레이션, 항목당 한 문장.captions.json: 자막의 선택적 텍스트 교체 ({"twenty five": "25"}).web/shots.js: 샷 목록. 각 샷은SHOTS.push({start, end, tr, draw(ctx, lt, t)})형태로 음성 시간(초) 기준입니다.lt는 샷 내 시간,tr은 종료 전환('whip'또는'cut').web/lib.js(이징, 키프레임kf, 도형, 텍스트),web/chars.js(막대인간 리깅drawStick, 모자, 얼굴, 팔 IK, 안대),web/env.js(하늘, 구름, 바다, 배, 갑판, 통, 대포, 등, 갑판 아래),web/main.js(채찍 블러, 비네트, 그레인, 자막). 새 소품은env.js또는 새env2.js에 추가합니다 (web/index.html에 목록 추가).audio.py: 음악과 SFX, 모두 코드로 합성되며 음성 시간(초) 단위로 배치됩니다.
make.sh는 음성을 생성하고, 모든 단어를 정렬(audio/words_new.json)하고, 사운드를 믹싱하고, 샷을 병렬로 렌더링하여 <폴더>/<폴더 이름>.mp4를 작성합니다.
타이밍: audio/words_ref.json은 샷이 맞춰진 기준 음성입니다. 음성이 변경되어도 단어가 변경되지 않으면 make.sh가 새 테이크에 맞춰 샷을 워프하므로 새 녹음에 편집이 필요 없습니다. 스크립트가 변경되면 audio/words_ref.json을 삭제하고(다음 테이크가 기준이 됨) shots.js의 타이밍을 다시 조정합니다.
단계
- 스크립트. 약 110
120단어, 3840초 분량, 문장당 하나의 아이디어: "만약 ~라면" 훅, 일반적인 믿음, "하지만"으로 전환, 예시 축적, 메커니즘을 보여주는 하나의 샷, 훅에 답하는 결말. 애니메이션 전에 사용자에게 보여줍니다. - 사실 확인. 출처와 함께 모든 주장을 확인합니다. 이론은 신중하게 표현합니다("과학자들은 생각합니다").
- 폴더.
cp -r "$ENGINE/template" <릴>을 실행한 후,audio/를 비우고script.json(그리고captions.json)을 교체합니다. - 음성. 폴더에서:
"$PY" "$ENGINE/tools/tts_kokoro.py"(무료) 또는 사용자 자신의 녹음, 또는ELEVENLABS_API_KEY를 사용한 ElevenLabs ("$PY" "$ENGINE/tools/tts_elevenlabs.py" audio/vo_el.mp3). 테이크를audio/vo.wav에 배치한 후,"$PY" "$ENGINE/tools/align.py" audio/vo.wav를 실행하고audio/words_new.json에서 단어 시간을 읽습니다. - 샷.
web/shots.js를 다시 작성: 약 1012개의 셋업, 대부분 24초, 설명 샷은 더 길게. 새로운 아이디어는 새로운 셋업. 훅은 프레임 1에서 바로 액션으로 시작합니다. 얼굴과 주요 소품이 자막 영역(y 약 12501420)과 Instagram의 안전 영역(x 100980, y 220~1500) 안에 들어가도록 유지합니다. - 스틸. 폴더에서:
node "$ENGINE/tools/render.js" stills 1.5,4.2,9.0은stills/에 이미지를 씁니다. 가장 복잡한 순간을 확인하고 전체 렌더링 전에 수정합니다. - 사운드. 단어 시간에 맞춰
audio.py의 큐를 편집합니다. - 빌드.
bash "$ENGINE/make.sh" <릴>(audio/vo.wav유지;kokoro,elevenlabs또는 파일을 전달하여 교체 가능). 코어가 많은 경우WORKERS=8사용.AUDIO_ONLY=1은 다시 렌더링하지 않고 사운드를 리믹스합니다. - 전달
<릴>/<이름>.mp4.
스타일
- 자막: Poppins Bold, 흰색에 어두운 윤곽선, 1~2단어, 소문자, 구두점 없음(
main.js의capText()가 처리; 숫자와%는 유지). 화면에 em 대시 없음. - 밝고 채도 높은 팔레트, 잉크 윤곽선(
#221c22), 부드러운 접촉 그림자, 핸드헬드 드리프트가 있는 느린 푸시인, 모션 블러가 있는 채찍 전환. 충격은 폭발, 흔들림, 섬광으로 표현. - SFX는 음성 아래에 위치(게인 약 0.38). 음악은 조용히 퉁기는 배경음으로, 음성 아래에서 덕킹되며, 처음부터 큰 루프 없음.