Video Generation Skill (video-generation)
아이디어와 주제를 완성된 고품질 영상으로 변환하는 완전한 프로덕션 등급 파이프라인입니다. 구조화된 크리에이티브 방향 설정(브리핑, 리서치, 스크립트 작성, 숏 리스트)과 MoneyPrinterTurbo의 CLI(cli.py 또는 설정된 별칭)를 통한 로컬 명령줄 조립을 결합합니다.
사전 점검 1: MoneyPrinterTurbo 가용성 및 명령어 확인
영상 생성 파이프라인을 실행하기 전에 MoneyPrinterTurbo가 설치되어 있고 실행 명령어를 확인하세요.
-
별칭, 함수, 또는 래퍼 스크립트 확인:
alias video 2>/dev/null || type video 2>/dev/null || which video 2>/dev/null셸 또는 PATH에
video별칭이나 래퍼가 존재하면 직접 사용하세요. (예:video [options]) -
별칭이나 명령어가 없으면 MoneyPrinterTurbo의
cli.py를 동적으로 찾습니다:find ~ -name "cli.py" -path "*/MoneyPrinterTurbo/*" 2>/dev/null | head -n 1- 발견된 디렉토리(예:
~/Applications/MoneyPrinterTurbo)에서:- 가상 환경 Python 인터프리터를 식별하세요. (예:
<MoneyPrinterTurbo_DIR>/.venv/bin/python)..venv가 없으면 시스템python3으로 대체합니다. - 직접 실행 명령어를 구성하세요:
<MoneyPrinterTurbo_DIR>/.venv/bin/python <MoneyPrinterTurbo_DIR>/cli.py [options]
- 가상 환경 Python 인터프리터를 식별하세요. (예:
- 발견된 디렉토리(예:
[!IMPORTANT] 별칭과 MoneyPrinterTurbo의
cli.py를 모두 찾을 수 없는 경우, 중단하고 사용자에게 MoneyPrinterTurbo를 먼저 설치하도록 안내하세요:"영상 조립 및 렌더링에 MoneyPrinterTurbo가 필요하지만 시스템에서 찾을 수 없습니다. 영상 생성을 진행하기 전에 https://github.com/harry0703/MoneyPrinterTurbo 에서 먼저 설치해 주세요."
사전 점검 2: Ollama 서비스 상태 확인 (로컬 LLM 사용 시)
스크립트 생성이 로컬 또는 클라우드 Ollama 모델을 사용하도록 설정된 경우 Ollama 서비스/프로세스가 활성 상태인지 확인하세요.
systemctl is-active --quiet ollama || pgrep -x ollama > /dev/null
[!IMPORTANT] Ollama가 필요하지만 실행 중이 아닌 경우, 중단하고 사용자에게 서비스를 시작하도록 안내하세요:
"Ollama 서비스가 현재 실행 중이 아닙니다. 다음 명령어로 시작해 주세요:"
sudo systemctl start ollama(Ollama Cloud 모델을 사용하는 경우
ollama signin이 완료되었는지도 확인하세요.)
사전 점검 3: 동적 스킬 검색 및 계획 수립
에이전트에 특정 외부 스킬이 설치되어 있다고 가정하지 마십시오. 다른 환경이나 사용자는 다양한 스킬 세트를 가지고 있습니다.
대신 환경을 동적으로 검사하고, 영상 파이프라인에 도움이 될 수 있는 설치된 스킬을 식별한 다음, 결과를 종합하여 **영상 생성 계획(Video Generation Plan)**을 수립하세요.
1. 사용 가능한 스킬 찾기 및 검사
에이전트의 설치된 스킬 디렉토리 또는 구성을 탐색하고 검사하세요. 다음 작업을 지원할 수 있는 스킬을 식별하세요.
- 연구 및 아이디어 발상: 주제 발견, 사실 조사, 도메인 분석, 문헌 조회.
- 카피라이팅 및 스크립팅: 후크 구성, 창의적 글쓰기, 스크립트 검토, 페르소나/음성 프로파일링.
- 오디오 및 음성: 오디오 정리, 대본 분석, 무음 제거, 맞춤형 TTS.
- 비주얼 및 에셋: 코드 스니펫 렌더링, UI 워크스루, 다이어그램, 이미지 생성.
- 패키징 및 SEO: 제목/썸네일 평가, 검색 메타데이터, 영상 챕터 생성.
2. 사용자 협의 프로토콜 (계획 수립 전)
영상 생성 계획을 수립하기 전에, 발견된 관련 스킬을 사용자에게 제시하여 의견을 구하세요.
- 간단한 예/아니오 질문:
"설치된 스킬
<skill-name>을(를) 찾았습니다. 이 스킬은 [특정 작업, 예: 후크 점수 / 오디오 정리 / 챕터링]에 도움이 될 수 있습니다. 이 영상에 사용하시겠습니까? (예 / 아니오)" - 예인 경우: 스킬을 승인된 것으로 표시하고 생성 계획에 포함합니다.
- 아니오인 경우:
이유를 물어보세요:
"알겠습니다. 사용하지 않으시는 이유를 알려주시겠습니까?"
- 이유를 묻는 것이 중요한 이유: 이유를 통해 중요한 창작 제약 조건을 발견하고 핵심 목표를 명확히 할 수 있습니다. (예: "이미 정확한 스크립트를 작성했습니다", "빠른 후크 중심이 아닌 진지한 다큐멘터리 톤을 원합니다", "오디오의 자연스러운 멈춤을 유지하세요").
- 그들의 답변을 사용하여 계획을 작성하기 전에 목표에 대한 직접적인 명확성을 얻으세요.
3. 영상 생성 계획 수립
사용자 협의가 완료되면, 이 스킬의 지침, 사용자가 명확히 한 목표/제약 조건, 승인된 스킬을 기반으로 맞춤형 영상 생성 계획을 수립하세요.
- 크리에이티브 브리핑: 시청자, 대상 플랫폼, 길이, 화면 비율, 톤 (협의 중 수집된 제약 조건 반영).
- 포함된 승인 스킬: 사용자가 선택한 특정 도구/스킬과 그 사용 방법.
- 스크립트 및 스토리보드 접근 방식: 후크 전략, 핵심 비트, 계획된 숏 리스트 구조.
- 미디어 및 오디오 소싱: 음성 (Edge TTS vs. 로컬 오디오), BGM 볼륨, 비주얼 에셋 (로컬 푸티지 vs. 스톡).
- 타임라인 조립: 페이싱, 자막 애니메이션, 전환 효과, 최종 렌더링 사양.
주제-영상 파이프라인
flowchart TD
A["1. 환경에서 사용 가능한 스킬 검사"] --> B{"2. 사용자 협의 프로토콜\n후보 스킬에 대한 의견 질문 (예 / 아니오)"}
B -- "아니오" --> C["'왜 안 되나요?' 질문\n(목표 및 제약 조건 명확히 함)"]
C --> D["3. 영상 생성 계획 수립\n(지침 + 명확해진 목표 기반)"]
B -- "예" --> E["후보 스킬 승인"]
E --> D
D --> F["4. 연구 및 스크립트 작성"]
F --> G["5. 숏 리스트 (핵심 스토리보드)"]
G --> H["6. 음성 합성 (TTS / 오디오)"]
H --> I["7. 장면별 비주얼 (스톡 / 로컬 / 모션)"]
I --> J["8. 타임라인 조립 (MoneyPrinterTurbo CLI)"]
J --> K["9. QC, 메타데이터 및 최종 MP4 전달"]
단계별 파이프라인 지침
1. 브리핑 명확히 하기
코드나 미디어를 생성하기 전에 창작 파라미터를 확정하세요. 사용자가 명시적으로 제공하지 않은 경우, 주제와 플랫폼을 기반으로 합리적인 기본값을 유추하세요.
- 시청자: 누가 시청하는가? (일반 대중, 학생, 개발자, 구매자)
- 음성 및 톤 프로필: 사용자가 스타일 가이드, 톤 선호도, 또는 페르소나 제약 조건을 제공했는지 확인하세요.
- 대상 길이:
- 숏폼: 15초–60초 (TikTok, IG Reels, YouTube Shorts)
- 미드폼: 1–3분 (제품 데모, 빠른 설명 영상)
- 설명 영상: 3–5분 (심층 분석, 튜토리얼)
- 화면 비율:
9:16(모바일 세로 / Reels / Shorts / TikTok) — 기본값16:9(가로 / YouTube / 데스크톱 / 프레젠테이션)1:1(정사각형 / Instagram / LinkedIn 피드 게시물)
- 톤: 캐주얼, 에너제틱, 권위적, 내러티브, 유머러스.
- 플랫폼: 페이싱, 폰트 크기, 캡션 스타일링, 후크 강도 결정.
2. 주제 연구
검증된 사실, 매력적인 후크, 정확한 데이터 포인트를 수집하세요.
- 사실 / 최신 이벤트: 검색 도구를 사용하여 날짜, 통계, 고유 명사, 핵심 주장을 확인하세요.
- 에버그린 / 개념적: 3–5개의 놀랍거나 가치 높은 통찰력을 구성하세요.
- 후크 식별: 처음 3초 이내에 주의를 끌 가장 흥미로운 각도 (계획에서 승인된 연구/아이디어 발상 스킬 활용).
3. 스크립트 작성
읽기용이 아닌 음성 오디오용으로 특별히 포맷된 내레이션을 작성하세요.
- 페이싱 경험 법칙: 분당 ~130–150단어 (초당
2.22.5단어). 30초 숏은 ~65–75단어 필요; 60초 영상은 ~130–150단어 필요. - 후크 검증: 처음 3초 이내에 즉시 시선을 사로잡으세요. 사용자가 후크 평가 또는 카피라이팅 도구를 승인한 경우, 최종 확정 전에 후보 후크를 해당 도구에 실행해 보세요.
- 구조:
- 후크 (0–3초): 대담한 질문이나 놀라운 문장으로 즉시 시선을 사로잡습니다.
- 본문 (3–5비트): 핵심 포인트를 논리적으로 진행합니다. 복잡한 종속절 없이 간결한 문장을 사용하세요.
- 마무리 / CTA (마지막 3–5초): 명확한 요점 또는 행동 유도.
- 음성 내레이션 텍스트 내에서 마크다운 서식, 이모지, 괄호, 인용을 피하세요.
4. 스크립트를 숏 리스트로 분할 (핵심 요소)
숏 리스트는 스크립트와 비주얼 및 오디오 생성을 연결합니다. 스크립트를 장면(일반적으로 3~6초)으로 분할하세요.
[!IMPORTANT] 숏 리스트는 가장 중요한 산출물입니다. 장면 텍스트, 비주얼 설명, 타이밍이 잘 구조화되면 다운스트림 생성 및 조립이 원활하고 결정론적으로 진행됩니다.
숏 리스트 템플릿:
| 장면 # | 내레이션 라인 | 비주얼 설명 / 검색어 | 화면 텍스트 | 예상 길이 |
|---|---|---|---|---|
| 1 (후크) | "깊은 바다 속, 생명체들은 스스로 빛을 만듭니다." | 칠흑 같은 심해에서 빛나는 생물 발광 해파리 | 심해의 비밀 | 4초 |
| 2 (비트 1) | "심해 동물의 75% 이상이 생물 발광을 합니다." | 어둠 속에서 움직이는 빛나는 아귀 미끼 | 75%의 생명체 | 4초 |
| 3 (비트 2) | "그들은 화학 반응을 이용해 소통하고, 사냥하며, 위장합니다." | 오징어 맥동하는 파란색 발광포의 매크로 샷 | 자연의 빛 | 5초 |
| 4 (마무리) | "팔로우하여 심연에 숨겨진 더 많은 비밀을 발견하세요." | 잠수정 조명이 심해 절벽을 비추는 모습 | 더 알아보기 | 3초 |
5. 음성 생성
내레이션에서 음성을 합성하세요.
- 타이밍 권위 규칙: 생성된 오디오 파일의 실제 길이 (4단계의 예상 길이가 아님)가 장면 페이싱 및 비주얼 컷의 결정적인 타임라인 앵커가 됩니다.
- 통합 실행에서 MoneyPrinterTurbo는 Edge TTS(무료, 고품질)를 통해 TTS를 자동으로 처리합니다.
- 맞춤형 음성 또는 사전 녹음된 오디오의 경우 오디오를 정리하고 (승인된 오디오 정리 스킬 사용)
--custom-audio-file <path>를 제공하세요.
6. 장면별 비주얼 소싱 또는 생성
각 장면 오디오의 정확한 길이에 맞게 비주얼을 일치시키세요.
- 스톡 푸티지: 장면 키워드와 일치하는 Pexels, Pixabay 또는 Coverr 클립.
- 로컬 미디어:
--video-source local --video-materials "clip1.mp4,clip2.mp4"를 통해 제공된 비디오 클립 또는 이미지. - 이미지 모션: 스틸 이미지를 사용할 때 동적 모션(
--image-motion zoom)을 적용하여 시청자 참여를 유지하세요.
7. 타임라인 조립
오디오, 비디오, 자막, 음악을 함께 연결하세요.
- 장면 순서대로 푸티지를 연결합니다. (
--video-concat-mode sequential또는random). - 애니메이션 단어 동기화 자막을 오버레이합니다. (
--subtitle-display-mode word_by_word). - 내레이션 아래에 눈에 거슬리지 않는 수준으로 배경 음악(BGM)을 믹스합니다. (
--bgm-volume 0.15–0.2). - 장면 전환 효과를 적용합니다. (
--video-transition-mode fade-in,slide-in등).
8. 렌더링, 검토 및 품질 검사(QC)
최종 영상을 전달하기 전에 QC 검사를 실행하세요.
- 타이밍 및 동기화: 비주얼 변경이 음성 주제와 일치합니까?
- 가독성: 배경에 비해 자막을 읽을 수 있습니까? (폰트 크기, 대비, 획 확인).
- 오디오 믹스: 배경 음악 위에서 음성이 명확합니까?
- 안전 영역:
9:16세로 영상에서 UI 오버레이(예: TikTok/Reels 버튼)가 중요한 텍스트를 가리지 않습니까? - 관련 메타데이터 (선택 사항): 계획에서 요청되거나 승인된 경우, 함께 업로드할 메타데이터(예: 제목, 태그, 설명, 챕터 타임스탬프)를 생성합니다.
- 프로젝트 전달: 최종 영상과 에셋을
<project_dir>/video-<short-title>-<datetime>/로 전송합니다.
출력 저장소 및 프로젝트 전달
항상 생성된 최종 영상과 에셋을 내부 엔진 저장소에 묻어두지 않고 사용자의 프로젝트 디렉토리로 구성하여 전달하세요.
1. 프로젝트 디렉토리 확인
- 활성 프로젝트/작업 공간 디렉토리 확인:
- 활성 작업 공간 또는 프로젝트 디렉토리가 있는지 확인합니다.
- 프로젝트 디렉토리가 없을 경우 대체 프롬프트:
- 설정되거나 알려진 프로젝트 디렉토리나 작업 공간이 없는 경우, 전달을 최종 확정하기 전에 사용자에게 대상 경로를 입력하도록 요청하세요:
"활성 프로젝트 또는 작업 공간 디렉토리가 감지되지 않았습니다. 생성된 영상을 어디에 저장하시겠습니까? (대상 폴더 경로를 제공해 주세요)"
- 설정되거나 알려진 프로젝트 디렉토리나 작업 공간이 없는 경우, 전달을 최종 확정하기 전에 사용자에게 대상 경로를 입력하도록 요청하세요:
2. 출력 폴더 이름 형식
확인된 프로젝트 디렉토리 내에 다음 이름의 전용 폴더를 만듭니다.
video-<짧은-제목>-<날짜시간>/
<짧은-제목>: 슬러그화된 2~4단어 제목 (예:deep-sea-creatures,quantum-computing).<날짜시간>:YYYYMMDD-HHMMSS형식의 현재 타임스탬프 (예:20261113-171530).- 폴더 예시:
video-deep-sea-creatures-20261113-171530/
3. 에셋 전달 및 구성
MoneyPrinterTurbo가 내부 작업 저장소에서 렌더링을 완료하면:
- 프로젝트 디렉토리에 타임스탬프 폴더를 만듭니다:
mkdir -p "<project_dir>/video-<짧은-제목>-<날짜시간>" - 엔진의 작업 디렉토리(
storage/tasks/<task_id>/)에서 최종 영상 및 관련 생성 에셋을 프로젝트 폴더로 복사합니다:- 최종 영상:
final-1.mp4$\rightarrow$<project_dir>/video-<짧은-제목>-<날짜시간>/<짧은-제목>.mp4 - 자막:
subtitle.srt$\rightarrow$<project_dir>/video-<짧은-제목>-<날짜시간>/subtitles.srt - 음성 오디오:
audio.mp3$\rightarrow$<project_dir>/video-<짧은-제목>-<날짜시간>/audio.mp3 - 스크립트:
script.json$\rightarrow$<project_dir>/video-<짧은-제목>-<날짜시간>/script.json
- 최종 영상:
- 사용자에게 프로젝트 디렉토리 내 최종
.mp4파일의 직접적이고 클릭 가능한 파일 링크를 제공합니다.
명령어 실행 및 작업 출력
파이프라인은 MoneyPrinterTurbo의 CLI(cli.py 또는 설정된 별칭)에 의해 구동됩니다.
- 명령어 호출:
감지된 별칭/명령어(있는 경우)를 통해 실행하거나 가상 환경 Python 인터프리터로
cli.py를 직접 실행합니다:# 별칭 또는 래퍼가 있는 경우: video [options] # python을 통한 직접 실행: <MoneyPrinterTurbo_DIR>/.venv/bin/python <MoneyPrinterTurbo_DIR>/cli.py [options]
핵심 옵션 참조
| 옵션 | 설명 | 사용 예시 |
|---|---|---|
--topic | 영상의 주제 | --topic "심해 생물 발광의 과학" |
--script | 기존 스크립트 파일 경로 | --script ./script.txt |
--voice | Edge TTS 음성 이름 | --voice en-US-JennyNeural |
--subtitle-display-mode | 자막 표시 모드: word_by_word(단어별) 또는 whole_sentence(전체 문장) | --subtitle-display-mode word_by_word |
--video-concat-mode | 비디오 연결 모드: sequential(순차적) 또는 random(무작위) | --video-concat-mode sequential |
--video-transition-mode | 장면 전환 효과: fade-in, slide-in, none | --video-transition-mode fade-in |
--aspect | 화면 비율: 9:16, 16:9, 1:1 | --aspect 9:16 |
--bgm-volume | 배경 음악 볼륨 (0.0–1.0) | --bgm-volume 0.15 |
--image-motion | 스틸 이미지에 대한 모션 효과 적용: zoom(줌) 또는 none(없음) | --image-motion zoom |
--video-source | 비디오 소스: stock(스톡) 또는 local(로컬) | --video-source stock |
--video-materials | 쉼표로 구분된 로컬 비디오 파일 목록 (--video-source local 필요) | "clip1.mp4,clip2.mp4" |
--custom-audio-file | 사전 녹음된 음성 내레이션 파일 경로 | --custom-audio-file ./narration.wav |
작업 상태 확인
cli.py는 일반적으로 작업 진행 상황을 단계별로 출력합니다:
__ __ _____ _ __ __ _ _
| \/ | ___ _ _|_ _|__ _ (_)_ \/ (_)_ _ ___| |_ ___ _ _
| |\/| |/ _ \| '_| | |/ _ \ ' \| || |\/| | | ' \/ -_) _/ -_) '_|
|_| |_|\___/|_| |_|\___/_||_|_||_| |_|_|_||_\___|\__\___|_|
[날짜시간] [INFO] 작업 생성됨: <task_id>
[날짜시간] [INFO] 스크립트 생성 중...
[날짜시간] [INFO] 음성 생성 중...
[날짜시간] [INFO] 비디오 다운로드 중...
[날짜시간] [INFO] 비디오 생성 중...
[날짜시간] [INFO] 작업 완료: <output_path>
상호 운용성 & 에이전트 확장
이 스킬은 독립형 AI 에이전트 워크플로우로 작동하지만, 더 큰 AI 에이전트 스킬 생태계 내에서 인터페이스하도록 설계되었습니다.
- 스킬 합성: 감지되고 승인된 모든 스킬을 파이프라인에 통합하세요 (예: 후크 최적화를 위한 카피라이팅, 원시 오디오 정리를 위한 오디오 스킬, 검증을 위한 리서치).
- 에이전트 불가지론: 스킬이 Claude Code, Cursor, Codex, 또는 로컬 명령 실행을 지원하는 모든 에이전트의 환경에 있는지 여부에 관계없이 작동합니다.
- 워크플로우 잠금 최소화: 편집 가능한 중간 산출물(스크립트, 자막, 오디오, 조립 전 개별 장면)을 제공하여 사용자 또는 다른 스킬이 최종 렌더링 전에 조정할 수 있도록 합니다.
문제 해결
| 문제 | 가능한 원인 | 해결 방법 |
|---|---|---|
cli.py를 찾을 수 없음 | MoneyPrinterTurbo가 설치되지 않음 | 사용자에게 설치 안내 |
| Ollama 연결 실패 | Ollama 서비스가 실행 중이 아님 | systemctl start ollama |
| TTS 음성 선택 오류 | 지원되지 않는 음성 이름 | 올바른 Edge TTS 음성 이름 확인 |
| 비디오 다운로드 실패 | 스톡 푸티지 서비스를 사용할 수 없음 | 로컬 미디어 파일 사용으로 전환 |
| 자막 타이밍 불일치 | 오디오 길이를 숏 리스트 추정치와 일치시켜야 함 | 실제 오디오 길이를 기반으로 자막 생성 |
| 오디오 믹스 불량 | BGM 볼륨이 너무 높음 | --bgm-volume을 0.15–0.2로 낮춤 |
전체 워크플로우 요약
sequenceDiagram
participant User
participant Agent
participant Env as Environment
participant MPT as MoneyPrinterTurbo
User->>Agent: "심해 생물 발광에 관한 릴스를 만들어 줘"
Agent->>Env: 설치된 스킬 검사
Agent->>User: 사용 가능한 스킬 제시 및 사용 여부 질문
User->>Agent: 예, 리서치 스킬 사용
Agent->>Agent: 브리핑 명확히 함 (길이, 톤, 비율)
Agent->>Env: 주제 연구
Agent->>Agent: 스크립트 작성 (~65단어 / 30초 숏)
Agent->>Agent: 숏 리스트 생성 (4 장면)
Agent->>MPT: `cli.py` 호출 (스크립트, 음성, 비주얼, 조립)
MPT-->>Agent: 렌더링된 에셋 반환
Agent->>User: 출력을 프로젝트 폴더로 구성 및 링크 제공
User->>Agent: "완벽해, 고마워!"