Communitygithub.com

스튜디오 비디오 디렉터

스튜디오 수준의 AI 비디오 및 숏폼(Shorts) 제작 파이프라인입니다. 해커톤 데모(16:9), 숏츠/릴스(9:16), 제품 광고, 영화 리뷰, 바이럴 클리핑 등 모든 멀티 씬 내레이션 비디오의 기획, 스크립트 작성, 생성, 조립 및 품질 관리를 위해 사용하세요. 진정한 스테레오 오디오, -14 ~ -16 LUFS 음량, 3~4초마다 시각적 컷, 정적 슬라이드쇼 금지, 엄격한 화면 비율 고정을 강제합니다. 무료 티어는 $0(로컬 FFmpeg + Whisper만 사용); Pro는 멀티 씬 조립, 자동 오디오 덕킹, 자막 번인, 맞춤 템플릿 및 배치 게이팅을 추가합니다.

스튜디오 비디오 디렉터란 무엇인가요?

이 스킬은 개발자와 콘텐츠 제작자가 명확하고 반복 가능한 8단계 워크플로우를 통해 스튜디오 품질의 비디오를 제작할 수 있도록 설계된 구조화된 파이프라인입니다. 해커톤 데모, 제품 광고, 숏폼(Shorts/Reels) 등 모든 유형의 내레이션 비디오를 다루며, 16:9 또는 9:16의 엄격한 화면 비율 고정을 강제합니다. Claude Code, Cursor, Codex 등 AI 코딩 에이전트와 함께 사용하기에 적합하며, 무료 티어에서는 로컬 FFmpeg, Python, faster-whisper를 사용하고, Pro 에디션은 자동 오디오 덕킹, 배치 품질 검사, 자막 번인 등 고급 기능을 제공합니다. 핵심은 사전 제작부터 최종 인코딩 후까지 10가지 품질 게이트(음량, 데드 에어, 컷 간격, 자막 일치 등)를 통과해야 하며, 모든 조건을 충족하지 못하면 빌드 실패로 간주합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rjrajput-web3/studio-video-director-skill/tree/HEAD

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

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

문서

스튜디오 비디오 디렉터은(는) 무엇을 하나요?

실전에서 검증된, 측정 기반의 파이프라인으로 로컬 무료 도구만으로 스튜디오급 비디오를 제작합니다. 아래 모든 규칙은 실제 실패한 빌드(모노 믹스, 과도한 압축 오디오, 슬라이드쇼 숏츠, 잘린 자막, 무음 구간)를 통해 얻은 교훈입니다. 어떤 게이트라도 위반하면 빌드는 실패입니다 — 고치고, 출시하지 마십시오.

이 스킬을 사용해야 할 때

  • 모든 비디오 결과물: 해커톤 데모, 제품 데모, 숏/릴스, 영화 리뷰, 광고, 튜토리얼, 트레일러, 팟캐스트 클립.
  • 렌더링 전: 기획, 스크립트, 스토리보드, 샷 프롬프트.
  • 렌더링 후: 최종 인코딩에 대한 10가지 게이트 사전 전달 점검.
  • 비디오가 "괜찮아 보이지만 아마추어스럽다"고 느껴질 때: 게이트를 실행하고, 실패한 게이트를 수정한 후 재확인하세요. 게이트가 정확한 결함을 알려줍니다.

