Communitygithub.com

yt-film

Python 엔진을 사용하여 긴 형식의 내레이션 YouTube 다큐멘터리 또는 설명 영상을 제작합니다. 스토리 아이디어, 소스 연구, 이미지 가이드, 대본, 타임드 내레이션, 음악, 라이브링 스틸, 지도, 코믹 페이지, 소스 각주, 사운드, 풍경 배치 렌더링, 최종 믹스, 더빙, 썸네일, 설정 또는 Chadwick 예제에 사용하세요. 보완 스킬인 yt-film-reels는 세로형 소셜 에피소드를 다룹니다.

yt-film란 무엇인가요?

yt-film은 사용자가 약 150장의 정지 이미지에서 내레이션이 포함된 긴 형식의 YouTube 다큐멘터리나 설명 영화를 제작할 수 있도록 도와주는 Python 기반 AI 에이전트 스킬입니다. 이 스킬은 Claude Code와 같은 AI 어시스턴트가 작업을 단계별로 안내하며, 아이디어 구상과 리서치부터 이미지 생성 가이드, 대본 작성, 음성 내레이션, 음악 제작, 최종 영상 렌더링 및 더빙까지 전체 제작 과정을 지원합니다. 주요 특징으로는 정지 이미지 위에 입자 연기, 숨결, 불꽃, 눈, 비와 같은 생동감 있는 효과를 추가하는 '리빙 스틸(Living Stills)' 기술과, AI가 생성한 그림이 스트로크 순서대로 그려지는 '라이브 드로잉(Live Drawings)', 그리고 만화 페이지, 지도, 타임라인 등 다양한 시각적 장치를 코드로 구현할 수 있다는 점이 있습니다. 사용자는 자신만의 이미지 스타일, 캐릭터, 음성, 배경 음악을 선택할 수 있으며, 스토리, 설명, 카운트다운 등 다양한 포맷을 지원합니다. 모든 작업은 사용자의 명시적 승인 하에 진행되며, 결과물은 -14 LUFS의 전문적인 오디오 레벨로 최종 출력됩니다. 이 스킬은 macOS, Linux, Windows를 모두 지원합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/ma7pc27/yt-film/tree/HEAD

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

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

문서

yt-film: 정지 이미지로 만드는 내레이션 영화

세로형 Reels, Shorts 또는 시리즈 소셜 비디오의 경우 보완 yt-film-reels 스킬을 사용하세요.

기본 세트는 바닥일 뿐, 영화 자체가 아닙니다. 모든 영화(가로든 세로든)에서 쇼트 리스트를 작성하기 전에 Claude가 주도하는 창의적 패스를 먼저 진행하세요. 이 스토리에 기본 세트에 없는 요소(자체 효과, 전환, 사운드, 드로잉 장치)가 무엇인지 결정하고, 이를 만들거나 찾아보고, 적합한 경우에만 기본 효과를 재사용하세요. 엔진은 세로형도 렌더링합니다: 세로 모드.

스토리 영화 제작 파이프라인: 사용자가 Claude가 작성한 가이드를 기반으로 약 150장의 정지 이미지를 만들고, Claude가 그 이미지들로 대본을 작성하며, 음성이 이를 읽고, Python 엔진이 모든 사진을 단어에 맞춰 생동감 있게 만듭니다. 참조 영화는 Chadwick 예제입니다 (examples/chadwick/, 카네기의 딸: 앤드류 카네기의 비밀 딸로 수백만 달러를 빌린 여성). 이 예제의 이미지, 대본, 음성, 점수, 쇼트 리스트 및 70초 효과 테스트 비디오(examples/chadwick/video/chadwick_effects_test.mp4)는 모든 기술을 보여줍니다.

**REPO**는 이 스킬의 폴더(이 파일이 있는 곳)입니다. **PY**는 이곳의 Python입니다: macOS/Linux에서는 REPO/.venv/bin/python, Windows에서는 REPO\.venv\Scripts\python.exe입니다. 항상 프로젝트의 tools/ 폴더에서 PY로 엔진 명령을 실행하세요. .venv가 없으면 먼저 설정하세요: references/install.md에 있는 설치 런북(Claude용) 을 단계별로 따르세요(시스템 전체 설치 전에 물어보세요. 사용자가 자신의 API 키를 붙여넣습니다).

