Video Forge

O que Video Forge faz?

Crie um projeto editável e um vídeo finalizado. Use o conjunto de ferramentas em conjunto: HTML/GSAP, React, FFmpeg, gravações, SVG, sprites, filmagens, áudio e 3D. Escolha ferramentas por cena; preserve o mecanismo de um projeto existente. Os visuais são criados em código ou obtidos a partir de mídia existente. Não substitua por vídeo/imagem generativo ou modelos de rosto falante. A síntese de narração e a transcrição de fala são ferramentas de áudio permitidas.

Os caminhos são relativos a este diretório, onde quer que esteja instalado. Nenhum MCP privado, agente/modelo específico, diretório pessoal do autor ou serviço pago é exigido por esta skill.

Caminho dourado — para um vídeo completo, faça exatamente isto

NÃO explore o código, crie assets manualmente ou ajuste pixels à mão. O código é dono de todo layout, ajuste de fonte e matemática de tempo de narração. Você apenas edita texto e parâmetros em um pequeno arquivo JSON. Execute estas quatro etapas em ordem:

# 1. Prepare o ambiente local UMA VEZ (Python local ao projeto + modelos de áudio)
python3 <skill-dir>/scripts/setup_environment.py --out .video-forge-tools --audio

# 2. Copie o storyboard fornecido; edite APENAS seu texto/segundos/cores/componentes.
#    Reescreva o arquivo inteiro com Write — nunca faça edições cirúrgicas/correspondência exata.
cp <skill-dir>/assets/storyboard-production.json ./storyboard.json

# 3. Valide, então renderize para MP4. run.py é O ponto de entrada: ele seleciona o interpretador
#    preparado e os caminhos dos modelos e executa voz→legendas→cenas→som→render→verificações.
python3 <skill-dir>/scripts/build_project.py ./storyboard.json --check
python3 <skill-dir>/scripts/run.py ./storyboard.json --out ./film
#    run.py BLOQUEIA até o MP4 estar pronto. Se interrompido, retome o MESMO comando com
#    --resume (não comece de novo). Se suas chamadas bash expirarem, adicione --background e consulte
#    com production_job.py status.

# 4. Verifique o arquivo real
python3 <skill-dir>/scripts/verify_video.py ./film/out/final.mp4 --require-audio

Regras para um modelo fraco: o JSON do storyboard é a ÚNICA coisa que você edita. Nunca invoque produce.py/build_project.py com o python3 do sistema para o vídeo completo — sempre vá através de run.py. Nunca edite um arquivo fonte .tsx/.py para alterar tamanho, layout ou texto; passe como parâmetro do storyboard. Se um título ou cartão parecer errado, altere seu valor JSON, não seu código — a matemática de layout é determinística e já se encaixa no quadro.

Comece com o menor contexto útil

Leia workflow. Inferir padrões a partir do briefing e da marca/referência fornecida. Pergunte apenas por material que carece de decisões. Para um novo projeto, salve DESIGN.md e STORYBOARD.md: um propósito por cena, duração, renderizador, asset, movimento de câmera e sinal de áudio. Corresponda dimensões/fps antes de misturar renderizadores.

Para um promo/tutorial completo, o padrão é a receita de produção acima, não o antigo teste de fumaça silencioso de quatro tipos. Leia direção de produção e comece de assets/storyboard-production.json. scripts/run.py carrega o plano através de voz, legendas de palavras, cenas coerentes, som, render e verificações de exportação (ele chama produce.py para você usando o interpretador preparado). Se dependências de áudio locais estiverem ausentes, scripts/setup_environment.py --out .video-forge-tools --audio prepara um Python local ao projeto e relata os caminhos do modelo. Esta configuração é reutilizável em diferentes ambientes de codificação; não requer um ambiente privado do autor. Veja production-direction.md.

Para este caminho, comece com o briefing e o exemplo de produção; execute o validador e o produtor em vez de percorrer cada implementação ou verificar cada dependência antecipadamente. O produtor relata ferramentas ausentes e ações de reparo concretas. Leia seu código fonte apenas quando um erro observado precisar de diagnóstico. O modelo condutor escolhe a mensagem e os parâmetros da cena; o código comprovado fornece habilidade e correção. Não chame "ele preencheu um JSON" de teste de produção de ponta a ponta.

O modo de reutilização primeiro é o padrão: pesquise no catálogo, escolha um componente demonstrado, preencha suas props declaradas, renderize uma prova curta, então componha. Leia model-scaffolding quando o agente estiver com dificuldades ou ao construir uma avaliação. Código personalizado é apropriado quando o catálogo genuinamente não se encaixa.

Pesquise código real antes de inventar movimento

python3 <skill-dir>/scripts/catalog.py 'personagem'
python3 <skill-dir>/scripts/catalog.py 'legenda'
python3 <skill-dir>/scripts/catalog.py 'terminal'

Para um briefing que se encaixa no vocabulário inicial de título/personagem/tela/3D, faça o modelo preencher assets/storyboard-example.json usando assets/storyboard.schema.json:

