Communitygithub.com

다큐멘터리 메이커

한 문장의 아이디어에서 출발하여 30초에서 3분 분량의 단편 2D 애니메이션 다큐멘터리를 제작합니다. 연구, 대본, 음성, 단어 타이밍, 모션 디자인, 사운드 이펙트 및 배경 음악, 1080p MP4 영상까지 모든 작업을 사용자의 컴퓨터에서 처리합니다.

다큐멘터리 메이커란 무엇인가요?

이 스킬은 사용자가 '다큐멘터리, 애니메이션 설명 영상, 특정 사건에 관한 영상 제작' 또는 '무연사 역사/과학/비즈니스/범죄 이야기 영상'을 요청할 때, 한 문장의 주제로부터 완전한 2D 애니메이션 다큐멘터리 영상을 만들어냅니다. 사용자는 마치 전체 영화 제작진(연구자, 작가, 내레이터, 편집자, 애니메이터, 사운드 디자이너)과 협업하는 경험을 하게 됩니다. 이 스킬은 각 단계를 순서대로 실행합니다: 웹 검색을 통한 사실 조사, 시각적이고 간결한 대본 작성, Kokoro를 이용한 오프라인 음성 합성, Whisper를 이용한 단어별 타이밍 추출, GSAP 기반 모션 디자인된 장면 구성, 코드 기반 사운드 이펙트 및 배경 음악 생성, 그리고 최종 1080p MP4 렌더링까지. 모든 작업은 사용자의 로컬 컴퓨터에서 실행되며 추가 비용이 발생하지 않습니다. 각 프로젝트는 테마(자정, 엠버, 누아르, 포레스트, 크림슨)에 따라 일관된 색상 팔레트를 사용하여 시각적 일관성을 유지하고, 모든 애니메이션 요소는 음성의 특정 단어에 정확히 동기화됩니다. 사용자는 대본과 주요 사실을 확인한 후 음성 생성 및 렌더링을 승인할 수 있으며, 최종 결과물과 함께 출처와 검증되지 않은 사항을 안내받습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mehedi11234/claude-documentary-maker/tree/HEAD/documentary-maker

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

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

문서

다큐멘터리 메이커은(는) 무엇을 하나요?

당신은 전체 영화 제작진입니다: 연구자, 작가, 내레이터, 편집자, 애니메이터, 사운드 디자이너. 여섯 개의 장(chapter)을 순서대로 작업하세요. 모든 작업은 사용자의 컴퓨터에서 실행되며 Claude 요금제 외에 추가 비용이 들지 않습니다.

도구는 이 스킬 폴더에 있습니다 (<skill> 참고). Python 도구는 스킬의 가상 환경 Python을 사용합니다: Windows: ~/.documentary-maker/venv/Scripts/python.exe, 그 외: ~/.documentary-maker/venv/bin/python (<py>).

0. 설정 (최초 1회)

~/.documentary-maker/venv 또는 <skill>/engine/vendor/gsap.min.js가 없으면 python <skill>/tools/setup.py를 실행하세요 (Python 3.10-3.12; Windows에서는 py -3.12 <skill>/tools/setup.py). Node, FFmpeg 및 Chrome 또는 Edge가 필요합니다. 하나라도 없으면 사용자에게 어떤 것이 없고 중단한다고 알리세요. 그런 다음 사용자의 폴더에서 python <skill>/tools/new_doc.py <project> <theme>을 실행합니다.

주제에 따라 테마를 선택하세요: midnight (우주, 과학, 기술), ember (역사, 비즈니스, 인물), noir (범죄, 사기, 미스터리), forest (자연, 기후, 건강), crimson (전쟁, 재해 - 엄숙한 분위기). 하나의 악센트 색상이 모든 강조 표시를 담당합니다. 경고 색상은 위험, 금전 손실, 사망, 실패에만 사용합니다.

1. 연구 -> facts.md

  • 웹을 검색하세요. 대본의 모든 숫자, 날짜, 이름, 인용문은 facts.md에 출처 URL과 함께 있어야 합니다. 블로그보다는 공식 보고서, 법원 문서, 해당 조직의 자체 페이지, 주요 신문을 우선시하세요.
  • 출처 간에 (금액, 사망자 수 등) 차이가 있을 경우, 가장 많이 인용된 수치를 사용하고 대본에 "약" / "대략"이라고 표기하세요.
  • 인용문, 생각, 장면 세부 사항, 숫자를 절대 지어내지 마세요. 출처를 찾을 수 없으면 해당 내용을 생략하세요.

2. 대본 -> script.md + voice/script_voice.txt

길이: 초당 약 2.4 단어 비율 (30초 ~ 75단어, 60초 ~ 145단어, 3분 ~ 430단어).

  • 요약이 아닌 순간(moment)으로 시작하세요: 날짜, 장소, 행동 ("1996년 6월. 반짝이는 새 로켓이 발사대 위에 서 있다."). 시청자가 그것을 볼 수 있어야 합니다.
  • 짧은 문장. 문장 당 하나의 아이디어: 각 문장은 하나의 애니메이션이 됩니다.
  • 가장 큰 숫자는 마지막에 공개하고, 각 공개는 다음 질문을 열어줍니다 ("원인? 엔진이 아니었다. 날씨도 아니었다. 하나의 숫자였다.").
  • 시작을 보답하는 짧은 문장으로 끝맺습니다.
  • script.md = 제목이 포함된 대본. voice/script_voice.txt = 음성을 위한 동일한 단어: 숫자와 기호는 말하는 대로 표기 ("1996" -> "천구백구십육", "64비트", "3억 7천만 달러"), 제목 없음, [태그] 없음; 문단 사이의 빈 줄 = 일시 정지 (1-3문장의 문단).
  • 사용자에게 대본과 주요 사실을 보여주고 음성 제작 전에 승인을 기다리세요, 사용자가 묻지 말라고 하지 않은 경우에 한합니다.

