Vidéo marketing
La vidéo est une page HTML dans laquelle chaque pixel est une fonction pure du temps, seek(t), rendue image par image avec un flou de mouvement et une bande-son placée à la milliseconde. Tout ce qui est spécifique à une marque provient du briefing ; rien n'est présupposé. Parle à la personne dans sa langue. SKILL_DIR ci-dessous est le dossier contenant ce fichier.
0. Première exécution : les outils
bash SKILL_DIR/scripts/check_deps.sh
Il liste ce qui manque sur cette machine (node 18+, ffmpeg, python3, numpy) avec les commandes d'installation pour son système. Si quelque chose manque, explique à la personne en termes simples à quoi sert chaque outil, montre les commandes, et demande une fois si elle veut les installer. Installe seulement si elle répond oui, puis relance la vérification. Une commande qui nécessite son mot de passe ou qui ouvre son propre installateur (Homebrew, sudo) est une commande qu'elle exécute dans son propre terminal ; donne-la-lui et attends. Pose les questions du briefing entre-temps : rien d'autre ne dépend des outils jusqu'à l'étape 2.
1. Briefing : tout demander d'abord
Envoie les questions dans references/intake.md en un seul message. Requis avant de construire quoi que ce soit :
- le sujet : ce que dit la vidéo, à qui, où elle sera publiée ;
- une vidéo d'inspiration : la donnée la plus utile ;
- le système de design, ou l'autorisation explicite d'utiliser des valeurs par défaut neutres ;
- les captures d'écran de l'interface chaque fois que la vidéo montre un produit.
Chaque élément doit aboutir à un fichier local : demande un téléchargement, ou récupère-le toi-même quand un outil le permet. Tout le reste a une valeur par défaut indiquée. Si un élément requis manque toujours après un rappel, ne commence rien qui en dépende ; pour l'inspiration seulement, propose le style propre du moteur (une forme continue en morphing) et continue une fois que la personne l'accepte.
Crée le projet, puis enregistre les réponses dans son brief.md :
bash SKILL_DIR/scripts/setup.sh ~/marketing-videos/<slug> # template, scripts, Playwright local
cd ~/marketing-videos/<slug> # toutes les commandes suivantes s'exécutent depuis ici
2. Lire l'inspiration, et confirmer la lecture
python3 inspect_inspiration.py <video> # planches contact, coupes, durée des plans, tempo musical
Regarde les deux planches, puis écris une lecture stylistique de dix lignes maximum : morphing continu ou coupes, événements par temps fort et durée des états, mouvements de caméra, easing, palette, typographie, son. Montre-la et demande ce qu'il faut garder. Une instruction écrite de la personne (règles, une liste d'interdits, une structure) remplace la lecture. Si elle a fourni de la musique, mesure-la maintenant (python3 inspect_inspiration.py track.mp3) et positionne CONFIG.bpm à son tempo avant la grille.
3. La liste des états sur la grille rythmique, puis attendre
Un tableau avec une ligne par temps fort : temps, état à l'écran, comment il bouge, ce que fait le curseur, caméra. references/craft.md donne les règles. Ne construis rien tant que la personne ne l'a pas approuvé. Itérer ici coûte une minute ; après la construction, cela coûte une heure.
4. Construction
Modifie scene.html : CONFIG (tempo, mesures, boucle ou carte de fin, jetons, polices), puis remplace la scène d'exemple. Lis d'abord references/craft.md : il contient le moteur, les règles de mouvement et les pièges.
- Polices : mets les fichiers de la marque dans
fonts/(télécharge Google Fonts en woff2) et liste-les dansfonts.json;CONFIG.fontnomme d'abord une de ces familles.python3 build.pyles intègre. - Logo : colle le SVG de la marque textuellement. Ne retape jamais un logotype dans une police.
- Les captures d'écran sont une référence pour une recréation simplifiée en HTML, jamais collées comme images.
- Séquences réelles :
python3 frames.py --src clip.mp4 --name <qui> --sheetpour choisir une fenêtre propre, puis extrais-la recadrée au format de l'image. Les séquences sont silencieuses sauf si leur son est mixé à l'étape 5.
5. Vérifier, puis le son
python3 build.py && node preview.mjs # planche contact par format, une image par temps fort, console et erreurs de polices
node checks.mjs # clics à l'intérieur de leurs boutons, pointeur jamais sur du texte lu
Les deux utilisent par défaut 1440x1440 et 1080x1920 ; passe d'autres tailles comme 1920x1080. Lis chaque planche et corrige tout ce qui est décalé par rapport à la grille, trop serré, illisible sur un téléphone, ou en pleine transition alors qu'il aurait dû être terminé. checks.mjs doit réussir dans tous les formats ; déclare chaque nouveau clic et chaque texte à protéger dans window.CHECKS.
python3 audio.py synthétise ensuite un tapis sur le tempo de la scène et place chaque son window.CUES selon son pic mesuré. --music track.mp3 --offset <s> utilise le morceau de la personne ; --voice clip.mp4:at:start:dur mixe la voix d'une personne filmée et abaisse la musique en dessous.
6. Rendu et livraison
node render.mjs scene.built.html 1440 1440 out/<slug>-v1-1x1.mp4 audio/bed.wav
node render.mjs scene.built.html 1080 1920 out/<slug>-v1-9x16.mp4 audio/bed.wav
Chaque version livrée reçoit de nouveaux noms de fichiers, et ses sources sont copiées dans versions/v<N>/ à la livraison. N'écrase jamais un fichier livré avant que le nouveau rendu ne soit terminé. Copie les MP4 là où la personne le souhaite et signale ce qui a changé, quelles vérifications ont réussi, et toute décision prise en son nom.
7. Itérer
Suis craft.md#iterating : ne modifie que ce qui a été nommé, étire le temps plutôt que de re-chorégraphier, relance preview.mjs et checks.mjs après chaque changement.
Prérequis
Le dossier est autonome. Les scripts ont besoin de node 18+, ffmpeg et python3 avec numpy (l'étape 0 trouve et installe ce qui manque) ; setup.sh ajoute Chromium de Playwright dans chaque projet. Si le projet vit dans un dépôt avec ses propres règles, suis-les, et garde les rendus, séquences, images et node_modules hors du contrôle de version.