Communitygithub.com

film-voiceover

Escreva, revise, teste e grave a narração de um filme promocional após a aprovação do vídeo, criando um roteiro sobre os quadros reais do filme, com direções para escolher, teste de coerência de olhos fechados, teste de pronúncia do nome do produto, gravação TTS por seção (Fish Audio), posicionamento de frases na linha do tempo, mixagem e multiplexação. Estágio 5 de product-film. Use quando um filme de lançamento/promoção precisar de narração, ou o proprietário disser que a narração parece IA, não combina com os quadros ou pronuncia o nome errado.

O que é film-voiceover?

Este skill automatiza e orienta a criação profissional de voiceover para filmes promocionais, seguindo um fluxo de três estágios: roteiro baseado em storyboard real, teste de pronúncia, e gravação/mixagem com Fish Audio. No Gate 1, ele analisa cada cena do storyboard, gera múltiplas direções de roteiro com transcrições completas, riscos e pontos fortes, e aplica cinco testes de qualidade. No Gate 2, testa variações de grafia do nome do produto em pequenos clipes para garantir pronúncia correta pelo TTS. No Gate 3, grava por seções, corta em frases, posiciona cada frase no tempo do vídeo batendo com a imagem correspondente, e executa mixagem automática com padrões de loudness (-14 LUFS, ≤ -1 dBTP). O skill é usado no estágio final (5) do fluxo product-film, sendo ideal para garantir que a narração não soe artificial, esteja sincronizada e pronuncie corretamente o produto. Ele suporta Fish Audio para TTS, scripts Python para análise de áudio e Node.js para renderização e multiplexação, mantendo versionamento de arquivos como vo.json e VO-SCRIPT.md.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-voiceover

Perguntar na sua IA favorita

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

Documentação

Film voiceover

A voz vem DEPOIS que o vídeo é aprovado e é ajustada a ele. O vídeo nunca se move para caber na voz, a menos que o proprietário peça. Leia references/writing.md (cada padrão rejeitado, com antes/depois) antes de escrever uma palavra, e use as habilidades de copywriting e humanizador em cada rascunho.

Portão 1 · Direções e roteiro (ainda sem gravação)

  1. Entenda cada cena. Para cada batida em storyboard.json, escreva em uma linha para que a cena serve. Se não conseguir, pergunte ao proprietário. Linhas escritas sobre o que uma cena parecia mostrar (um animal de estimação em uma parede de itens minúsculos) foram rejeitadas.
  2. Direções. Quando o ângulo estiver aberto, escreva 2–4 direções completas que diferem no que oferecem ao espectador, por exemplo: Dicas que o espectador pode usar · O incômodo diário · Como funciona · Dúvidas respondidas (segurança chave, custo, plataformas). Para cada: a transcrição completa, no que é boa e seu risco. Coloque sua escolha primeiro.
  3. Coloque-as no storyboard com QUADROS REAIS: renderize um frame por batida (node scripts/render.mjs --at …), defina vo por direção em storyboard.json, construa review/storyboard.html (script do film-storyboard). A página abre com cada direção como um parágrafo: a leitura de olhos fechados.
  4. Autoverificação com os cinco testes em references/writing.md (olhos fechados, frame, estranho, varredura de porcaria, alegações).
  5. Envie o storyboard; pergunte qual direção e o que mudar. Faça as perguntas de voiceover do product-film/references/question-bank.md (voz, para quem fala, tom, quanto de voz). Itere até obter um sim claro. Escreva o roteiro aprovado em VO-SCRIPT.md com o intervalo de tempo por linha e "de onde cada alegação vem". Faça commit.

Portão 2 · Pronúncia (antes da gravação completa)

  1. Pergunte como o nome do produto (e qualquer outra palavra incomum) é pronunciado, nas palavras do proprietário ("WIZ-get, g duro").
  2. Teste grafias, um clipe curto cada (uma frase curta com o nome): o nome simples, hifenizado, consoante duplicada (ex.: "Nimbet", "Nim-bet", "Nimbbet"). Várias grafias em uma única tomada saem mais curtas e confusas. Nomeie cada arquivo pela sua grafia. Envie-os; o proprietário escolhe.
  3. Grave o vencedor em vo.json › voice.note, em VO-SCRIPT.md, e na memória para filmes futuros. Nunca envie a grafia correta para o mecanismo se ele a pronunciar errado: envie a regrafia em todos os lugares.

Portão 3 · Gravar, posicionar, mixar

  1. Créditos primeiro: verifique o saldo de TTS. Fish Audio: máximo ~500 bytes por chamada, cobrado por byte. Grave por seção (audio/vo/l1.wav, l2.wav…), não o roteiro inteiro em uma chamada.
  2. Voz: a que o proprietário escolheu das amostras (Fish "Ethan" foi aprovado para um filme promocional calmo). Ajuste o ritmo com tempo por frase ≤ 1,1–1,15; nunca acelere uma tomada inteira.
  3. Corte em frases: python3 scripts/vo.py --scan lista segmentos de fala por tomada; escreva frases em vo.json com take, from, to, text.
  4. Posicione o at de cada frase (batidas = segundos de vídeo × 2) para que sua palavra-chave coincida com a imagem correspondente ou palavras na tela. Obtenha tempos de vídeo com node tools/probe.mjs cuts e "window.UNWARP(<story t>)". Execute python3 scripts/vo.py até relatar overlaps: none; deixe ≥ 0,25 s entre frases.
  5. Misture e multiplexe: python3 scripts/sfx_samples.py && python3 scripts/mix.py (-14 LUFS, ≤ -1 dBTP; voz 0, efeitos sonoros cerca de -10, música conforme escolha do proprietário) depois node scripts/render.mjs --mux [--fmt 9x16].
  6. Envie o corte com voz junto com a transcrição e uma tabela de onde cada linha cai. Diga que não consegue ouvir; pergunte sobre pronúncia, ritmo, nível e qualquer linha que caia no quadro errado. Itere. Faça commit de vo.json e VO-SCRIPT.md.

Quando o vídeo mudar depois

Re-explore, reposicione frases (at), remisture, remultiplexe. Para 9:16, o mesmo audio/mix.wav funciona se o timing for compartilhado.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-storyboard

Write the story of a product film as beats (what the viewer sees, the words on screen, the voice, the sound, why the beat exists, and where each claim is proven) and send it to the owner as a one-page storyboard with frames for review, with 2–4 directions when the story is open. Stage 2 of product-film, and the review format reused for the voiceover. Use when planning a launch/promo film's story, shot list, or script, or when the owner says "give me a storyboard", "give me directions", "I'll review and decide".

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

Habilidades Relacionadas