shorts-video-maker - SKILL.md Agent Skill

name: shorts-video-maker description: | YouTube 영상에서 쇼츠 클립 3개를 자동 제작합니다. yt-dlp, whisper, ffmpeg 파이프라인을 사용합니다. "쇼츠 만들어줘", "영상 클립 추출해줘" 요청 시 사용합니다.

쇼츠 비디오 메이커 스킬

YouTube 원본 영상에서 하이라이트 구간을 추출하여 9:16 세로형 쇼츠 클립을 제작합니다.

필수 요구사항

시스템 의존성

Python 3.8+
yt-dlp (YouTube 다운로드)
ffmpeg (영상 편집)
OpenAI Whisper (음성 인식) 또는 Whisper API

설치

pip install yt-dlp openai-whisper
brew install ffmpeg  # macOS
# 또는 apt-get install ffmpeg  # Ubuntu

워크플로우

1단계: 영상 다운로드

python .claude/skills/shorts-video-maker/scripts/download_video.py \
  --url "YOUTUBE_URL" \
  --output ".claude/skills/shorts-video-maker/temp/"

yt-dlp로 최고 화질 영상 다운로드
출력: .claude/skills/shorts-video-maker/temp/video.mp4

2단계: 자막 추출

python .claude/skills/shorts-video-maker/scripts/transcribe.py \
  --input ".claude/skills/shorts-video-maker/temp/video.mp4" \
  --output ".claude/skills/shorts-video-maker/temp/transcript.json"

Whisper로 음성 → 텍스트 변환
타임스탬프 포함 JSON 출력
출력: .claude/skills/shorts-video-maker/temp/transcript.json

3단계: 쇼츠 대본 참조

outputs/shorts-scripts/shorts-01.md ~ shorts-03.md 읽기
대본의 "원본 영상 참조" 섹션에서 구간 정보 확인
또는 transcript.json에서 매칭되는 구간 자동 탐색

4단계: 클립 추출 및 편집

python .claude/skills/shorts-video-maker/scripts/cut_shorts.py \
  --input ".claude/skills/shorts-video-maker/temp/video.mp4" \
  --transcript ".claude/skills/shorts-video-maker/temp/transcript.json" \
  --scripts "outputs/shorts-scripts/" \
  --output "outputs/shorts-videos/"

ffmpeg로 구간 클리핑
9:16 비율 크롭
자막 하드코딩 (선택)
출력: outputs/shorts-videos/shorts-01.mp4 ~ shorts-03.mp4

쇼츠 스펙

영상 규격

해상도: 1080x1920px (세로)
비율: 9:16
길이: 15-60초
포맷: MP4 (H.264)

자막 스타일

위치: 하단 중앙 또는 상단
폰트: 굵은 산세리프
색상: 흰색 + 검정 테두리
크기: 화면 너비의 80%

스크립트 상세

download_video.py

YouTube URL 입력
최고 화질 다운로드
진행률 표시
에러 처리

transcribe.py

오디오 추출
Whisper 모델 로드
세그먼트별 타임스탬프 생성
JSON 형식 출력

cut_shorts.py

시작/종료 시간 기반 클리핑
16:9 → 9:16 변환 (center crop)
자막 오버레이 (선택)
3개 클립 배치 처리

출력

최종 결과물

outputs/shorts-videos/shorts-01.mp4
outputs/shorts-videos/shorts-02.mp4
outputs/shorts-videos/shorts-03.mp4

중간 파일

.claude/skills/shorts-video-maker/temp/video.mp4: 원본 다운로드
.claude/skills/shorts-video-maker/temp/transcript.json: 자막 데이터
.claude/skills/shorts-video-maker/temp/audio.wav: 추출된 오디오

참조 파일

.claude/skills/shorts-video-maker/references/shorts-spec.md: 쇼츠 플랫폼별 스펙
.claude/agents/marketing/shorts-scriptwriter.md: 대본 에이전트 (연동)

사용 예시

# 전체 파이프라인 실행 (프로젝트 루트에서)

# 1. 다운로드
python .claude/skills/shorts-video-maker/scripts/download_video.py \
  --url "https://youtube.com/watch?v=xxxxx" \
  --output ".claude/skills/shorts-video-maker/temp/"

# 2. 자막 추출
python .claude/skills/shorts-video-maker/scripts/transcribe.py \
  --input ".claude/skills/shorts-video-maker/temp/video.mp4" \
  --output ".claude/skills/shorts-video-maker/temp/transcript.json"

# 3. 쇼츠 생성
python .claude/skills/shorts-video-maker/scripts/cut_shorts.py \
  --input ".claude/skills/shorts-video-maker/temp/video.mp4" \
  --transcript ".claude/skills/shorts-video-maker/temp/transcript.json" \
  --scripts "outputs/shorts-scripts/" \
  --output "outputs/shorts-videos/"

주의사항

원본 영상이 16:9가 아닌 경우 크롭 조정 필요
Whisper 모델 크기에 따라 정확도/속도 트레이드오프
GPU 사용 시 처리 속도 향상