O que Studio Video Director faz?
Uma pipeline testada em batalha e baseada em medições para produzir vídeos com qualidade de estúdio usando ferramentas locais gratuitas. Cada regra abaixo foi paga com construções reais que falharam: mixes mono, áudio supercomprimido, Shorts slideshow, legendas cortadas e ar morto. Uma construção que violar qualquer verificação é uma construção falha — corrija, não envie.
Quando usar esta skill
- Qualquer entrega de vídeo: demo de hackathon, demo de produto, Short/Reel, análise de filme, comercial, tutorial, trailer, clipe de podcast.
- Antes da renderização: planejamento, roteiro, storyboard, prompts de cena.
- Após a renderização: a verificação de 10 pontos antes da entrega no ENCODE FINAL.
- Quando um vídeo "parece bom, mas parece amador": execute a verificação, corrija as verificações que falham, verifique novamente. A verificação nomeia o defeito exato.
Fluxo de trabalho de 8 etapas
- Briefing — um parágrafo: público, uma ideia, um CTA, duração, proporção (escolha UMA e trave:
16:9demo/formato longo ou9:16Shorts/Reels — NUNCA misture proporções em um projeto). - Plano de equipe (6 funções) — Diretor (visão + lista de cortes), Roteirista (script, <=30 palavras por cena, ~150 ppm), DP (câmera + enquadramento), Diretor de Arte (paleta + cenário), VFX (movimento + transições), Designer de Som (VO + música + SFX). Cada função aprova antes da geração.
- Storyboard + lista de cortes — escrita ANTES de animar. Um corte visual ou de câmera a cada 3-4 s (sem lacuna > 4 s, falha grave). Gancho nos primeiros 3 s: título/pergunta + movimento. Nunca uma abertura de capa estática.
- Prompts (seis partes) — por segmento, <=10 s cada, usando
references/prompt-template.md: duração/formato, assunto, cena, batidas com timestamps, linguagem de câmera, som/diálogo, restrições. Reutilize a descrição do assunto VERBATIM entre segmentos. - Gerar segmentos — apenas movimento real: gravação de tela (Playwright, deviceScaleFactor 2, 1920x1080@30fps para demos), B-roll ou animação. Ken Burns em imagens fixas: no máximo UM segmento de <=4 s por Short, nunca o vídeo inteiro.
- Montar — normalizar cada cena para o quadro travado (redimensionar + preencher, nunca esticar), unir com o demuxer concat, masterizar o áudio (Pro:
pro-bundle/scripts/assemble_multiscene.py). - Som — apenas VO neural (edge-tts / studio TTS; gTTS proibido). Música: uma faixa licenciada real (Mixkit / Pixabay / YouTube Audio Library), com redução de -20 dB (Shorts) ou -22 dB (demos) abaixo do VO. SFX reais sincronizados com cortes. Bases sintetizadas/SFX proibidos.
- Verificação + entrega — execute
scripts/quality_gate.pyno ENCODE FINAL. Todas as 10 verificações devem PASSAR. Salve o mestre + .SRT emrenders/e nunca os descarte.
Verificações de qualidade (todas as 10, sem exceções)
| # | Verificação | Regra |
|---|---|---|
| 1 | Especificações | duração/resolução/fps exatos; canais de áudio == 2 |
| 2 | Loudness | integrado -14..-16 LUFS, TP <= -1,5 dBTP, LRA >= 6 LU |
| 3 | Ar morto | nenhum silêncio >= 0,5 s, exceto uma cauda final <= 1 s |
| 4 | Cadência de corte | nenhuma lacuna entre cortes > 4 s |
| 5 | Cobertura de VO | transcrição faster-whisper cobre >= 80% das palavras do script |
| 6 | Quadros | quadros 00:02 / meio / fim passam na lista de verificação nomeada |
| 7 | Estéreo | ffprobe canais == 2 no mix final |
| 8 | Música/SFX real | humano atesta música licenciada real + SFX real |
| 9 | Sem slideshow | nenhum segmento congelado > 4 s |
| 10 | Proteção do mestre | arquivo .SRT sidecar presente, nenhum irmão *-broken / *-v1 / *-v2 |
Execute:
python3 scripts/quality_gate.py final.mp4 --aspect 16:9 \
--srt final.srt --script vo-script.txt --frames-dir checks/
Verificações individuais:
python3 scripts/audio_lufs_check.py final.mp4
python3 scripts/extract_frames_check.py final.mp4 --aspect 16:9 --frames-dir checks/
Regra de legendas
- Demos 16:9: apenas arquivo
.SRTsidecar SEPARADO. Zero legendas de narração queimadas. Chamadas de UI na tela são permitidas — não são legendas de legenda. - Shorts/Reels 9:16: arquivo
.SRTsidecar E legendas estilizadas na zona segura inferior (o player de Shorts ignora sidecars; espectadores com som mudo precisam de texto na tela).
Lista de verificação de quadros nomeados (aplicar aos quadros 00:02, meio, fim)
(a) nada cortado em qualquer borda, (b) nenhuma faixa morta/área vazia > 25% do quadro, (c) toda palavra na tela legível em tamanho de celular, (d) legendas visíveis onde o script diz que devem estar, (e) nenhum texto de UI placeholder/falso, (f) assunto preenche o quadro.
Ferramentas a $0 (nível gratuito)
- ffmpeg / ffprobe 8.x, Python 3.10+, faster-whisper (local, CPU).
- Créditos gratuitos externos opcionais apenas (OpusClip / Vizard / Quso / 2short níveis gratuitos) — nunca invocados por nenhum script neste repositório, nunca uma API paga, nunca um cadastro, nunca um cartão.
- Este repositório NÃO contém credenciais, NÃO contém chaves de API, NÃO contém dados pessoais.
Edição Pro
pro-bundle/ adiciona: montagem FFmpeg multicena com masterização loudnorm de duas passagens, redução automática de volume de VO + música, construtor de .SRT Whisper + legendas queimadas, 18 modelos de nicho e uma verificação em lote com um comando. Consulte README.md (seção Edição Pro) e pro-bundle/README.md.