Cinematic Skill: 목소리에 맞춰 코드로 그리는 내레이션 다큐
「라이트 형제 90초 다큐」 한 줄에 대본, 목소리, 사진, 카메라 움직임까지 코드로 그려 내는 스킬
- 누가
- X에서 exploraX로 활동하는 제작자(GitHub Moh4696)가 만들었어요. 촬영 없이 다큐나 설명 영상을 만들고 싶은 사람을 위한 스킬이에요.
- 언제
- 저장소는 2026년 11월 9일에 열렸고, 같은 날 1.0.0과 1.0.1이 나왔어요(CHANGELOG 기준).
- 어디서
- Claude Code, Codex, Cursor, Gemini CLI, OpenCode에 설치해요. 렌더는 내 컴퓨터의 Python과 ffmpeg로 돌아요.
이게 불편했어요
설명 영상이나 짧은 다큐를 만들려면 대본을 쓰고, 목소리를 녹음하고, 쓸 수 있는 사진을 찾고, 편집기에서 컷마다 타이밍을 맞춰야 했어요. 생성형 영상에 맡기면 돌릴 때마다 화면이 달라져서 한 군데만 고치기도 어려웠어요.
그래서 이렇게 풀어요
이 스킬은 영상을 한 장의 큰 보드로 봐요. 사진, 문서, 카드, 지도, 숫자가 모두 한 보드 위에 놓이고, 카메라 한 대가 그 사이를 끊김 없이 옮겨 다녀요. 모든 프레임을 코드(Python의 Skia)가 그리기 때문에 같은 장면 파일은 늘 같은 영상이 되고, 도장과 형광펜은 내레이터가 그 단어를 말하는 순간에 떨어져요. 사진은 Wikimedia Commons에서 라이선스와 함께 받아 오고, 자유 이용이 아닌 파일은 거절해요.



안에서는 이렇게 돌아가요
- 1
나 → Claude Code
「라이트 형제 90초 다큐 만들어 줘」주제와 길이만 말하면 스킬이 불려 와요. - 2
Claude Code → cinematic-film
script.json → make_beats.py → beats.md대본을 쓰고, 시간 순서와 줄 길이를 검사한 비트 표를 만들어 내 승인을 받아요.skills/cinematic-film/scripts/make_beats.py - 3
cinematic-film → audio/timing.json
tts_say.py → build_narration.py임시 목소리를 줄 단위로 잘라 narration.m4a와 단어 시각이 담긴 timing.json을 만들어요.skills/cinematic-film/scripts/build_narration.py - 4
Claude Code → engine.py · render.py
scene.py: doc.W(line, "word")사진, 지도, 카운터를 말하는 단어의 시각에 놓고 카메라와 스포트라이트 키를 적어요.skills/cinematic-film/assets/wright-flyer/scene.py - 5
audio/timing.json → engine.py · render.py
timing.json모든 등장 시각이 목소리에서 나오니, 목소리를 바꾸면 영상 전체가 다시 맞춰져요.skills/cinematic-film/scripts/engine.py - 6
engine.py · render.py → MP4 · SRT · credits.md
render.py --out out/draft.mp4스틸을 먼저 뽑아 확인한 뒤 병렬로 렌더하고, 효과음과 자막을 얹어요.skills/cinematic-film/scripts/render.py
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 역사, 인물, 사건을 사진과 지도로 풀어 가는 1~2분 다큐를 만들 때
- 내 제품 사진으로 출시 영상이나 창업 이야기를 만들 때
- 원리 설명을 카드와 숫자 카운터로 보여 주고 싶을 때
- 목소리나 문장을 바꿔도 영상이 알아서 다시 맞춰지길 바랄 때
이건 안 돼요
- 생성형 영상이 아니에요. 움직이는 실사 화면은 나오지 않고, 사진과 그래픽 위를 카메라가 움직여요.
- README 기준으로 16GB 노트북에서 92초 영상을 1080p로 렌더하는 데 약 6분이 걸려요.
- 무료 임시 목소리는 macOS say나 espeak-ng예요. 최종 목소리는 다른 TTS나 사람이 녹음해요.
- 비트 표, 화면 모양, 30초 초안에서 멈추고 내 승인을 기다려요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요