video-layer-skill은(는) 무엇을 하나요?
프로덕션용 멀티 에이전트 Claude Code 스킬 — 음성 해설 MP3를 전체 화이트보드 설명 YouTube 에피소드로 변환합니다. 디스크 기반 브리핑 + SHA256 검증, 2단계 생성 게이트, 비전 리뷰 루프를 포함합니다.
개요
이 스킬은 Claude Code 내에서 실행되는 멀티 에이전트 파이프라인으로, 음성 해설 오디오(MP3)를 입력받아 완전한 화이트보드 스타일의 설명 YouTube 비디오 에피소드를 자동 생성합니다. 복잡한 멀티미디어 콘텐츠 생성을 위해 설계된 프로덕션 등급 워크플로우입니다.
핵심 기능
- 디스크 기반 브리핑: 모든 작업은 로컬 디스크에 저장된 브리핑 파일(
brief.json)을 기반으로 합니다. - SHA256 검증: 파일 무결성을 보장하기 위해 SHA256 해시 검증을 사용합니다.
- 게이트 2웨이브 생성:
- 1웨이브: 스크립트, 비주얼 구성, 장면 목록 생성
- 2웨이브: 세부 비주얼, 애니메이션, 전환 효과 보강
- 비전 리뷰 루프: 생성된 비디오의 핵심 프레임을 캡처하여 시각적 품질을 검토하고 피드백을 반영합니다.
- 멀티 에이전트 협업: 여러 Claude Code 에이전트가 각각의 역할을 분담하여 효율적으로 작업을 수행합니다.
지원 플랫폼
- Claude Code (권장)
- 유사한 명령 실행 및 파일 작업을 지원하는 다른 AI 코딩 도구에서도 사용할 수 있습니다.
작동 방식
- 입력 준비: 사용자가 음성 해설 MP3 파일과 선택적 브리핑 파일을 제공합니다.
- 무결성 검증: SHA256 해시를 사용하여 파일 변조 여부를 확인합니다.
- 1웨이브 생성 (아이디어 단계):
- 오디오를 텍스트로 변환 (음성-텍스트)
- 스크립트 및 비주얼 개요 생성
- 장면별 스토리보드 작성
- 게이트 통과 확인: 1웨이브 결과를 검증하고 문제가 있으면 수정 후 재시도합니다.
- 2웨이브 생성 (세부 단계):
- 각 장면의 세부 비주얼 요소 생성
- 전환 및 애니메이션 계획 수립
- 최종 렌더링 설정 준비
- 비전 리뷰 루프:
- 렌더링된 비디오에서 주요 프레임 캡처
- 시각적 일관성, 브랜딩, 품질 검토
- 필요시 수정 명령 실행
- 최종 출력: 완전한 YouTube 에피소드(MP4)와 메타데이터(설명, 썸네일, 태그 등) 생성
설정 방법
-
Claude Code 환경에 스킬을 추가합니다:
# Clone the skill repository git clone https://github.com/Alexander-Kz/video-layer-skill.git # Set up required environment cd video-layer-skill -
필요한 의존성을 설치합니다:
pip install -r requirements.txt # Or if using npm: npm install -
설정 파일(
config.json)을 수정하여 API 키, 출력 디렉토리 등을 구성합니다:{ "outputDir": "./output", "tempDir": "./temp", "sttProvider": "whisper", "ttsProvider": "elevenlabs", "renderEngine": "manim" }
사용 예시
# 기본 사용법: MP3 파일을 입력으로 제공
claude video-layer-skill --input lecture.mp3 --brief brief.json
# SHA256 검증 활성화
claude video-layer-skill --input lecture.mp3 --brief brief.json --verify
# 1웨이브만 실행 (스크립트 생성까지만)
claude video-layer-skill --input lecture.mp3 --wave 1
# 비전 리뷰 루프 건너뛰기
claude video-layer-skill --input lecture.mp3 --brief brief.json --skip-vision
환경 변수
| 변수명 | 설명 | 필수 여부 |
|---|---|---|
OPENAI_API_KEY | OpenAI API 키 (음성-텍스트 변환 등) | 예 |
ELEVENLABS_API_KEY | ElevenLabs API 키 (추가 음성 합성) | 아니요 |
OUTPUT_DIR | 최종 비디오 출력 디렉토리 | 아니요 (기본값: ./output) |
TEMP_DIR | 임시 파일 디렉토리 | 아니요 (기본값: ./temp) |
VERIFY_CHECKSUM | SHA256 검증 활성화 (true/false) | 아니요 |
프로젝트 구조
video-layer-skill/
├── SKILL.md # 이 파일
├── brief.json # 예시 브리핑 템플릿
├── config.json # 설정 파일
├── scripts/
│ ├── wave1-generate.sh # 1웨이브 생성 스크립트
│ ├── wave2-enhance.sh # 2웨이브 보강 스크립트
│ └── vision-review.sh # 비전 리뷰 스크립트
├── src/
│ ├── audio_processor.py # 오디오 처리 모듈
│ ├── scene_generator.py # 장면 생성 모듈
│ └── video_renderer.py # 비디오 렌더링 모듈
└── templates/
└── whiteboard/
└── style.css # 화이트보드 스타일 템플릿
문제 해결
- SHA256 검증 실패: 입력 파일이 손상되었거나 변경되었습니다. 원본 파일을 다시 다운로드하세요.
- 비전 리뷰 실패: 생성된 비디오의 프레임 캡처 문제입니다. 임시 디렉토리를 비우고 다시 시도하세요.
- 1웨이브 게이트 차단: 스크립트 또는 비주얼 개요가 품질 기준을 충족하지 못합니다. 브리핑 파일을 수정하고 다시 실행하세요.
라이선스
MIT License
기여
이슈 또는 풀 리퀘스트를 통해 언제든지 기여해 주세요. 스킬 개선을 위한 제안을 환영합니다.