Mon Monteur Vidéo

O que Mon Monteur Vidéo faz?

Um editor que entrega um arquivo verificado, não um rascunho. Esta skill não substitui as skills especializadas: ela decide qual usar, em que ordem, e aplica as regras aprendidas em projetos reais.

1. Antes de tocar na edição

1. Ler o brief e as fontes. Listar o que existe: cartaz (PSD, PDF, JPG), logotipo, fotos, takes, música fornecida, narração, texto.
2. Verificar as ferramentas (references/outillage.md): Node 22+, FFmpeg, Python, Premiere aberto ou não. Em uma máquina sem FFmpeg de sistema, usar o de um pacote (imageio-ffmpeg, Remotion) em vez de travar.
3. Fixar três coisas com a pessoa, em uma única pergunta se faltarem: a mensagem única do vídeo, os formatos de saída (16:9, 9:16, WhatsApp), a duração desejada. Todo o resto é decidido sozinho.
4. Não inventar nada sobre o conteúdo. Datas, locais, preços, números, nomes e funções vêm das fontes ou da pessoa. Dúvida sobre um nome próprio: perguntar.

2. Escolher o motor

Situação	Motor	Skill a carregar
Novo vídeo motion design, promo, explainer, vertical	HyperFrames (HTML renderizado em vídeo)	/hyperframes, depois /hyperframes-cli
Efeito, transição, estilo de legenda, gráfico "nomeado"	Registro HyperFrames antes de codificar manualmente	/hyperframes-registry
Música, efeitos sonoros, narração, transcrição, remoção de fundo, correção de cor	Ferramentas de mídia	/media-use
Projeto Remotion existente para modificar	Permanecer em Remotion; migrar apenas se solicitado	/remotion-to-hyperframes para migrar
Refazer um vídeo de referência idêntico	Engenharia reversa quadro a quadro	/reverse-any-video
Acabamento, exportação, legendas em uma edição já no Premiere	MCP premiere-pro	—
Renderização procedural pura (logotipo sendo revelado, capturas de site), sem navegador	Python Pillow + FFmpeg, quadro a quadro	—
Vídeo gerado por IA, avatar	Higgsfield ou HeyGen, após acordo sobre o custo	/higgsfield-generate, /media-use

Regra de escolha: o motor mais simples que torna o resultado editável pela pessoa depois. Detalhes e armadilhas de cada motor: references/moteurs.md.

3. Uma única fonte de tempo

A causa nº 1 de uma edição ruim é áudio e vídeo que não leem a mesma temporização.

• Escrever um arquivo de temporização (timing.mjs, plan.json): lista de cenas com sua duração, e a lista de marcos (cues) onde algo acontece na tela.
• O script de imagem e os scripts de áudio importam este arquivo. Nunca duração copiada em dois lugares.
• Calcular a duração total a partir da composição, depois gerar a música nessa duração (scripts/duree-composition.mjs para Remotion).
• Música fornecida: medir seu andamento, depois contar em compassos. tempo = 60 × fps / BPM quadros, compasso = 4 × tempo. Cada corte cai no primeiro tempo; anotar o deslocamento do primeiro tempo (geralmente 0,02 a 0,03 s).
• Derivações (vários participantes, várias ofertas): um objeto de variantes no arquivo de temporização, uma composição por variante e por formato, um script render que itera sobre elas.

4. Ritmo e conteúdo

• Cerca de 5 s por visual a ler. Muito rápido é a reclamação mais frequente. Um formato curto vertical pode descer para 2–3 s, nunca menos para texto.
• Vídeo público = oferta, prova, chamada para ação. As páginas internas (manual da marca, tipografias, maquetes de papelaria) não interessam ao público: retirá-las da edição.
• Chamada para ação final mantida por 5 a 8 s, com o contato confirmado e os meios de pagamento ou inscrição.
• Logotipo nunca retocado. Partir do arquivo original (AI, PDF, SVG), não recolorir nem redesenhar; animar apenas sua aparição (máscara que o revela). O último quadro do logotipo é idêntico ao original.
• Pessoas na tela: etiqueta nome + função, apontada para a pessoa correta (coordenadas em pixels da foto no arquivo de temporização), câmera que passa por cada uma e depois plano geral.
• Cartaz fornecido em PSD/PDF: extrair as camadas e o fundo em vez de recompor de memória; usar suas cores e fontes.
• Zonas seguras: conteúdo dentro de 90% do quadro, texto chave e legendas dentro de 80%. Em 9:16, deixar livre a parte inferior (interface TikTok, Reels) e a superior.

