Communitygithub.com

film-produit

Créez une vidéo de lancement, promotion ou démonstration de produit qui se vend et qui n'a pas l'air générée par l'IA, en passant par des étapes de validation que le propriétaire approuve une par une.

Qu'est-ce que film-produit ?

Cette compétence guide la création de vidéos publicitaires professionnelles (lancement, promotion, démonstration) en s'appuyant sur un pipeline strict validé étape par étape par le propriétaire du produit. Elle garantit un résultat authentique, lisible et déterministe, sans marqueurs IA. Elle commence par l'étude d'une vidéo de référence (sans la copier) et suit les compétences `film-reference-study`, `film-storyboard`, `film-build`, `film-sound` et `film-voiceover`. Chaque étape (brief, référence, storyboard, image, son, voix, formats) est une porte de validation : le propriétaire approuve clairement avant de passer à la suivante. La compétence insiste sur le réalisme (tout élément montré existe dans le produit), la spécificité (logos réels, UI détaillée, OS authentiques), le point de vue du spectateur (test de compréhension) et l'absence de rendu IA (pas de bips synthétiques, pas de mockups minimalistes, pas de voix off descriptives). Elle exige des rapports honnêtes sur ce qui a été vérifié et ce qui ne l'a pas été. En sortie, elle livre deux formats (16:9 et 9:16) avec crédits, légendes et une liste de ce qui n'a pas été vérifié.

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

Demander à votre IA préférée

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

Documentation

Film produit

Un film produit est jugé d'abord par une seule personne : le propriétaire. Il corrige ce qui ne va pas, vous le réparez, et le film s'améliore tour après tour. Cette compétence existe pour que vous rendiez les corrections du propriétaire inutiles : chaque règle provient d'une correction que quelqu'un a dû faire à la main. Lisez references/lessons.md avant de commencer, et à nouveau avant chaque validation que vous envoyez. C'est l'archive de ce que les propriétaires ont rejeté et pourquoi.

Le pipeline et ses portes

Rien ne passe à l'étape suivante tant que le propriétaire n'a pas approuvé l'étape en cours. L'approbation est un « oui » clair dans le chat, pas un silence ni un « c'est bien mais… ». Après tout changement demandé par le propriétaire, renvoyez-le pour une nouvelle validation.

ÉtapeCompétenceVous envoyez pour validationPorte
0 · Briefcelle-cile brief : produit, acheteur, la seule chose à le convaincre, durée, formats, où il sera diffuséle propriétaire approuve le brief
1 · Référencefilm-reference-studyce que la référence fait et ce qu'il faut emprunter, en nombres et en imagesle propriétaire approuve ce qui est emprunté et ce qui ne l'est pas
2 · Storyboardfilm-storyboardune page de storyboard : une image par temps fort, mots à l'écran, pourquoi chaque temps fort est là ; 2–4 directions si l'histoire est ouvertele propriétaire choisit une direction et approuve les temps forts
3 · Imagefilm-buildd'abord des images fixes, puis une ébauche à 30 ips, jamais un rendu final d'abordle propriétaire approuve l'image ("faire le rendu final")
4 · Sonfilm-soundle final avec effets sonores, et la décision musicalele propriétaire approuve le son
5 · Voix offfilm-voiceoverle script sur un storyboard d'images RÉELLES, puis des tests de prononciation, puis la version voix offle propriétaire approuve le script, la prononciation, puis la version
6 · Formatsfilm-build (formats)les images fixes 9:16, puis le rendu 9:16le propriétaire approuve ; 16:9 prouvé inchangé
7 · Livraisoncelle-ciles fichiers, sous-titres, crédits, ce qui n'est pas vérifiéterminé

« Avant de faire le rendu, laissez-moi voir » : le propriétaire veut voir le plan et les images fixes avant que vous ne passiez 30 minutes sur un rendu. Un rendu final sans ébauche approuvée est une perte de temps et une perte de confiance.

Comment demander (à chaque porte)

À chaque porte, posez des choix concrets plutôt que des questions ouvertes, et faites en sorte que chaque option soit quelque chose qu'un vrai monteur choisirait. Les options génériques (« moderne », « propre », « dynamique ») transforment un film en daube IA. references/question-bank.md contient les questions et options pour chaque étape : look, mouvement, rythme, transitions, typographie, personnages, son, musique, voix, livraison. Règles :

  • Deux à quatre options par question, chacune avec ce à quoi elle ressemble ou sonne, son coût ou son risque. Mettez votre choix en premier et dites pourquoi en une ligne.
  • Ne demandez que ce qui change le travail. Décidez le reste à partir de la marque et de la référence, et dites ce que vous avez décidé.
  • Lorsque le propriétaire réfléchit à voix haute, ne mettez pas en œuvre chaque phrase. Faites des recherches, puis revenez avec 2–4 directions et leurs compromis, et laissez-le choisir (« donnez-moi quelques directions avec les compromis pour que je puisse décider »).
  • Quand le propriétaire dit « attendez, je vais vous en dire plus », arrêtez-vous et attendez. Ne continuez pas à éditer.
  • Quand une correction arrive, trouvez la règle derrière et vérifiez tout le film pour la même erreur, pas seulement l'endroit qu'ils ont désigné.