8단계 워크플로우

  1. 브리핑(Brief) — 한 문단: 대상, 하나의 아이디어, 하나의 CTA, 길이, 화면 비율(하나를 선택하고 고정: 16:9 데모/롱폼 또는 9:16 숏츠/릴스 — 프로젝트 내에서 비율을 절대 혼합하지 마십시오).
  2. 크루 계획(6개 역할) — 감독(비전 + 컷 목록), 작가(스크립트, 샷당 <=30 단어, ~150 wpm), 촬영 감독(카메라 + 프레이밍), 아트 디렉터(팔레트 + 세트), VFX(모션 + 전환), 사운드 디자이너(VO + 음악 + SFX). 각 역할은 생성 전에 서명을 완료해야 합니다.
  3. 스토리보드 + 컷 목록 — 애니메이션 전에 작성합니다. 최소 3~4초마다 시각적 또는 카메라 컷(4초 이상 간격 금지, 하드 실패). 처음 3초 안에 후크: 제목/질문 + 모션. 절대 정적 커버 오프너를 사용하지 마십시오.
  4. 프롬프트(여섯 부분) — 세그먼트당 <=10초, references/prompt-template.md 사용: 지속 시간/포맷, 주제, 장면, 타임스탬프가 있는 비트, 카메라 언어, 사운드/대화, 제약 조건. 세그먼트 간에 주제 설명을 그대로 재사용하십시오.
  5. 세그먼트 생성 — 실제 모션만: 화면 녹화(Playwright, deviceScaleFactor 2, 1920x1080@30fps 데모용), B-롤 또는 애니메이션. 스틸 이미지의 Ken Burns 효과: 숏츠당 최대 한 세그먼트, <=4초, 전체 비디오에는 사용하지 마십시오.
  6. 조립 — 모든 장면을 고정된 프레임으로 정규화(크기 조정 + 패딩, 늘리지 않음), concat 디멀티플렉서로 연결, 오디오 마스터링(Pro: pro-bundle/scripts/assemble_multiscene.py).
  7. 사운드 — 신경망 VO만 사용(edge-tts / studio TTS; gTTS 금지). 음악: 실제 라이선스 트랙(Mixkit / Pixabay / YouTube Audio Library), VO 아래에서 -20dB(숏츠) 또는 -22dB(데모)로 덕킹. 컷에 맞춰 동기화된 실제 디자인 SFX. 합성 배경음/SFX 금지.
  8. 게이트 + 배포 — 최종 인코딩에 대해 scripts/quality_gate.py를 실행합니다. 모든 10개 게이트가 통과해야 합니다. 마스터와 .SRT를 renders/에 저장하고 절대 삭제하지 마십시오.

품질 게이트(10개 모두, 면제 없음)

#게이트규칙
1사양정확한 지속 시간/해상도/fps; 오디오 채널 == 2
2음량통합 -14..-16 LUFS, TP <= -1.5 dBTP, LRA >= 6 LU
3데드 에어0.5초 이상의 무음 금지(단, 1초 이하의 후미 꼬리 제외)
4컷 간격컷 사이 4초 이상 간격 없음
5VO 커버리지faster-whisper 전사가 스크립트 단어의 >= 80%를 포함
6프레임00:02/중간/끝 프레임이 명명된 프레임 체크리스트 통과
7스테레오ffprobe 최종 믹스의 채널 == 2
8실제 음악/SFX사람이 실제 라이선스 음악 + 실제 SFX 확인
9슬라이드쇼 없음4초 이상 정지된 세그먼트 없음
10마스터 보호.SRT 사이드카 존재, *-broken / *-v1 / *-v2 형제 파일 없음

실행:

python3 scripts/quality_gate.py final.mp4 --aspect 16:9 \
  --srt final.srt --script vo-script.txt --frames-dir checks/

개별 게이트:

python3 scripts/audio_lufs_check.py final.mp4
python3 scripts/extract_frames_check.py final.mp4 --aspect 16:9 --frames-dir checks/

자막 규칙

  • 16:9 데모: 별도의 .SRT 사이드카만 사용합니다. 내레이션 자막을 영상에 번인(Burn-in)하지 마십시오. 화면상의 UI 콜아웃은 허용됩니다 — 이는 자막이 아닙니다.
  • 9:16 숏츠/릴스: .SRT 사이드카 및 스타일이 적용된 하단 안전 영역 자막(숏츠 플레이어는 사이드카를 무시합니다; 음소거된 시청자는 화면상의 텍스트가 필요합니다).

명명된 프레임 체크리스트(00:02, 중간, 끝 프레임에 적용)

(a) 가장자리에서 잘린 부분 없음, (b) 프레임의 25% 이상을 차지하는 데드 밴드/빈 영역 없음, (c) 화면상의 모든 단어가 휴대폰 크기에서 읽을 수 있음, (d) 스크립트에 지정된 위치에 자막이 표시됨, (e) 플레이스홀더/가짜 UI 텍스트 없음, (f) 주제가 프레임을 채움.

$0 도구(무료 티어)

  • ffmpeg / ffprobe 8.x, Python 3.10+, faster-whisper(로컬, CPU).
  • 선택적 외부 무료 크레딧만 사용(OpusClip / Vizard / Quso / 2short 무료 티어) — 이 저장소의 어떤 스크립트에서도 호출되지 않으며, 유료 API 없음, 가입 불필요, 카드 필요 없음.
  • 이 저장소에는 자격 증명, API 키, 개인 데이터가 포함되어 있지 않습니다.

Pro 에디션

pro-bundle/ 추가 기능: 2패스 loudnorm 마스터링을 통한 멀티 씬 FFmpeg 조립, VO + 음악 자동 덕킹, Whisper .SRT + 번인 자막 빌더, 18개 맞춤 템플릿, 단일 명령 배치 게이트. 자세한 내용은 README.md(Pro 에디션 섹션) 및 pro-bundle/README.md를 참조하십시오.

관련 스킬