5. Som

Detalhes: references/son.md.

• Um vídeo com mais de ~15 s que conta algo tem música e efeitos sonoros nas ações visíveis, a menos que seja solicitado silêncio.
• Direitos: música fornecida pela pessoa, catálogo sob licença, ou música sintetizada por script (livre de direitos por construção). Nunca uma música comercial baixada online.
• Efeitos sonoros sincronizados com os cues do arquivo de temporização, na atmosfera do assunto (cozinha para um caterer, papel e notificações para um aplicativo).
• Mixagem inicial: música 0,62, efeitos sonoros 0,85, limitador suave tanh (scripts/mix.mjs). Sob uma narração, abaixar a música (ducking); a voz permanece inteligível no alto-falante de um telefone.
• Narração: uma linha por arquivo, depois transcrição palavra por palavra para sincronizar texto e legendas com a voz real, não com uma estimativa.

6. Fala filmada: cortar e legendar

Detalhes: references/parole.md.

1. Transcrever com carimbo de tempo por palavra (npx hyperframes transcribe, Whisper ou Parakeet).
2. Corrigir a transcrição: nomes próprios, siglas, homófonos. Os motores quase sempre deturpam nomes e siglas; reler cada frase.
3. Cortar os silêncios: scripts/coupe-silences.py agrupa palavras separadas por menos de 0,35 s e adiciona 0,08 s antes, 0,15 s depois. Terminar em uma frase completa; remover um final inaudível.
4. Ordenar as tomadas para contar: abertura curta e calorosa, mensagem longa no meio ou no final se concluir bem.
5. Legendas: 1 a 2 linhas, ≤ 42 caracteres por linha, 1 a 3,5 s por cartela, nunca cortadas no meio de um grupo de palavras. Entregar também o .srt.

7. Verificar antes de entregar

Nunca anunciar "pronto" apenas com base em uma renderização sem erros.

1. Extrair imagens nos momentos-chave: início, cada transição, meio de cada cena, último quadro. Observá-las. Um contato de prova é suficiente para o ritmo.
2. Verificar: texto legível e sem erros, nada cortado na borda, nome correto na pessoa certa, logotipo intacto, última imagem limpa.
3. Verificar o arquivo: não vazio, duração = duração prevista, faixa de áudio presente, yuv420p, áudio síncrono em um corte preciso.
4. HyperFrames: npx hyperframes check --json sem erros, depois snapshot. Remotion: remotion still nos quadros-chave.
5. Mostrar a prévia e aguardar a aprovação antes da renderização final ou qualquer publicação, exceto se for solicitado explicitamente para ir até o fim.

8. Exportar e derivar

Detalhes e comandos: references/export.md.

Saída	Quadro	Configuração inicial
Master, YouTube, Facebook	1920×1080, 30 fps	H.264, CRF 16–18, yuv420p, AAC 192 k
TikTok, Reels, Shorts	1080×1920, 30 fps	H.264, CRF 20–23
WhatsApp, envio direto	1280×720 ou 720×1280	H.264, CRF 26–28, AAC 128 k, +faststart, visar < 100 MB (status: ≤ 60 s)
Site web	conforme a página	versão leve + imagem de cartaz

• O 9:16 é recomposto, não recortado: mesmas cenas, layout vertical, textos maiores.
• Nomear os arquivos por conteúdo e destino: sujeito-facebook.mp4, sujeito-tiktok.mp4, sujeito-whatsapp.mp4. Saídas em out/ ou entregaveis/, fontes em source/.
• Usar Premiere apenas se a pessoa quiser editar manualmente: importar a renderização, os stems de áudio e o .srt.

9. Trabalhar em várias sessões

Apenas uma sessão escreve em uma pasta de projeto por vez. Duas sessões na mesma pasta se sobrescrevem. As renderizações longas rodam em segundo plano, destacadas, com um log que é relido.

Arquivos da skill

• references/moteurs.md — forças, armadilhas e comandos de cada motor
• references/son.md — música sintetizada, efeitos sonoros, mixagem, narração
• references/parole.md — transcrição, correções, corte de silêncios, legendas
• references/export.md — comandos FFmpeg de derivação e verificação
• references/outillage.md — instalação sem direitos de administrador, Premiere MCP
• references/lecons.md — feedback recebido em projetos reais, a reler antes de cada entrega
• scripts/mix.mjs, scripts/coupe-silences.py, scripts/duree-composition.mjs, scripts/planche-contact.sh