Communitygithub.com

voix-off-film

Rédiger, réviser, tester et enregistrer la voix-off d'un film produit après approbation de l'image, sous forme de script sur un storyboard des plans réels du film, avec des directions au choix, un test de cohérence yeux fermés, un test de prononciation du nom du produit, un enregistrement TTS par section (Fish Audio), un placement des phrases sur la timeline du film, un mixage et un multiplexage. Étape 5 de product-film. À utiliser lorsqu'un film de lancement/promotion nécessite une narration, ou lorsque le propriétaire dit que la voix-off sonne comme de l'IA, ne correspond pas aux plans ou écorche le nom.

Qu'est-ce que voix-off-film ?

Ce skill guide la création d'une voix-off professionnelle pour un film produit, après approbation de l'image. Il assure une narration cohérente avec les plans, en passant par plusieurs étapes : rédaction de directions de voix-off, tests de prononciation (notamment pour les noms de produits), découpage en sections pour l'enregistrement TTS via Fish Audio, placement précis des phrases sur la timeline, mixage audio et multiplexage final. Le processus inclut des auto-vérifications rigoureuses (yeux fermés, cohérence image, test de l'étranger) et une validation itérative avec le propriétaire. Idéal pour les équipes marketing ou créatives utilisant Claude Code, Cursor ou Codex, ce skill transforme un storyboard brut en un film narré de qualité, évitant les voix robotiques et les décalages image/son. Il intègre des scripts Python et Node.js pour l'automatisation, garantissant un flux de travail reproductible et précis.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Voix-off film

La voix vient APRÈS que l'image soit approuvée, et s'y ajuste. L'image ne bouge jamais pour s'adapter à la voix, sauf si le propriétaire le demande. Lisez references/writing.md (chaque motif rejeté, avec avant/après) avant d'écrire un mot, et utilisez les compétences de copywriting et d'humanisation sur chaque brouillon.

Porte 1 · Directions et script (pas encore d'enregistrement)

  1. Comprendre chaque plan. Pour chaque battement dans storyboard.json, écrivez en une ligne à quoi sert le plan. Si vous ne le pouvez pas, demandez au propriétaire. Les lignes écrites sur ce qu'un plan semblait montrer (un animal sur un mur de minuscules objets) ont été rejetées.
  2. Directions. Lorsque l'angle est ouvert, écrivez 2 à 4 directions complètes qui diffèrent par ce qu'elles donnent au spectateur, par exemple : Astuces que le spectateur peut utiliser · L'ennui quotidien · Comment ça marche · Réponses aux doutes (sécurité clé, coût, plateformes). Pour chacune : la transcription complète, ce qu'elle réussit bien, son risque. Mettez votre choix en premier.
  3. Placez-les sur le storyboard avec des VRAIS plans : rendez une image fixe par battement (node scripts/render.mjs --at …), définissez vo par direction dans storyboard.json, construisez review/storyboard.html (script de film-storyboard). La page s'ouvre avec chaque direction comme un paragraphe : la lecture yeux fermés.
  4. Auto-vérification avec les cinq tests dans references/writing.md (yeux fermés, plan, étranger, analyse de médiocrité, affirmations).
  5. Envoyez le storyboard ; demandez quelle direction et quoi changer. Posez les questions de voix-off de product-film/references/question-bank.md (voix, à qui elle parle, ton, combien de voix). Itérez jusqu'à obtenir un oui clair. Écrivez le script approuvé dans VO-SCRIPT.md avec la plage horaire par ligne et "d'où vient chaque affirmation". Commitez.

Porte 2 · Prononciation (avant l'enregistrement complet)

  1. Demandez comment le nom du produit (et tout autre mot inhabituel) se prononce, dans les mots du propriétaire ("WIZ-get, g dur").
  2. Testez des orthographes, un court clip chacun (une phrase courte avec le nom) : le nom simple, avec trait d'union, consonne doublée (par ex. "Nimbet", "Nim-bet", "Nimbbet"). Plusieurs orthographes dans une seule prise sortent plus courtes et confuses. Nommez chaque fichier selon son orthographe. Envoyez-les ; le propriétaire choisit.
  3. Enregistrez le gagnant dans vo.json › voice.note, dans VO-SCRIPT.md, et en mémoire pour les futurs films. N'envoyez jamais l'orthographe correcte au moteur s'il la prononce mal : envoyez la réorthographe partout.

Porte 3 · Enregistrement, placement, mixage

  1. Crédits d'abord : vérifiez le solde TTS. Fish Audio : maximum ~500 octets par appel, facturé par octet. Enregistrez par section (audio/vo/l1.wav, l2.wav…), pas tout le script en un seul appel.
  2. Voix : celle que le propriétaire a choisie parmi les échantillons (Fish "Ethan" a été approuvé pour un film produit calme). Ajustez le rythme avec tempo ≤ 1,1–1,15 par phrase ; n'accélérez jamais une prise entière.
  3. Découpez en phrases : python3 scripts/vo.py --scan liste les segments de parole par prise ; écrivez les phrases vo.json avec take, from, to, text.
  4. Placez le at de chaque phrase (battements = secondes vidéo × 2) pour que son mot clé atterrisse avec l'image correspondante ou les mots à l'écran. Obtenez les temps vidéo avec node tools/probe.mjs cuts et "window.UNWARP(<story t>)". Exécutez python3 scripts/vo.py jusqu'à ce qu'il signale overlaps: none ; laissez ≥ 0,25 s entre les phrases.
  5. Mixez et multiplexez : python3 scripts/sfx_samples.py && python3 scripts/mix.py (-14 LUFS, ≤ -1 dBTP ; voix 0, effets environ -10, musique selon le choix du propriétaire) puis node scripts/render.mjs --mux [--fmt 9x16].
  6. Envoyez le montage vocalisé avec la transcription et un tableau de l'endroit où chaque ligne atterrit. Dites que vous ne pouvez pas l'entendre ; demandez la prononciation, le rythme, le niveau et toute ligne qui atterrit sur la mauvaise image. Itérez. Commitez vo.json et VO-SCRIPT.md.

Lorsque l'image change plus tard

Re-sonder, replacer les phrases (at), remixer, remultiplexer. Pour 9:16, le même audio/mix.wav fonctionne si le timing est partagé.

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).

Skills associés