기본 규칙

  • 사용자의 승인 없이 절대 렌더링하지 마세요. stills.py(약 30초 내 연락처 시트)로 확인하세요. 배치 렌더링, 미리보기, 엔딩 및 최종 결합은 몇 분에서 몇 시간이 걸릴 수 있습니다. 렌더링할 내용과 예상 시간을 말하고, 승인을 기다리세요. 변경되지 않았거나 사용자가 원하지 않는 한 이미 렌더링된 것은 다시 렌더링하지 마세요.
  • 프로젝트당 한 번 사용자 경로를 물어보세요: 어떤 이미지 도구(references/image-generation.md), 음성(Gemini TTS 또는 자체 음성: references/voice.md), 음악(Lyria 또는 자체 음악: references/music.md), 사용자의 니치 및 채널 이름, 그리고 채널을 그들의 것으로 만드는 세 가지 선택: 이미지 스타일(오프너: 구아슈, 플랫 편집, 느와르, 초크, 코믹, 스토리북, 블루프린트 또는 자체 스타일; 캐릭터 유무), 엔진 룩(YTF_LOOK: 구아슈, 클린, 느와르, 초크, 코믹, 스토리북, 블루프린트; 단일 값의 경우 look.json) 및 포맷(story, explainer, countdown, rise-fall, storytime, kids, summary, case-study, news): references/art-styles.md, references/formats.md. 예제의 파스텔 실제 이야기 스타일을 기본값으로 사용하지 마세요. 사용자가 선호하는 것이 없으면 하나의 짧은 표로 옵션을 보여주고 니치에 맞는 하나를 추천하세요.
  • 사용자의 니치는 그들의 것입니다. 역사나 예제 주제로 유도하지 마세요. 예제는 기술에 대한 참조일 뿐, 주제에 대한 템플릿이 아닙니다.
  • Windows: 슬래시(/)가 있는 경로도 작동합니다. 긴 작업은 백그라운드에서 실행됩니다. 속도 설정은 references/performance.md를 참조하세요. macOS 전용 도구를 가정하지 마세요.
  • .env 외부의 파일에는 API 키를 저장하지 마세요. 실제 사진이나 사운드 파일은 사용자의 확인 후에만 다운로드하세요(파일, 출처, 크기 및 라이선스 명시).

스택

작업도구위치
리서치웹 검색, 출처가 포함된 검증된 사실 목록; 확인 불가능한 항목 표시OUTLINE.md
이미지Claude의 가이드에서 사용자의 이미지 도구IMAGE_GUIDE.md (+ API용 IMAGE_PROMPTS.jsonl), incoming/
대본Claude, 이미지 가이드를 기반으로 작성, 비트당 ## 단락, [SHOTS: …] 노트SCRIPT.md
음성Gemini TTS(음성 Orus, 천천히 읽기 → 1.25배, 일시 정지 제한) 또는 import_voice.py를 통한 사용자 오디오tools/voice.py, tools/import_voice.py
단어 타이밍Whisper: mlx-whisper(Apple Silicon) 또는 faster-whisper(Windows/Intel/Linux)voice/<batch>_words.json
음악Lyria(Gemini API), 섹션당 하나의 큐, 또는 사용자의 라이선스 트랙tools/music.py → audio/music/
영화 엔진Python(OpenCV, Pillow, NumPy, SciPy), After Effects 불필요tools/film.py, fx2.py, seq.py, signature.py, wr.py, kit.py
쇼트 리스트seq.py의 배치당 하나의 파일, 해당 배치의 단어 시간에 큐됨tools/<story>.py + tools/shots_bN.py
렌더링병렬, 머신에 맞게 크기 조정, 낮은 우선순위tools/render_all.py
엔딩사용자 자체 애니메이션 사인오프(예: cta.py)renders/cta.mp4
최종 결합배치 + 엔딩, 연속 점수 하나, −14 LUFS / −2 dBTPtools/final.py
더빙기본적으로 스페인어 및 프랑스어: Gemini 번역 + TTS를 약 3분 청크로, 영어 슬롯에 맞춤tools/dub.py
썸네일가이드에서 사용자의 이미지 도구references/thumbnails.md

프로젝트는 YTF_WORKSPACE(기본값 ~/yt-film-projects/<story>/)에 저장되며, PY REPO/scripts/new_project.py <story>로 생성됩니다. 이 명령은 엔진을 tools/에 복사하고 모든 폴더를 만듭니다. 설정은 .env에 있습니다(프로젝트 우선, 그다음 REPO): GEMINI_API_KEY, YTF_CHANNEL, 음성/모델 이름, 속도 조절(.env.example에 전체 목록). engine/ytf.py는 모든 OS에서 글꼴, 키, Whisper 및 공유 아트를 찾습니다.

작업 순서

  1. 스토리 선택(주어지지 않은 경우): 갭 확인과 함께 3~5개의 후보(references/story-finding.md). 포맷과 룩을 사용하여 프로젝트 시작: PY REPO/scripts/new_project.py <name> --format <format> --look <look>(포맷의 스파인 템플릿을 OUTLINE.md에 쓰고, YTF_FORMAT 및 YTF_LOOK을 .env에 씁니다). 전체 가이드를 작성하기 전에 stills.py로 두 이미지에서 새 스타일을 테스트하세요(references/art-styles.md, 마지막 섹션).
  2. 스토리 및 사실: 리서치; 출처가 포함된 OUTLINE.md. 확인되지 않은 것은 표시하고 나중에 우회하여 표현(

관련 스킬