Communitygithub.com

Video Studio

Uma skill do Claude Code que transforma uma única ideia em um filme finalizado e alinhado à marca — a partir do chat. Dois modos (editar gravações / IA total), um portal de briefing e um padrão de qualidade premium.

O que é Video Studio?

Video Studio é uma skill especializada do Claude Code voltada para produção e edição de vídeo de ponta a ponta, combinando edição de gravações existentes com geração consistente de imagens via IA. Ela suporta dois modos principais (gravações existentes e IA total) e um padrão de qualidade profissional, não experimental. A skill impõe um fluxo rigoroso que começa com uma verificação de ferramentas obrigatória (preflight) e um processo de briefing de marca (intake) que define briefing, guia de estilo, leader/outro, storyboard e plano de keyframes — tudo antes de qualquer produção. A qualidade é garantida por um padrão comercial premium documentado em `reference/commercial-craft.md`, que exige transições elaboradas, títulos pesados e legíveis, correção de cor consistente, gancho nos primeiros 1,5 segundos e inspeção pré-entrega. Além disso, a skill se auto-mantém: a cada execução, registra lições aprendidas, atualiza registros de modelos, ferramentas e custos, e sugere verificações periódicas para evitar decisões baseadas em informações desatualizadas. É ideal para desenvolvedores e criadores que desejam produzir vídeos de alta qualidade alinhados à marca diretamente do terminal.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add RichardTheuws/video-studio

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.

  1. 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?".
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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?

PerguntaModo
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:

  1. 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.)
  2. 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.)
  3. 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:

  1. Antes: execute a pré-verificação (§0). Uma nova lacuna de capacidade → pergunte + (após aprovação) instale.
  2. 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).
  3. 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.

Habilidades Relacionadas