O que Video Studio faz?
Produção e edição de vídeo de ponta a ponta, além de geração consistente de imagens. Dois modos (combináveis), um padrão de qualidade. Trate isto como trabalho profissional, não como um brinquedo.
0. PRIMEIRO SEMPRE: pré-verificação (não negociável)
Antes de cada trabalho, execute a verificação de ferramentas e escolha o modo.
bash scripts/preflight.sh <ai|footage|all>
A regra de ferro — nunca degrade silenciosamente. Se uma ferramenta/chave que o modo escolhido precisa estiver faltando (ffmpeg, nano-banana, FAL_AI_KEY, ImageMagick para lettering, yt-dlp para URLs de origem…): PARE e pergunte na forma A/B/C — instalar / abordagem diferente / cancelar — e aja de acordo com a resposta. Instale apenas após aprovação. Nunca "pule" uma etapa ou tome um caminho inferior sem avisar. Uma capacidade faltante é uma decisão do usuário, não uma suposição silenciosa.
Primeira vez? Aponte o usuário para
scripts/doctor.sh— uma verificação amigável "a máquina está pronta?" com comandos de instalação por modo.
0.5 Briefing / definição do trabalho (OBRIGATÓRIO, antes do modo)
A pré-verificação checa as ferramentas; o briefing checa o trabalho. Nunca pule — uma suposição errada aqui (sem cânon de marca, sem storyboard) força um retrabalho caro. Percorra este portal explicitamente e relate o que encontrou. Procedimento completo: reference/brand-intake.md.
- Briefing — objetivo (ensinar/lançar/alcance), formato(s) + proporção (16:9 / 9:16), duração, canal, idiomas, prazo. Uma linha: "o que precisa ser entregue?".
- Guia de estilo da marca — já existe? (SEMPRE verifique)
- Sim → adote: extraia cores (hex), tipografia (fontes + pesos), cânon do logotipo (variantes + regras do que não fazer), tom. Pesquise o projeto (
brand/, um site existente, arquivos de logotipo, um guia de design). Nunca adivinhe quando um cânon existe. - Não → crie (após aprovação): proponha um guia de marca mínimo (cores, tipo, uso do logotipo, tom) e salve-o. Não construa com base em uma identidade de marca inventada sem propô-la.
- Sim → adote: extraia cores (hex), tipografia (fontes + pesos), cânon do logotipo (variantes + regras do que não fazer), tom. Pesquise o projeto (
- Leader + encerramento — existe um bracket de abertura/encerramento com a marca para esta marca? Se não: construa uma vez (por
commercial-craft.md) e reutilize por filme. Parte do cânon da marca, não improvisação por vídeo. - Linhas que nunca se cruzam — registre as regras rígidas específicas da marca (ex.: "apenas música real, apenas pessoas reais"). Elas se aplicam a todo filme daquela marca.
- Storyboard — necessário? Vídeo narrativo ou com múltiplos planos (lançamento/promo/cinematográfico) → sim, storyboard plano a plano com aprovação antes da produção (esta é a primeira de duas aprovações; a segunda é a aprovação final). Plano único/mecânico (captura de tela curta) → leve: apenas rodada de conceito (§1.5). Em caso de dúvida: storyboard.
- Plano de keyframes (para imagens de IA) — decida por plano quais precisam de um quadro inicial gerado, com qual âncora (
consistency.md). Valide um keyframe / um corte antes de expandir para todos os planos/idiomas/variantes (§5 pré-entrega). Nunca gere o conjunto inteiro às cegas.
Saída do portal: um mini-brief + cânon de marca (adotado/criado) + decisão de storyboard + plano de keyframes. Só então prossiga para a seleção do modo.
0.6 Um vídeo ou uma série? (define a ordem do trabalho)
Você precisa entregar mais de um entregável relacionado — uma série de recursos, uma campanha com cortes para redes sociais, um filme longo com teasers incorporados, ou o mesmo vídeo em N idiomas? Então mude para o modo série. O padrão de qualidade não muda; a ordem sim: storyboard do conjunto inteiro primeiro → prove o movimento mais difícil com um PoC → produza o restante em paralelo a partir de um modelo comprovado e idempotente. Isso escala de "um vídeo em algumas horas" para "cinco vídeos + um longo, três idiomas, em uma sessão" sem abaixar a barra. Um vídeo único e independente → permaneça no fluxo normal. Receita completa (storyboard da série + aprovação, portal PoC, rig de captura determinística, expansão paralela, disciplina de expansão): reference/series-production.md.
1. Qual modo?
| Pergunta | Modo |
|---|---|
| A gravação já existe (arquivos locais ou URLs)? | A — Gravação existente → reference/existing-footage.md |
| As imagens precisam ser geradas (nenhuma gravação utilizável)? | B — IA total → reference/models.md + reference/consistency.md |
| Ambos (planos de IA entre clipes reais)? | Combine; montagem sempre via reference/montage-ffmpeg.md |
Quando não tiver certeza se existe gravação utilizável: faça inventário primeiro (modo A, etapa "auto-selecionar"), depois proponha o que a IA deve preencher.
1.5 Rodada de conceito → aprovação do storyboard (PADRÃO)
Esta é a etapa 5 do briefing. Para qualquer vídeo com camada criativa/narrativa (títulos, tratamento, tom da montagem, storyboard): não comece com uma direção escolhida. Primeiro dê ao usuário 3 sugestões concretas de conceito — história/título/tratamento/direções, recomendadas em primeiro lugar, com o texto/arco por conceito. O usuário escolhe antes da construção completa. Isso evita "lindamente feito, história errada".
- Títulos/história devem contar um arco ascendente (configuração → tensão → recompensa → identidade), não rótulos soltos. Entregue as linhas exatas por conceito, não apenas um tema.
- Em seguida, camada: BOM → EXTREMO (primeiro uma versão coerente, depois empurre para cinética por letra, sincronia de batida, vazamentos de luz). Mostre passos intermediários.
- Para um vídeo narrativo/de múltiplos planos, esta é uma porta de aprovação: o conceito escolhido se torna um storyboard plano a plano (batida, texto na tela, tipo de plano, fonte: gravação real / keyframe de IA) que o usuário aprova antes da produção. Nada é produzido até que o storyboard esteja definido.
2. Modo A — Gravação existente (auto-seleção por assunto)
REGRA DE FERRO — capturas de tela sempre no FORMATO ALVO. Faça/renderize uma captura de tela na mesma proporção da saída: vídeo 16:9 → capture na largura da área de trabalho; vídeo 9:16 → renderize a página na largura MOBILE (layout vertical nativo) e capture 9:16. Nunca reutilize/reenquadre uma captura de tela 16:9 para um vídeo 9:16 (ou vice-versa). Esticar ou "colar em um fundo" não é uma captura nativa.
Resumo: inventário → (baixar) → extrair quadros e inspecionar visualmente para selecionar por assunto → cortar/concatenar/graduar → montagem. A auto-seleção depende da sua própria leitura multimodal: extraia miniaturas com ffmpeg, leia-as, escolha os segmentos correspondentes. Receita completa + comandos: reference/existing-footage.md.
3. Modo B — IA total (produção de imagem consistente → vídeo)
Resumo: keyframe primeiro. Gere um quadro inicial por plano onde o assunto + ambiente já estejam corretos (nano-banana/Flux, com uma âncora de referência para consistência), depois anime esse quadro com imagem-para-vídeo (fal.ai Veo>Kling). Nunca texto-para-vídeo cego. Modelos/custos/parâmetros: reference/models.md. Técnicas de consistência (âncora de referência, sem texto + lettering separado, LoRA personalizado): reference/consistency.md.
4. Montagem e áudio (ambos os modos)
Montagem ffmpeg com pegadas comprovadas (multiplexação desacoplada, SFX sintetizados, font=Impact, FX em preto + blend=screen): reference/montage-ffmpeg.md. Execute trabalhos longos do fal como tarefas em segundo plano rastreadas; nunca presuma que "parece pronto" — inspecione os quadros.
5. Padrão de qualidade — comercial/premium (OBRIGATÓRIO)
Leia reference/commercial-craft.md antes de cada vídeo comercial. Esse é o padrão que faz o trabalho parecer pago. O resultado final (§0 lá): todo vídeo atende ao padrão de referência — propriedade da marca (leader+encerramento+embalagem da marca), material externo como elemento-em-seu-contexto, texto suficiente para explicar a história (incluindo sobre peças incorporadas), e um arco que chega à mensagem. Abaixo disso → refaça, não envie. Os três erros padrão que você NUNCA comete:
- Nenhum corte seco por padrão — premium usa transições elaboradas (cross-dissolves, fade para branco/preto, rampas de velocidade, cortes J/L). Corte seco apenas deliberadamente na batida. (ffmpeg
xfade.) - Nenhum título fino/ilegível — o texto é sempre pesado (700–900), grande, com fundo (scrim/glass-plate/bar) e permanece tempo suficiente para leitura. Um sistema de tipo. (Texto via PNG do ImageMagick → sobreposição.)
- Nenhuma correção de cor plana/saltitante — uma correção consistente e rica em todos os planos + granulação/dither.
Além disso: herói respira, corte na batida/movimento, gancho nos primeiros 1,5s, loudnorm+duck no áudio. Nunca termine em "tecnicamente funciona" — teste contra o padrão premium e a checklist de QA em
commercial-craft.md.
OBRIGATÓRIO antes da entrega — Inspeção pré-entrega (commercial-craft.md): um meio em movimento NUNCA é julgado por miniaturas soltas. Visualize uma tira densa de quadros (≤0,7s), o quadro final de A próximo ao quadro inicial de B por corte, a duração/legibilidade dos cards, e a higiene da fonte (legendas/marca d'água/correção). E valide um corte antes de expandir para idiomas/variantes. Pular isso foi a fonte nº 1 de falhas.
- Consistência acima de tudo: personagem/estilo idêntico em todos os planos (âncora de referência; keyframe primeiro).
- Sempre inspecione de verdade: extraia quadros e olhe; nunca confie apenas em "completo".
- Nenhum placeholder como final: canvas/gerado, sem emoji.
- Ciente de custos: relate o custo estimado/real da geração paga de forma breve e factual.
6. Automanutenção (continuamente — obrigatório)
Esta skill deve crescer. Em cada execução:
- Antes: execute a pré-verificação (§0). Uma nova lacuna de capacidade → pergunte + (após aprovação) instale.
- Durante/após: no momento em que você aprender algo — uma solução alternativa funcional, um modelo quebrado/novo, uma mudança de preço, uma ferramenta que quebra outra ferramenta, uma técnica de prompt melhor — registre imediatamente:
- Nova lição/pegadinha → anexe em
reference/lessons.md(com uma linha de porquê). - Modelo/preço/endpoint alterado → atualize
reference/models.md. - Ferramenta nova/alterada ou etapa de instalação → atualize
reference/tooling.md+scripts/preflight.sh+scripts/doctor.sh. - Atualize
CHANGELOG.md(data + 1 linha).
- Nova lição/pegadinha → anexe em
- Em dúvida se a skill ainda está correta (última revisão > ~1 mês atrás, ou um modelo/preço parece desatualizado): avise e proponha uma verificação rápida (1 chamada de teste) antes de construir com base na suposição antiga.
Arquivos
scripts/doctor.sh— verificação única e amigável "a máquina está pronta?" para integração.scripts/preflight.sh— verificação de ferramentas/chaves por trabalho, ciente do modo, saída≠0 se algo necessário estiver faltando.reference/brand-intake.md— o portal de briefing: adoção ou criação de marca, leader/encerramento, linhas que nunca se cruzam, formato do storyboard + aprovação, plano de keyframes.reference/series-production.md— modo série/campanha (§0.6): storyboard da série + aprovação para o conjunto inteiro, portal PoC antes da expansão, rig de captura determinística, um modelo → expansão paralela, disciplina de expansão.reference/tooling.md— cada ferramenta + comandos de instalação/verificação + chaves.reference/models.md— registro de modelos (imagem + imagem-para-vídeo + áudio) com custos/parâmetros/quando usar.reference/consistency.md— produção consistente de imagens (âncora de referência, sem texto + lettering, LoRA personalizado, vieses do Flux).reference/montage-ffmpeg.md— receitas de montagem + pegadinhas do ffmpeg.reference/commercial-craft.md— o padrão premium: transições, títulos pesados legíveis com fundo, ritmo, acabamento de correção, checklist de QA.reference/landscape-from-vertical.md— 16:9 a partir de uma fonte 9:16 sem esticar: o conjunto de ferramentas de reenquadramento.reference/existing-footage.md— vídeo existente: sondar, baixar, auto-seleção por assunto, cortar/concatenar/graduar.reference/lessons.md— registro contínuo de lições de produção (apenas anexar).CHANGELOG.md— histórico de manutenção desta skill.