python3 <skill-dir>/scripts/build_project.py ./storyboard.json --check
python3 <skill-dir>/scripts/build_project.py ./storyboard.json --out ./meu-video

O compilador escreve o projeto e apenas as dependências que suas cenas escolhidas precisam. Use os padrões reais em vez de inventar um esquema. Para um vídeo completo, use o caminho dourado (run.py) em vez de parar neste esqueleto silencioso simples. Ele prepara a fala real, alinha o script aos spans de ASR medidos, carrega os tempos de legenda no render, masteriza a trilha sonora e exporta uma folha de contato.

Veja catálogo de bibliotecas. Código incluído, com licenças upstream:

• library/vendor/rendercomp/: 50 cenas desenhadas em código, tipografia, transições, gráficos e personagens SVG. Cada componente exporta padrões, FPS e duração.
• library/vendor/curvable/: 14 cenas de vídeo de lançamento parametrizadas; inspecione dependências opcionais de shader/fonte/WASM antes de usar um componente.
• library/vendor/onda/: componentes, schemas Zod, transições e ajudantes de composição. Analise padrões através do schema; preserve imports relativos e carregue tema/fontes.
• library/vendor/ffmpeg/: ajudantes de edição Python locais executáveis: cortes, junções, zoom/requadro, pixelização/desfoque, legendas animadas, correção de cor, mixagem, silêncio, exportação e QA.
• library/vendor/blender/: ajudantes Blender headless executáveis para inspeção, montagem de cena, conversão, otimização, baking e renders. Requer Blender.

Não leia toda biblioteca de uma vez. UPSTREAM.json registra proveniência e LICENSE retém os termos upstream. Seu código não é testado automaticamente por estar incluído.

Roteie pelo trabalho

Trabalho	Leia / use
Movimento HTML, GSAP, blocos de registro	HyperFrames
Composição React / lotes de dados	Remotion, parâmetros
Edição de filmagens, correção de cor, velocidade, áudio, montagem final	FFmpeg
Capturar navegador/área de trabalho, câmera cursor, zoom, censura	gravação de tela
Personagens, ilustrações, assets 3D	personagens, obtenção de assets
Geometria procedural, câmera, luzes, materiais, rigging	3D
Narração, tempos de palavra, legendas animadas, som	áudio e legendas, design de som
Comparação de ferramentas e planos de mecanismos mistos	roteamento

Para clipes baixados/stock use pipeline de mídia. Para decisões de movimento use princípios de movimento. Verifique pesquisa para skills/bibliotecas estudadas e por que se encaixam. Veja bibliotecas externas (e research/libraries-catalog.json) para um mapa de roteamento verificado por licença: o que é seguro incluir vs citar para cada tipo de trabalho. O registro HyperFrames é outra fonte de reutilização; consulte-o antes de construir um efeito. Use --help instalado; seu contrato pode diferir da skill upstream de hoje.

Verificação é parte da produção

Construa o quadro principal antes de animar. Cada quadro deve ser buscável em ordem arbitrária: sem relógio de parede, aleatoriedade não seedada, dependência de rede ativa ou laço de animação autônomo. HyperFrames usa timelines pausadas registradas; Remotion usa quadros. Renderize quadros representativos e visualize-os; inspecione entradas, pausas, limites de corte, alterações de legenda e o fim. Corrija corte, texto ilegível, silêncio e sincronia de áudio.

Quando for solicitado um vídeo, exporte o arquivo completo. Uma imagem estática não é conclusão.

python3 <skill-dir>/library/vendor/ffmpeg/scripts/probe.py final.mp4 --json
python3 <skill-dir>/scripts/verify_video.py final.mp4 --require-audio
python3 <skill-dir>/library/vendor/ffmpeg/scripts/look.py final.mp4 --tiles 3x2

Analise E decodifique a exportação final. Confirme duração planejada, dimensões/fps e áudio. Inspecione realmente a folha de contato. Audite o áudio quando a reprodução estiver disponível; declare quando apenas verificações técnicas de áudio foram possíveis. A redação requer verificação de cada intervalo relevante após transformações de câmera, e censurar o áudio se ele contiver o segredo.

Entregue o vídeo reproduzível, projeto editável, verificações reais e qualquer limitação de dependência real. Preserve os originais. Não publique/carregue, gaste créditos ou instale software de sistema a menos que o solicitante autorize. Autorizações existentes permanecem válidas.

Disciplina de modelo e evidência

Use planos estruturados, uma pequena lista, padrões de schema e ajudantes executáveis para reduzir as decisões que um modelo mais fraco precisa inventar. Retorne erros concretos ao modelo e altere a menor parte com falha. Leia avaliação para testes pareados de modelo forte/fraco. Não reivindique paridade com um modelo mais forte sem medi-la. O estado de recuperação pertence ao projeto, não a um prompt enorme.

Nosso próprio código é MIT. Mecanismos/assets/vozes mantêm suas próprias licenças. Ferramentas opcionais são instaladas apenas quando necessário. Estude o fluxo de trabalho de referência Katana, mas nunca presuma que os modelos hospedados da Higgsfield são um renderizador de código local ou que o Katana de desktop tem uma CLI.