Generate Video Skill

스크립트 기반 숏폼 영상을 자동 생성하는 스킬입니다.

사용법

/generate-video [프로젝트명]

필수 요구사항

Python 패키지

bash
1pip install moviepy pillow numpy

폴더 구조

project/
├── scripts/
│   └── [프로젝트명].md      # 스크립트 파일
├── assets/
│   ├── images/              # 연예인/제품 이미지
│   │   ├── celebrity.jpg
│   │   └── product_1.jpg
│   ├── audio/               # BGM 파일
│   │   └── bgm.mp3
│   └── fonts/               # 폰트 파일
│       └── Pretendard-Bold.ttf
└── output/                  # 출력 폴더

실행 프로세스

Step 1: 스크립트 파싱

1. scripts/[프로젝트명].md 파일 읽기
2. 섹션별 타임코드 추출
3. 자막 텍스트 추출

Step 2: 에셋 준비 확인

• 이미지 파일 존재 확인
• BGM 파일 확인
• 폰트 파일 확인

Step 3: 영상 생성

bash
1python .claude/skills/generate-video/scripts/video_generator.py \
2  --script "scripts/[프로젝트명].md" \
3  --assets "assets/" \
4  --output "output/[프로젝트명].mp4" \
5  --resolution 1080x1920 \
6  --fps 30

Step 4: 검수

• 영상 길이 확인 (60초 이내)
• 자막 가독성 확인
• 오디오 싱크 확인

Python 스크립트 사용법

bash
1# 기본 실행
2python video_generator.py --script script.md --output output.mp4
3
4# 옵션
5--script      스크립트 파일 경로 (필수)
6--assets      에셋 폴더 경로 (기본: assets/)
7--output      출력 파일 경로 (기본: output/video.mp4)
8--resolution  해상도 (기본: 1080x1920)
9--fps         프레임레이트 (기본: 30)
10--preview     미리보기 모드 (저해상도)

영상 스펙

자막 스타일 설정

python
1subtitle_style = {
2    "font": "Pretendard-Bold",
3    "fontsize": 48,
4    "color": "white",
5    "stroke_color": "black",
6    "stroke_width": 2,
7    "position": ("center", 0.85)  # 하단 15% 위치
8}

트러블슈팅

일반적인 오류

1. ImageMagick 필요: brew install imagemagick
2. 폰트 오류: 폰트 경로 확인 또는 시스템 폰트 사용
3. 메모리 부족: --preview 모드로 먼저 테스트

대체 방법

moviepy가 어려운 경우:

1. FFmpeg 직접 사용
2. 편집 지시서만 생성 후 수동 편집

출력 파일

output/
├── [프로젝트명].mp4           # 최종 영상
├── [프로젝트명]_preview.mp4   # 미리보기 (저해상도)
└── [프로젝트명]_log.txt       # 생성 로그

다음 단계

영상 생성 완료 후:

1. /optimize-posting - 포스팅 최적화
2. 수동 검수 및 최종 수정