Communitygithub.com

make-video

스터디 가이드나 주제를 바탕으로 애니메이션이 포함된 음성 나레이션 YouTube Shorts(1080×1920)를 생성합니다. 가이드를 여러 파트로 나누고, 대본을 작성하며, 키워드와 동기화된 장면을 만들고 Kokoro TTS로 음성을 입혀 MP4로 렌더링합니다.

make-video란 무엇인가요?

이 스킬은 사용자가 제공한 학습 가이드나 주제를 분석하여 애니메이션 음성 YouTube Shorts 시리즈를 자동 생성하는 AI 어시스턴트 도구입니다. 사용자가 "짧은 영상 만들어줘", "비디오 생성", "파트 렌더링" 등을 요청할 때 활성화되며, 전체 파이프라인은 Python 가상 환경, Kokoro TTS 엔진, ffmpeg를 활용하여 한 번에 여러 파트를 배치 처리할 수 있습니다. Cursor, Claude Code, Codex 등 다양한 AI 코딩 에이전트와 호환되며, 사용자 승인을 받은 파트 목록을 기반으로 각 파트별로 동적 키네틱 장면(텍스트 박스가 한 열로 쌓이는 방식)을 생성하고, 단어 단위로 동기화된 애니메이션과 음성을 합성하여 1080×1920 해상도의 MP4 파일을 출력합니다. 이 스킬은 특히 교육 콘텐츠, 기술 문서, 스터디 가이드를 매력적인 YouTube Shorts 시리즈로 변환하는 데 특화되어 있으며, 불필요한 반복이나 환영 인사 없이 바로 주제로 들어가는 간결한 대본 작성을 강조합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rana3128/claude-skills-plugins/tree/HEAD/plugins/video-gen/skills/make-video

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

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

문서

음성이 포함된 키네틱 Shorts 만들기

모든 렌더링은 이 파일과 같은 디렉토리에 있는 pipeline/ 번들 파이프라인을 통해 이루어집니다. (스킬이 로드될 때 표시되는 "이 스킬의 기본 디렉토리")

0. 설정 (프로젝트당 한 번)

프로젝트에 video_gen/ 폴더와 kinetic_build.py 파일이 없으면 다음을 실행하여 생성하세요:

mkdir -p video_gen && cp <skill dir>/pipeline/* video_gen/
cd video_gen
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt            # 드로잉 (Python 3.11+)
python3.12 -m venv .venv-tts && .venv-tts/bin/pip install -r requirements-tts.txt  # Kokoro 음성

ffmpeg가 PATH에 있어야 합니다. voice.py는 같은 디렉토리의 .venv-tts에서 TTS 워커를 실행합니다. 모든 명령은 video_gen/ 디렉토리에서 실행하세요.

1. 규칙 읽기

  • DESIGN.md - 키네틱 비주얼 스타일. 엄격한 규칙: 박스는 한 줄 전체 너비로 쌓아야 하며, 절대 나란히 배치하지 않음; 박스 가장자리에 악센트 바 없음; 큰 텍스트; 각 요소는 해당 단어가 발화될 때 나타남; 제목은 한 줄(약 30자)에 맞출 것; 자막(버인드 인 서브타이틀) 없음.
  • PARTS.md - part.md 형식, 나레이션 규칙, 가이드를 분할하는 방법.

디버깅 목적이 아니라면 engine_short.py, templates.py, skin.py는 읽지 마세요.

2. 새 시리즈: 먼저 분할하고 승인 받기

  1. 소스 가이드를 분석하고 파트 목록을 제안하세요 (파트당 하나의 개념, 각 90~125초). 사용자 승인을 위해 멈추세요. 길이를 맞추기 위해 내용을 절대 자르지 말고, 대신 예시와 "이유"를 추가하세요.
  2. 각 <series>/pNN_<slug>/part.md와 시리즈 분석 및 파트 테이블이 포함된 <series>/README.md를 작성하세요.
  3. 시리즈 폴더를 build_part.py의 SERIES에 추가하세요(킥커 + 푸터). 선택적으로 kinetic.py의 MARKS에 로고 마크를 추가할 수 있습니다.
  4. 나레이션 린트: .venv/bin/python build_part.py <part dir> --lint를 실행하고 모든 문제를 수정하세요. 나레이션: 요약 금지, 환영 인사 금지, 바로 주제로 진입; 기호나 코드 없음; 음성을 위해 약어 풀어쓰기; 비트당 최대 45단어.

3. 장면

각 파트는 SCENES를 정의하는 scenes.py 파일을 갖습니다. 두 가지 스타일이 있습니다 (examples/ 참조):

  • 선언적 스테이지 블록 (권장, 빠름): SCENES = K.part(word, tag, chips, [[blocks...], ...])
    • Track, Pipe, Rows, Code, Lanes, Bars, Ring, Fan, Chips, Big, Note 사용
    • 큐는 단어 접두사(이전 블록의 큐 이후 검색), (word, beat) 또는 비트 번호입니다.
    • 예시: examples/p03_*
  • 직접 작성한 Scene 클래스: 블록으로 표현할 수 없는 비유적 표현용. 예시: examples/p01_*
  • 큐 단어를 발화 순서로 나열하세요. 그렇지 않으면 큐가 MISSING으로 표시됩니다.

4. 확인 후 렌더링

.venv/bin/python kinetic_build.py <part dir> --stills /tmp/pNN.png   # 콘택트 시트 + 큐 리포트
.venv/bin/python kinetic_build.py <part dir> --out <series>/output   # 최종 <slug>_voiced.mp4
.venv/bin/python cue_scan.py <series>/p*_*                           # 텍스트 동기화 확인

최종 렌더링 전에 모든 MISSING 큐와 overflow를 수정하세요. 전체 시리즈의 경우 처음 두 파트를 렌더링하여 사용자에게 외관에 대한 확인을 받은 후, 나머지 파트를 한 번에 3개씩 백그라운드에서 실행하세요 (xargs -P 3).

5. 보고

표 형식: MP4 링크, 주제, 길이, 가장 긴 무음 구간 (목표 1초 미만). 시리즈 README에서 렌더링된 파트를 표시하세요. 확인되지 않은 사항(프레임 미확인, 오디오 미청취)을 명확히 말하세요.

절대 하지 말 것

  • 박스를 나란히 배치하지 않음, 가장자리 악센트 바 없음, 작은 텍스트 없음, 자막(버인드 인 서브타이틀) 없음.
  • 비디오별 음성 보정 제안 금지; 동기화는 단어 단위로 이루어지며 일반적임.
  • engine_short.py를 직접 수정하지 말 것; build_part.py가 메모리에서 패치함.

관련 스킬