AI 칼럼

영상@donghyeok99운영진

Cinematic Skill: 목소리에 맞춰 코드로 그리는 내레이션 다큐

「라이트 형제 90초 다큐」 한 줄에 대본, 목소리, 사진, 카메라 움직임까지 코드로 그려 내는 스킬

코르크 벽에 날짜가 찍히고, 지도 핀에서 첫 비행 사진으로 붉은 실이 이어진 뒤 12초와 120피트 카운터가 목소리에 맞춰 올라와요.
코르크 벽에 날짜가 찍히고, 지도 핀에서 첫 비행 사진으로 붉은 실이 이어진 뒤 12초와 120피트 카운터가 목소리에 맞춰 올라와요.
누가
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. 1

    나 → Claude Code

    「라이트 형제 90초 다큐 만들어 줘」주제와 길이만 말하면 스킬이 불려 와요.
  2. 2

    Claude Code → cinematic-film

    script.json → make_beats.py → beats.md대본을 쓰고, 시간 순서와 줄 길이를 검사한 비트 표를 만들어 내 승인을 받아요.skills/cinematic-film/scripts/make_beats.py
  3. 3

    cinematic-film → audio/timing.json

    tts_say.py → build_narration.py임시 목소리를 줄 단위로 잘라 narration.m4a와 단어 시각이 담긴 timing.json을 만들어요.skills/cinematic-film/scripts/build_narration.py
  4. 4

    Claude Code → engine.py · render.py

    scene.py: doc.W(line, "word")사진, 지도, 카운터를 말하는 단어의 시각에 놓고 카메라와 스포트라이트 키를 적어요.skills/cinematic-film/assets/wright-flyer/scene.py
  5. 5

    audio/timing.json → engine.py · render.py

    timing.json모든 등장 시각이 목소리에서 나오니, 목소리를 바꾸면 영상 전체가 다시 맞춰져요.skills/cinematic-film/scripts/engine.py
  6. 6

    engine.py · render.py → MP4 · SRT · credits.md

    render.py --out out/draft.mp4스틸을 먼저 뽑아 확인한 뒤 병렬로 렌더하고, 효과음과 자막을 얹어요.skills/cinematic-film/scripts/render.py

넣으면 이렇게 나와요

a 90 second documentary about the Wright brothers저장소에 든 예제 「Twelve Seconds」: 퍼블릭 도메인 사진 7장으로 만든 약 90초 다큐
new_project.py my-film「From Cherry to Cup」: 카드와 화살표, 카운터로 된 25초 설명 영상 틀

나한테 맞을까요

이럴 때 좋아요

  • 역사, 인물, 사건을 사진과 지도로 풀어 가는 1~2분 다큐를 만들 때
  • 내 제품 사진으로 출시 영상이나 창업 이야기를 만들 때
  • 원리 설명을 카드와 숫자 카운터로 보여 주고 싶을 때
  • 목소리나 문장을 바꿔도 영상이 알아서 다시 맞춰지길 바랄 때

이건 안 돼요

  • 생성형 영상이 아니에요. 움직이는 실사 화면은 나오지 않고, 사진과 그래픽 위를 카메라가 움직여요.
  • README 기준으로 16GB 노트북에서 92초 영상을 1080p로 렌더하는 데 약 6분이 걸려요.
  • 무료 임시 목소리는 macOS say나 espeak-ng예요. 최종 목소리는 다른 TTS나 사람이 녹음해요.
  • 비트 표, 화면 모양, 30초 초안에서 멈추고 내 승인을 기다려요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기