Communitygithub.com

video-generation

모든 주제, 아이디어, 스크립트를 구조화된 주제-영상 생성 파이프라인과 MoneyPrinterTurbo의 CLI(cli.py)를 사용하여 완성된 영상으로 전환합니다. 사용자가 영상, 릴스, 쇼츠, 또는 설명 영상을 생성, 스크립트 작성, 스토리보드, 내레이션, 편집을 요청할 때 사용하세요.

video-generation란 무엇인가요?

이 스킬은 생산 수준의 영상 생성 파이프라인을 제공합니다. 주제, 아이디어, 또는 스크립트를 입력받아 MoneyPrinterTurbo의 CLI를 통해 완성된 MP4 영상으로 변환합니다. 사용자와의 협의를 통해 크리에이티브 방향을 설정하고, 스크립트를 작성하며, 숏 리스트(스토리보드)를 생성하고, TTS 음성을 합성하고, 비주얼 자료를 소싱한 후 최종 영상을 조립합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 작동하며, 동적으로 환경에 설치된 다른 스킬(예: 연구, 카피라이팅, 오디오 처리)을 검색하고 사용자의 승인을 받아 파이프라인에 통합합니다. 출력물은 항상 사용자가 지정한 프로젝트 디렉토리에 타임스탬프가 포함된 폴더로 정리되어 전달됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aakashdandekar/Agent-Skills/tree/HEAD/skills/video-generation

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

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

문서

Video Generation Skill (video-generation)

아이디어와 주제를 완성된 고품질 영상으로 변환하는 완전한 프로덕션 등급 파이프라인입니다. 구조화된 크리에이티브 방향 설정(브리핑, 리서치, 스크립트 작성, 숏 리스트)과 MoneyPrinterTurbo의 CLI(cli.py 또는 설정된 별칭)를 통한 로컬 명령줄 조립을 결합합니다.


사전 점검 1: MoneyPrinterTurbo 가용성 및 명령어 확인

영상 생성 파이프라인을 실행하기 전에 MoneyPrinterTurbo가 설치되어 있고 실행 명령어를 확인하세요.

  1. 별칭, 함수, 또는 래퍼 스크립트 확인:

    alias video 2>/dev/null || type video 2>/dev/null || which video 2>/dev/null
    

    셸 또는 PATH에 video 별칭이나 래퍼가 존재하면 직접 사용하세요. (예: video [options])

  2. 별칭이나 명령어가 없으면 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]
        

[!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. 사용자 협의 프로토콜 (계획 수립 전)

영상 생성 계획을 수립하기 전에, 발견된 관련 스킬을 사용자에게 제시하여 의견을 구하세요.

  1. 간단한 예/아니오 질문:

    "설치된 스킬 <skill-name> 을(를) 찾았습니다. 이 스킬은 [특정 작업, 예: 후크 점수 / 오디오 정리 / 챕터링]에 도움이 될 수 있습니다. 이 영상에 사용하시겠습니까? (예 / 아니오)"

  2. 예인 경우: 스킬을 승인된 것으로 표시하고 생성 계획에 포함합니다.
  3. 아니오인 경우: 이유를 물어보세요:

    "알겠습니다. 사용하지 않으시는 이유를 알려주시겠습니까?"

    • 이유를 묻는 것이 중요한 이유: 이유를 통해 중요한 창작 제약 조건을 발견하고 핵심 목표를 명확히 할 수 있습니다. (예: "이미 정확한 스크립트를 작성했습니다", "빠른 후크 중심이 아닌 진지한 다큐멘터리 톤을 원합니다", "오디오의 자연스러운 멈춤을 유지하세요").
    • 그들의 답변을 사용하여 계획을 작성하기 전에 목표에 대한 직접적인 명확성을 얻으세요.

3. 영상 생성 계획 수립

사용자 협의가 완료되면, 이 스킬의 지침, 사용자가 명확히 한 목표/제약 조건, 승인된 스킬을 기반으로 맞춤형 영상 생성 계획을 수립하세요.

  1. 크리에이티브 브리핑: 시청자, 대상 플랫폼, 길이, 화면 비율, 톤 (협의 중 수집된 제약 조건 반영).
  2. 포함된 승인 스킬: 사용자가 선택한 특정 도구/스킬과 그 사용 방법.
  3. 스크립트 및 스토리보드 접근 방식: 후크 전략, 핵심 비트, 계획된 숏 리스트 구조.
  4. 미디어 및 오디오 소싱: 음성 (Edge TTS vs. 로컬 오디오), BGM 볼륨, 비주얼 에셋 (로컬 푸티지 vs. 스톡).
  5. 타임라인 조립: 페이싱, 자막 애니메이션, 전환 효과, 최종 렌더링 사양.

주제-영상 파이프라인

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초 이내에 즉시 시선을 사로잡으세요. 사용자가 후크 평가 또는 카피라이팅 도구를 승인한 경우, 최종 확정 전에 후보 후크를 해당 도구에 실행해 보세요.
  • 구조:
    1. 후크 (0–3초): 대담한 질문이나 놀라운 문장으로 즉시 시선을 사로잡습니다.
    2. 본문 (3–5비트): 핵심 포인트를 논리적으로 진행합니다. 복잡한 종속절 없이 간결한 문장을 사용하세요.
    3. 마무리 / 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. 프로젝트 디렉토리 확인

  1. 활성 프로젝트/작업 공간 디렉토리 확인:
    • 활성 작업 공간 또는 프로젝트 디렉토리가 있는지 확인합니다.
  2. 프로젝트 디렉토리가 없을 경우 대체 프롬프트:
    • 설정되거나 알려진 프로젝트 디렉토리나 작업 공간이 없는 경우, 전달을 최종 확정하기 전에 사용자에게 대상 경로를 입력하도록 요청하세요:

      "활성 프로젝트 또는 작업 공간 디렉토리가 감지되지 않았습니다. 생성된 영상을 어디에 저장하시겠습니까? (대상 폴더 경로를 제공해 주세요)"

2. 출력 폴더 이름 형식

확인된 프로젝트 디렉토리 내에 다음 이름의 전용 폴더를 만듭니다.

video-<짧은-제목>-<날짜시간>/
  • <짧은-제목>: 슬러그화된 2~4단어 제목 (예: deep-sea-creatures, quantum-computing).
  • <날짜시간>: YYYYMMDD-HHMMSS 형식의 현재 타임스탬프 (예: 20261113-171530).
  • 폴더 예시: video-deep-sea-creatures-20261113-171530/

3. 에셋 전달 및 구성

MoneyPrinterTurbo가 내부 작업 저장소에서 렌더링을 완료하면:

  1. 프로젝트 디렉토리에 타임스탬프 폴더를 만듭니다:
    mkdir -p "<project_dir>/video-<짧은-제목>-<날짜시간>"
    
  2. 엔진의 작업 디렉토리(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
  3. 사용자에게 프로젝트 디렉토리 내 최종 .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
--voiceEdge 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: "완벽해, 고마워!"

관련 스킬