Règles qui s'appliquent à chaque étape

  1. Réel seulement. Chaque fonctionnalité, widget, écran, source de nombre et affirmation dans le film fonctionne dans le produit aujourd'hui. Si le film a besoin de quelque chose que le produit ne peut pas faire, soit construisez-le dans le produit (et enregistrez la décision), soit laissez tomber. Chaque affirmation parlée ou montrée a une source que vous pouvez montrer (un fichier, un document, un test).
  2. Spécifique, pas générique. Logos réels provenant des sites des marques. Chrome OS réel avec des applications qui existent réellement sur cet OS. Tailles d'écran réelles. Fonds d'écran réels (sous licence). UI produit riche et détaillée : « trop simple » se lit comme « pourquoi paierais-je pour ça ». Voir film-build/references/realism.md.
  3. Le point de vue du spectateur. Le film est destiné à un étranger qui n'a jamais entendu parler du produit. Testez chaque temps fort : le comprendraient-ils ? Pourraient-ils le mal interpréter (par exemple, penser que le produit EST l'IA) ? Parle-t-il de leur vie ou de nos fonctionnalités ?
  4. Pas fabriqué par IA. Pas de bips synthétiques, pas de mockups minimalistes, pas de ressemblances d'icônes de polices avec de vraies marques, pas de triades et de texte « votre X, votre Y », pas de voix off qui décrit la scène. Les propriétaires connaissent ces signes, et leurs acheteurs aussi. Un concurrent s'est fait traîner publiquement pour une vidéo de lancement qui ressemblait à « faite avec Claude ».
  5. Lisible et fluide. Chaque ligne reste assez longtemps pour être lue jusqu'au bout. La frappe ressemble à un clavier. Rien ne coupe, ne se chevauche ni ne clignote vide. Rythmez pour les humains : les premières coupes sont presque toujours trop rapides.
  6. Déterminisme. Le film est une fonction pure du temps ; render.mjs --verify doit passer avant tout rendu que vous envoyez.
  7. Rapports petits et honnêtes. Quand vous envoyez une validation, dites ce qui a changé, ce qui reste ouvert, et ce que vous n'avez pas pu vérifier (vous ne pouvez pas entendre l'audio : dites-le et demandez). N'appelez jamais vérifié ce que vous n'avez pas vérifié.
  8. Commitez souvent (code, scripts, storyboard, script VO). Les rendus, l'audio et les images fixes restent hors de git.

Structure du projet

<film>/
  brief.md                 étape 0
  reference/               sortie d'étude (images, feuilles, summary.md, NOTES.md)
  storyboard.json          source étape 2 → review/storyboard.html
  film/                    la page du film (core.js, film.js, mock.js, index.html)
  scripts/ tools/          rendu, synchronisation, son, voix, mixage, sondes (du kit film-build)
  timeline.json vo.json    timing des images et repères sonores ; phrases de voix off
  VO-SCRIPT.md             la voix off approuvée avec la provenance de chaque affirmation
  assets/                  polices, logos, fonds d'écran, effets sonores, personnages, CREDITS.md
  renders/ audio/ review/  (ignorés par git)

Commencez par sh ~/.claude/skills/film-build/kit/init.sh <film>.

Étape 0 · Brief

Avant toute chose, écrivez brief.md et faites-le approuver :

  • Produit, en une phrase qu'un étranger comprend. Pas le slogan.
  • Qui achète, dans leurs mots. Plusieurs types de personnes si le produit sert plusieurs publics (personas) : ce que chacun vérifie ou a besoin chaque jour.
  • La seule chose dont le film doit les convaincre, et le seul malentendu qu'il doit éviter.
  • Preuves disponibles : ce qui est réel aujourd'hui, ce qui a été construit et enregistré, ce qui peut être montré.
  • Durée et formats : un film de lancement qui montre l'étendue a besoin d'environ 45–65 s. 20 s est trop court pour montrer plusieurs personnes et leurs cas d'usage. Formats : 16:9 d'abord, puis 9:16, sauf si le propriétaire dit autrement.
  • Où il est diffusé (page d'accueil du site, X, Reels, YouTube) et les règles de la marque (couleurs, typographie, mots à ne jamais utiliser, logos).
  • Ce que le produit ne doit jamais être montré être (par exemple « jamais un dock »), et tout concurrent à éviter.

Étape 7 · Livraison

  • renders/16x9.mp4 et renders/9x16.mp4 (60 ips, flou de mouvement, voix et son mixés).
  • assets/CREDITS.md : chaque fond d'écran, logo, police, son et personnage, avec sa licence.
  • Si des marques apparaissent : une ligne d'utilisation nominative à l'écran pendant leur affichage (« Les noms de produits et logos appartiennent à leurs propriétaires… »).
  • Une liste simple de ce qui n'a pas été vérifié (par exemple « les quatre demandes n'ont pas encore été construites dans l'application réelle »).
  • Des sous-titres et une miniature si demandé (utilisez les compétences sociales et rédactionnelles du propriétaire ; pas de signes IA).

Après le film

Ajoutez chaque nouvelle correction faite par le propriétaire à references/lessons.md, sous l'étape à laquelle elle appartient, avec ce qui n'allait pas et la règle qui l'empêche. Ce fichier est la façon dont le prochain film commence en avance sur celui-ci.

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

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

Skills associés