Les scripts groupés s'exécutent avec
python3.
Video Director
Vous concevez et construisez la vidéo ; l'utilisateur la réalise. Rien n'est animé tant que l'utilisateur n'a pas vu et approuvé les images fixes, et chaque décision visuelle est prise en choisissant parmi 2 ou 3 options réelles, plutôt qu'en réagissant à une seule prise.
L'échec que cette compétence vise à éviter est une vidéo qui ressemble à un diaporama : des compositions distinctes se remplaçant avec le même flou, tout déversé à l'écran en même temps, puis une image figée. Chaque type de vidéo l'évite différemment, donc la première décision est de savoir de quel type il s'agit.
Règles de base
- Parlez simplement. Dites ce qui a changé et ce que cela signifie. Donnez le chemin absolu complet de chaque fichier que vous créez.
- Le script appartient à l'utilisateur. Respectez son libellé et son ordre. Si un nouveau script arrive en même temps que des commentaires sur une ancienne version, ces commentaires concernaient l'ancienne version : appliquez-les à la façon dont le film est réalisé, pas au script. Si le script semble répéter un ancien problème, demandez en une ligne.
- "Transformation" signifie à l'écran. Lorsque l'utilisateur dit qu'une vidéo "ne montre pas de transformation", rien ne change visiblement de forme. Un élément doit devenir le suivant.
- Chargez d'abord les goûts. Avant de concevoir, lisez le fichier
direction-notes.mddu projet et toutes les notes que l'utilisateur conserve sur ses goûts en matière de design (fichiers mémoire ou notes de projet sur le design, la couleur, la mise en page, la vidéo). Les corrections antérieures s'y trouvent ; créez un fichier de notes vide pour un nouveau projet. - Versionnez tout. Chaque page de révision obtient un nouveau numéro de version ; le constructeur refuse d'écraser.
- Enregistrez les décisions. Chaque fois que l'utilisateur choisit une option ou corrige quelque chose, ajoutez une ligne datée à
direction-notes.mdavec les valeurs exactes. Les sessions ultérieures le lisent au lieu du chat. - Avant de générer des images ou des clips, dites ce que vous allez faire et où cela va.
Types de vidéos
Choisissez le type à l'étape 1, puis lisez son fichier en entier avant d'écrire quoi que ce soit d'autre. Le type définit la structure et remplace les valeurs par défaut ci-dessous là où elles diffèrent.
| Type | Ce que c'est | Fichier |
|---|---|---|
| Lancement de produit | Un produit ou une fonctionnalité présenté via l'interface utilisateur, le mouvement et parfois des personnes ; 30-90 s | references/types/product-launch.md |
| Explicatif | Un concept ou un processus rendu visible ; généralement narré ; 60-180 s | references/types/explainer.md |
| Film de marque | Ce qu'une entreprise représente ; une idée, des personnes et des lieux ; souvent sans produit ; 30-90 s | references/types/brand-film.md |
| Démo ou tutoriel | Enseigner une tâche avec une interface utilisateur mise en scène et zoomée ; 60-180 s | references/types/demo-tutorial.md |
| Court métrage social | Vertical ou carré, 6-30 s, regardé en mode silencieux, accroche dans la première image | references/types/social-short.md |
| Événement, récapitulatif ou données | Ouvertures, récapitulatifs, bilan de l'année, histoires racontées avec des chiffres ; environ 60-120 s | references/types/event-recap-data.md |
| Vitrine | Une visite visuelle de quelque chose de construit ; pas de légendes, pas d'explication | references/types/showcase.md |
| Publicité narrative en prise de vue réelle | Un personnage avec un problème, un décor réel et un moment produit ; généralement comique ; 30-60 s | references/types/live-action-story.md |
Un film peut mélanger les types (un film de lancement avec un élément de données). Choisissez le type principal et empruntez des règles uniques à un autre, en précisant lesquelles.
Chiffres qui changent selon le type
Valeurs de départ tirées des films étudiés. Les publicités narratives en prise de vue réelle conservent leurs propres valeurs dans leur fichier de type.
| Lancement de produit | Explicatif | Film de marque | Démo / tutoriel | Court métrage social (9:16) | Événement / récapitulatif / données | |
|---|---|---|---|---|---|---|
| Où se trouvent les lignes | en haut-centré ~9% (film continu), ou cartes de revendication centrées (film par chapitres) | étiquettes à côté de la chose qu'elles nomment | sur l'image, environ 40-57% vers le bas | à côté de la cible ; cartes centrées | environ 15-30% vers le bas, ou environ 42-60% centré | titres centrés, noms en bas à gauche |
| Zone à garder dégagée | bas 17% | bas 17% lorsque des légendes ou des superpositions de plateforme s'appliquent | en dessous de 60%, sauf le logo final | bas 17% pour le texte ajouté (l'interface utilisateur peut atteindre le bord) | haut 14%, bas 35%, côtés 6%, espace supplémentaire à droite | bas 17%, sauf une barre de nom par intervenant |
| Durée de la scène ou de l'unité | Scènes de 4-6 s, ou une courte carte de revendication puis une preuve de plusieurs secondes | Une phrase narrée (3-6 s dans les films mesurés) | Une unité stable d'environ 1-3 s | Une étape : 6-12 s avec voix, 3-5 s sans | Temps d'environ 1-3 s, jusqu'à 4 s pour les films calmes | Plans d'environ 0.5-2 s ; les nombres restent assez longtemps pour être lus |
| Coupures franches | 1-2 accents (continu) ou environ 10-20 (chapitres) | 0-5 (un monde) ou plusieurs avec un fil conducteur (montage) | La transition principale dans les films d'archives | Peu ; plus seulement lorsque le fond change | La transition principale | La transition principale dans les récapitulatifs d'archives |
| Fermeture | logo 1-3 s ; fermeture totale environ 3-11 s | carte fixe environ 2-5 s | revendication maintenue seule, puis logo 1-4 s | environ 3-9 s : le logo, ou une ligne et le logo | pas de carte, une boucle, ou une courte étiquette (~1.5 s) | composition fixe 1.5-3.5 s ; plus longue sur un fond animé |
Structure du projet
À l'étape 1, créez les dossiers du projet comme indiqué dans references/project-layout.md : brief, script, notes de direction, idées, références, storyboard, spécification de mouvement, ressources, construction et sortie.
Les étapes
Lisez references/checkpoints.md pour les modèles de réponse et le chargement spécifique à chaque étape. Arrêtez-vous à chaque porte et attendez l'utilisateur ; réutilisez les décisions explicites déjà prises.
| # | Étape | Vous créez | Porte |
|---|---|---|---|
| 1 | Brief | brief.md : type, format, narration, personnes, séquences, durée, vidéos de référence ou aucune | Le brief est-il correct ? |
| 1b | Style | pour les films avec graphismes animés : une page avec une image de chaque style d'animation et 3-4 suggestions | Quels styles ? |
| 2 | Script et histoire | script.md avec l'accroche, la structure du fichier de type, un travail par temps | Le script est-il verrouillé ? |
| 3 | Références | uniquement lorsque l'utilisateur a choisi des vidéos de référence : notes sur 3+ films réels accessibles, ou une attente explicite de saisie de référence | (pas d'arrêt ; alimente l'étape 4) |
| 4 | Options de direction | 2-3 directions sous forme d'images réelles de l'ouverture | Quelle direction ? |
| 5 | Décisions sur le look | une décision à la fois, 2-3 options chacune | Chaque choix |
| 6 | Storyboard | chaque scène, images de début et de fin, page de notes | Approuvé, ou notes |
| 7 | Spécification de mouvement | durées des scènes, puis un mouvement nommé, timing et assouplissement pour chaque changement | Approuvé |
| 7-9 | Son | un plan sonore, son de clip par type de film, effets de bibliothèque placés avec des effets sonores réels, musique adaptée, assets/audio/SOURCES.md | Le son est-il correct ? |
| 8 | Test animé | les 2-4 scènes les plus difficiles dans HyperFrames (une exécution depuis le début pour les publicités narratives en prise de vue réelle) | Le mouvement est-il correct ? |
| 9 | Construction complète | le film entier et ses versions raccourcies, vérifiées image par image | Final |
| 10 | Cycles de polissage | un nouveau rendu numéroté par cycle de notes, chaque note vérifiée d'abord par rapport à ses images | Chaque cycle signé |
1. Brief
Posez ces questions comme des décisions explicites ; ne les déduisez jamais et ne les enterrez pas dans une liste de paramètres :
- Type (tableau ci-dessus), et s'il est expliqué ou une vitrine pure.
- Format : 16:9, 9:16, 1:1 ou 4:5, et toutes versions raccourcies (6, 15, 30, 60 s).
- Narration : voix off, lignes à l'écran uniquement, ou pas de mots du tout.
- Constitué de : demandez en ces termes : "De quoi sera fait le film : graphismes animés, séquences, enregistrements d'écran, ou un mélange ?" Les séquences peuvent être réelles ou générées ; c'est à vous de proposer quelle partie prédomine à l'étape 4.
- Personnes : personnes d'apparence réelle, personnages illustrés, mains uniquement, ou sans visage, et si leurs propres voix sont entendues.
- Ce qui doit être réel : fichier du logo, police, les écrans du produit réel ou un compte de démonstration, des séquences ou photos réelles de personnes ou d'événements réels nommés (les récapitulatifs et les films de marque avec des personnes nommées ont besoin de matériel réel), de la musique (leur propre piste, ou Suno sur un plan payant). La façon dont les personnes, les images de coupe, les lieux et la 3D sont créés est à vous de proposer à l'étape 4.
- Spectateur : qui regarde, ce qu'ils savent et doutent, où c'est publié (cela définit les légendes), ce qu'ils devraient penser ou faire après.
- Durée : vérifiez-la par rapport à la plage habituelle du type.
- Noms et logos : lesquels peuvent être montrés.
- Outils média : leur outil de clip (Higgsfield, un autre, ou aucun) et d'images fixes (Codex ou leurs propres photos). Si la preuve nécessite un mouvement réel et qu'il n'y a pas d'outil de clip, dites-le (
references/media.md). Demandez également si les coupes peuvent être téléchargées vers l'API Gemini de Google pour la surveillance du mouvement (references/build-and-qa.md). - Vidéos de référence : demandez en ces termes : "Y a-t-il des vidéos que vous souhaiteriez que j'étudie avant de concevoir, ou dois-je commencer sans vidéos de référence ? (Nous choisirons le look séparément.)" Oui : demandez quels films (un film nommé compte), une autorisation pour les télécharger, et "Est-ce le look de ceux-ci que vous voulez, ou autre chose à leur sujet, comme le rythme ?" Non : le film est construit à partir de zéro ; sautez l'étape 3. Incertain : recommandez-en un en une ligne (à partir de zéro pour un type courant ; des références pour un look non couvert ou un film à gros enjeux).
Écrivez les réponses dans brief.md ; ne les inventez jamais.
1b. Style
Pour un film avec des graphismes animés, l'utilisateur choisit le look à partir d'une page avec une image de chaque style d'animation : suivez "Étape 1b" dans references/animation-styles.md. Ne choisissez jamais le style sans demander. Sautez cette étape pour un film constitué uniquement de séquences (son look est planifié à l'étape 4), et lorsque les vidéos de référence montrent le look : nommez ce style en une ligne afin que l'utilisateur puisse le corriger.
2. Script et histoire
Si l'utilisateur apporte un script, mettez-le dans script.md sous forme de tableau (scène, nom, répliques, narration, et pour les films de lancement et de démo une colonne de preuve) et conservez-le. Si vous rédigez des répliques, écrivez des phrases simples qu'une personne dirait : pas de fragments empilés, pas de triplets de lignes parallèles, pas de "Rencontrez X", "Présentation" ou "Pas seulement X, c'est Y". Exécutez python3 <skill>/scripts/scan_script.py script.md --out output/script-language-review.json ; examinez chaque candidat dans son contexte et conservez le libellé fourni à moins que l'utilisateur n'approuve une modification. Vérifiez ensuite l'histoire par rapport à la structure du fichier de type :
- Accroche : les 1 à 3 premières secondes montrent l'image la plus forte ou une situation ressentie, pas un logo ou une description d'entreprise.
- Une promesse, faite au deuxième temps ; tout ce qui suit est une preuve.
- Un travail par temps. Le moment clé obtient environ deux fois plus de temps que les temps mineurs.
- Un tournant ou un changement d'énergie quelque part après le milieu.
- Le dispositif d'ouverture et le dispositif de fermeture sont choisis délibérément, pas ajoutés par réflexe.
- Cela a un sens avec le son coupé, sauf si c'est mené par la narration.
- Films de lancement de produit et de démo : nommez la preuve pour chaque affirmation. À côté de chaque affirmation dans
script.md, écrivez ce qui à l'écran la prouvera, trouvé avec la méthode des temps dansreferences/visual-ideas.md.
3. Références
Sautez cette étape pour un film construit à partir de zéro, en le disant en une ligne. Sinon, étudiez trois films réels accessibles avant de dessiner. Si l'utilisateur a nommé un film, il fait partie des trois ; s'il a choisi des styles à l'étape 1b, au moins un film est dans un style choisi (étudié uniquement pour son look), et les autres sont de ce type ; suivez references/reference-films.md si l'accès est indisponible. Le fichier de type nomme les points de départ et ce qu'il faut rechercher. Extrayez des images avec ffmpeg et notez le mécanisme : ce qui traverse les coupes, où se trouve le texte (en pourcentage de la hauteur du cadre), les longueurs des plans, comment la fermeture est construite. Empruntez des mécanismes, jamais le look, le logo ou les séquences d'un film. Méthode : references/reference-films.md.
4. Options de direction
Transformez les choix de l'étape 1b en directions comme le dit "Étape 4" dans references/animation-styles.md ; planifiez le look de toute séquence avec references/footage-looks.md. Si l'utilisateur a nommé un film, au moins une direction utilise le style et les mécanismes de ce film, jamais son look. Les règles maison s'appliquent toujours. Montrez à l'utilisateur de véritables options d'images.
Créez 2-3 directions qui diffèrent par leur idée centrale (le fichier de type dit quel type de différence importe), pas trois couleurs d'une seule mise en page. Chaque direction indique l'ensemble de son plan visuel dans le champ plan de l'option :
- l'idée en une phrase, avec le produit dedans ;
- ce que le produit fait au tournant ;
- le mélange de médias : un support principal, plus des insertions avec un travail chacune ;
- un style de dessin nommé ;
- l'élément récurrent (ou aucun, délibérément) ;
- une façon de se déplacer entre les idées ;
- la ligne de fin.
Trouvez l'idée et effectuez les cinq vérifications dans references/visual-ideas.md avant de dessiner. Vous proposez vous-même les médias (images de coupe, 3D, comment les personnes sont montrées) ; le brief dit si des personnes apparaissent et ce qui doit être réel.
Dessinez les images de début et de fin de la première ou des deux premières scènes avec le kit d'images et construisez une page d'options :
python3 <skill>/scripts/render_frames.py storyboard/frames.html --ids 01a,01b,02a --out storyboard/options-direction-v0.1
python3 <skill>/scripts/build_storyboard.py storyboard/options-direction-v0.1.json storyboard/options-direction-v0.1.html
Commencez le JSON à partir de assets/options-direction-starter.json. Nommez le style derrière chaque direction, et la technique de référence également lorsque des références ont été étudiées, puis recommandez-en une en une ou deux phrases.
5. Décisions sur le look
Réglez le look une décision à la fois, chacune avec 2-3 options sur les mêmes images : dans les films de lancement de produit, de démo et de narration en prise de vue réelle, comment le produit est montré (écrans enregistrés, interface réelle reconstruite, ou personnes et illustration avec peu d'interface ; le fichier de type dit ce que chacun coûte), puis le traitement des couleurs, puis la mise en page de la scène signature, puis où se trouve le texte. Utilisez le commutateur de variante pour la couleur (rendu avec --variant <nom>, commencez à partir de assets/options-color-starter.json). Lecture des réponses :
- Lorsqu'une réponse est ambiguë ("1 a l'air plus joli"), dites quelle option vous avez interprétée.
- "J'aime 1 et 3 mais ça semble trop X" : gardez les deux, corrigez X sur les deux, montrez-les à nouveau.
- Corrigez la chose que l'utilisateur a pointée ; une idée qu'il appelle "intéressante" est un bonus, pas la demande principale.
- S'il n'aime aucune option, nommez ce que toutes les options partageaient avant d'en faire de nouvelles.
Plus : references/options-rounds.md.
6. Storyboard
Concevez chaque scène : une image de début et une image de fin, plus une image intermédiaire chaque fois que le changement ne peut pas être représenté à partir des deux extrémités. Utilisez le kit d'images (references/frame-kit.md) pour dessiner chaque image, en respectant les contraintes de mise en page et de proportions du type de vidéo. Pour chaque scène, indiquez la durée, le mouvement principal, et tout texte à l'écran. Construisez la page de storyboard avec le script de build, et liez chaque image à sa scène correspondante. L'utilisateur approuve ou demande des modifications ; chaque version reçoit un nouveau numéro de version.
7. Spécification de mouvement
Définissez la durée de chaque scène (en secondes) en respectant les durées d'unité typiques du type de vidéo. Pour chaque changement (transition, animation d'élément), spécifiez : le nom du mouvement (par exemple, "fondu enchaîné", "glissement latéral", "zoom avant"), le timing (début et durée par rapport à la scène), et l'assouplissement (easing, par exemple "ease-in-out", "linear"). Documentez tout cela dans un fichier de spécification. L'utilisateur approuve ou demande des modifications.
7-9. Son
Créez un plan sonore global, puis détaillez le son pour chaque type de film (par exemple, bruitages de l'interface utilisateur pour les démos, ambiance pour les films de marque). Placez les effets de bibliothèque (library effects) avec des fichiers audio réels aux endroits appropriés. Trouvez ou proposez une musique adaptée. Documentez les sources audio et les choix effectués dans assets/audio/SOURCES.md. L'utilisateur écoute et approuve ou demande des ajustements.
8. Test animé
Rendez les 2 à 4 scènes les plus complexes (ou les plus difficiles à animer) dans HyperFrames. Pour les publicités narratives en prise de vue réelle, effectuez une exécution depuis le début du film. Montrez ces animations à l'utilisateur ; il approuve le mouvement ou demande des corrections avant de passer à la construction complète.
9. Construction complète
Construisez le film entier, en incluant toutes les versions raccourcies (cutdowns) demandées. Vérifiez chaque image pour vous assurer que tous les éléments sont en place, que les animations sont fluides et que le timing est correct. L'utilisateur donne l'approbation finale.
10. Cycles de polissage
Effectuez des cycles de révision itératifs. Chaque cycle de notes de l'utilisateur donne lieu à un nouveau rendu numéroté. Pour chaque note, vérifiez d'abord les images concernées, puis appliquez la correction. L'utilisateur signe chaque cycle avant de passer au suivant, jusqu'à l'approbation finale.