3. 음성 -> voice/voice.wav

cd <project> && <py> voice.py --voice am_michael (다른 내레이터: am_onyx, am_fenrir, bm_george, bm_daniel, af_heart, bf_emma; 차분한 낭독을 위해 --speed 0.95). Kokoro는 CPU에서 약 2배속 실시간으로 실행됩니다.

4. 단어 타이밍 -> engine/data.js

<py> words.py. 단어 검사 결과를 출력합니다. 대본 단어가 누락되었거나 잘못된 경우 해당 문단을 편집하고 (종종 이름: 발음되는 대로 철자) 3장을 다시 실행합니다. Whisper는 숫자를 숫자로 씁니다 ("1996", "64-bit", "$370"), 따라서 자막은 숫자를 표시합니다. 일반 단어에 애니메이션을 고정하세요.

5. 장면 -> engine/scenes.js

먼저 <skill>/examples/ariane-501/scenes.js를 읽으세요: 완전히 작동하는 다큐멘터리입니다. 같은 방식으로 직접 작성하세요.

  • 먼저 anchors(): WA('word', 'alternative') (시작) 및 WEnd(...) (끝)을 사용하여 각 비트의 단어 시간을 순서대로 조회합니다. B.end = endAfterVoice(2.0); _wc = 0;으로 마무리합니다. 그런 다음 build()는 비트당 하나의 함수를 호출합니다.
  • 모든 요소는 말하는 단어 위에 나타납니다. 해당 단어보다 먼저 나타나는 것은 없습니다. 화면이 약 1초 이상 비어 있지 않습니다.
  • 이야기를 그리고, 쓰지 마십시오. 테마 색상의 인라인 SVG 일러스트레이션 (로켓, 건물, 지도 모양, 동전, 사람 실루엣, 문서)과 카메라 이동 (레이어 scale/translate) 및 운동감 있는 헤드라인 hd(), 카드 card() + fly(), stamp() / warnStamp(), counter(), burst(), suspectCard(), quoteCard(), timeline(), dateTag(), typeText()를 사용하세요. 모든 헬퍼와 옵션은 engine/lib.js 및 engine/doc.js를 참조하세요.
  • 텍스트는 짧게 유지하세요 (레이블, 숫자, 2-4단어 헤드라인). 자막은 이미 모든 단어를 하단에 표시합니다: 콘텐츠를 y = 930 위에 유지하세요. 자막이 강조할 단어는 window.KEYWORDS로 설정하세요.
  • 실제 영상이나 문서로 오인될 수 있는 그림에는 작은 "일러스트레이션" 태그를 붙이세요.
  • 초 단위 모션만: 0.25초보다 빠른 트윈(tween), 깜빡이는 것은 없습니다.
  • 테마 색상만 사용하세요 (LIME = 악센트, LIME2, PAPER, MUTE, DIM, CARD1, CARD2, PINK = 경고, acc(a), warnA(a), PAPA(a), MUTEA(a)); 결정론적 난수는 RND(i)로, Math.random()은 절대 사용하지 마세요.
  • 주의사항: x/y 애니메이션은 GSAP로만 하세요. GSAP도 움직이는 요소에 CSS transform을 설정하지 마세요. 장면 sc(t0, t1)은 여전히 움직이는 모든 하위 요소를 포함해야 합니다. 헬퍼 이름과 같은 변수명을 사용하지 마세요 (rise, cl, card...).

렌더링 전 확인:

  1. python render.py check -> err: null 및 miss: []가 나와야 합니다. (음성이 아직 없으면 가상 타이밍으로 장면을 배치할 수 있습니다: python engine/fake_words.py.)
  2. python render.py stills <8-24 개의 시간>을 실행하고 모든 보드 이미지를 확인하세요: 겹침, 텍스트 잘림, 빈 화면, 단어보다 먼저 나타나는 것들, 테마 외의 색상. 수정하고 다시 확인하세요.

6. 사운드 + 렌더링 -> final.mp4

python render.py cues        # 장면에서 사운드 효과 큐 리스트 추출
<py> audio.py                # 코드 생성 SFX + 음성 하단의 오리지널 배경 음악, -14 LUFS -> mix.wav
python render.py video 4     # 120 fps 캡처 -> 모션 블러 -> 1080p30 final.mp4 (+ final_sheet.jpg)

백그라운드에서 또는 15분 타임아웃으로 render.py video를 실행하세요: 4개 워커로 비디오 10초당 약 1.5분이 소요됩니다 (실제 측정: CPU 전용 PC에서 38초 비디오를 6분에 렌더링). 청크에서 누락된 프레임이 보고되면 더 적은 워커로 다시 실행하세요. final_sheet.jpg를 확인하세요. 그런 다음 사용자에게 다음을 알리세요: 파일, 길이, 출처, 그리고 확인할 수 없었던 사항. 게시 전에 facts.md를 읽도록 알리고, 오디오는 들을 수 없으므로 사용자의 직접 청취가 실제 확인임을 상기시키세요.

관련 스킬