ratava/videoexpress-scripting-skill

Scripting VideoExpress

Produisez un prompt pack prêt pour la production : un document vivant qui mappe une œuvre complète (chanson, narration, histoire) sur une séquence de clips, chacun avec un plan d'image de départ et un prompt multishot VE prêt à coller. Puis accompagnez la génération : diagnostiquez les échecs signalés, corrigez-les globalement, et passez en revue chaque clip concerné.

Deux faits déterminent presque tout dans cette compétence :

1. Le modèle rend des noms, pas des intentions. Chaque nom, nombre, comparaison et jeton superflu est un candidat à l'affichage à l'écran.
2. Chaque génération ne connaît que ce qu'on lui donne. Un clip enchaîné ne voit qu'une seule image fixe (la dernière image du clip précédent) plus le prompt. Il n'a aucune mémoire du mouvement du clip précédent, de rien de ce qui était hors cadre, ni des prompts antérieurs. Tout ce qui n'est pas visible dans l'image d'ouverture ou décrit dans le prompt sera inventé.

Où lire ensuite

Ne lisez que ce dont l'étape en cours a besoin. Tout ce qui se trouve dans references/ est autonome.

Quand vous…	Lisez
Commencez un nouveau projet, ou l'utilisateur a un concept ou un script	references/project-intake.md — le système de questions, la vérification de faisabilité, les tests de développement, le brief et la validation de la Bible centrale
Rédigez ou révisez des blocs de personnages, tenues ou lieux ; des images de départ ; des références Consistent Character ; des personnages non humains	references/bible.md
Choisissez un style, ou rédigez un prompt en mode Create ou style personnalisé	references/styles/README.md (recette partagée et index), puis la feuille de style dont vous avez besoin
Rédigez un prompt vidéo	references/multishot-template.md — la structure des balises, le modèle vierge et un exemple travaillé
Planifiez la grille de clips, l'enchaînement, les mouvements de caméra, ou tout segment [ACTION]	references/camera-and-motion.md
Rédigez [LIGHT AND IMAGE] ou [PRODUCTION SOUND], tout clip avec de la parole, ou des plans en point de vue / HUD	references/light-sound-dialogue.md
Rédigez ou déboguez un prompt ; l'utilisateur signale un échec	references/prompt-rules.md — comment le moteur lit un prompt, et le tableau échec → cause → règle
Êtes invité à piloter app.videoexpress.ai avec un agent capable de naviguer	references/browser-workflow.md — lisez d'abord, suivez étape par étape

Pour une demande de prompt unique en cours de projet, l'ensemble habituel est multishot-template.md + prompt-rules.md + le(s) fichier(s) parmi bible.md, camera-and-motion.md, light-sound-dialogue.md et une feuille de style que le clip concerne. Pour un échec signalé, commencez par le tableau dans prompt-rules.md.

Flux de travail

0. Intake — exécutez references/project-intake.md (après les questions sur les nouveautés ci-dessous, si c'est la première utilisation de la compétence dans la conversation) : point de départ (concept ou script), liste de décisions avec suggestions, vérification de faisabilité, tests de développement éventuels, validation du brief et de la Bible centrale.
1. Concept — scènes, motifs, personnages, monde, et un arc visuel mappé à la structure de la source (ci-dessous).
2. Bible — blocs de personnages, tenues et lieux verrouillés, écrits une fois et collés mot pour mot partout (bible.md).
3. Timing — une grille de clips à la durée de clip de l'outil, avec les hits clés vérifiés sur l'audio réel par l'utilisateur (camera-and-motion.md).
4. Prompt pack — prompts d'image de départ et prompts vidéo multishot pour chaque clip (multishot-template.md plus les références pertinentes).
5. Accompagnement de la génération — diagnostiquez les échecs signalés par mécanisme, corrigez-les globalement, passez en revue chaque clip concerné (prompt-rules.md).

Lorsque le script est validé, commencez la production dans la même réponse : si l'assistant opère VE, demandez s'il faut ouvrir les onglets VideoExpress dans le navigateur maintenant, et donnez le premier prompt prêt à coller avec ses paramètres, quel que soit l'opérateur (references/project-intake.md, Starting production).

Le pack est un document vivant. Attendez-vous à de nombreuses révisions à mesure que l'utilisateur génère des clips.

Première utilisation dans une conversation : les nouveautés

La première fois que cette compétence est utilisée dans une conversation, quel que soit le premier message de l'utilisateur (un nouveau projet, un prompt unique, une question sur la compétence, un problème signalé), posez ces questions avant toute chose, sous forme de questions oui/non, une à la fois, avec des options numérotées là où la plateforme n'a pas de widget de question :

Une fois par version si la mémoire le permet. Vérifiez d'abord toute mémoire persistante que vous pouvez lire (les souvenirs enregistrés de l'assistant, un fichier de mémoire de projet) pour une note indiquant que les questions sur les nouveautés de cette version ont déjà été présentées. Si c'est le cas, sautez les deux questions. Sinon, posez-les ; puis, si la mémoire est activée, enregistrez la note d'une ligne "VideoExpress Scripting [version] : nouvelles fonctionnalités présentées." et dites à l'utilisateur une fois : "Je me souviendrai que vous avez vu ceci, donc je ne le redemanderai pas pour cette version." Sans mémoire, ou si aucune note n'est trouvée, posez les questions comme ci-dessous : redemander est le repli sûr.

1. "VideoExpress Scripting a été mis à jour vers la version [version]. Souhaitez-vous un résumé rapide des nouveautés ?" Prenez la version depuis metadata.version de ce fichier, sans suffixe -dev. En cas de réponse positive, lisez references/changelog.md et affichez ses notes de version actuelles (la première ligne du fichier indique quelles sections) sous forme de liste à puces : un titre court par version, la plus récente en premier, puis une puce courte par élément Headline et New (les éléments Fixed d'une version peuvent partager une puce). Ne résumez jamais les notes dans une phrase ou une parenthèse.
2. Pour chaque élément Headline dans ces notes de version actuelles qui comporte une question, sauf si sa condition "Skip if" s'applique : posez sa question. En cas de réponse positive, donnez le lien d'installation et dites qu'il ouvre les étapes d'installation : pour VideoExpress Prompt, https://github.com/ratava/videoexpress-scripting-skill/wiki/Install-VideoExpress-Prompt (la page contient une section pour chaque plateforme, y compris ChatGPT et Grok).

Répondez ensuite au premier message de l'utilisateur, ou commencez l'intake pour un nouveau projet. Si la compétence a été démarrée sans message propre (seulement son nom ou une commande slash), traitez-la comme un nouveau projet : allez directement à la carte "Comment voulez-vous commencer ?" (references/project-intake.md, Étape 1), sous forme de carte de question (options numérotées là où la plateforme n'a pas de widget de question), pas un menu en prose. Lorsque le premier message indique déjà ce qui est souhaité (une idée, un script, un prompt unique, une prise ratée), agissez sans demander ce que l'utilisateur veut. Posez les questions sur les nouveautés une fois par conversation, jamais plus tard dans celle-ci.

Nommez la conversation d'après le projet. Une fois qu'un nouveau projet a un titre provisoire (à partir de l'idée de l'utilisateur ou du brief), renommez la conversation en "[titre] · VideoExpress" si vous disposez d'un outil pour la renommer (Grok peut renommer ses chats ; ChatGPT ne le peut pas). Sinon, laissez le nom tel quel.

Conception du concept

• Concevez 2 à 4 motifs récurrents qui portent la vidéo (une couleur d'accent, un geste, un effet de lumière, un accessoire récurrent). Les motifs donnent une continuité que la génération IA ne peut pas fournir seule.
• Mappez la structure de la source à un tableau de scènes : scène → plage temporelle → clips → tenue → lieu → état du motif. Faites évoluer les motifs à travers les scènes.
• Les moments clés méritent des événements visuels. Les gros hits ou les répliques importantes obtiennent des révélations ou des explosions de mouvement, les montées en puissance obtiennent de l'immobilité pour que le hit porte, et les changements de scène se produisent aux limites des sections.
• Donnez à chaque scène une ouverture logique. Établissez le personnage arrivant, remarquant quelque chose ou réagissant avant l'action principale.
• Privilégiez ce qui se génère de manière fiable : mouvements de caméra stables, changements de lumière, atmosphère flottante, un sujet clair. Le spectacle à l'arrière-plan, la performance au premier plan.
• Le dialogue est synchronisé labialement de deux manières (une ligne citée dans le prompt multishot, ou la boîte de dialogue Lipsync HD ; voir light-sound-dialogue.md). Dans les plans sans dialogue, gardez la bouche fermée ou hors du champ pour que la parole ne soit pas inventée, et ne terminez jamais un clip avec quelque chose dans la bouche ou de la nourriture dans la main si le clip suivant contient du dialogue.
• L'intérêt d'arrière-plan (véhicules, foules, vie urbaine) est nommé explicitement et maintenu à distance pour qu'il ne croise jamais le sujet.

Règles qui s'appliquent à chaque prompt

Ce sont celles qui causent le plus de dégâts quand on les oublie. Les références contiennent les détails et le reste.

• Lorsque vous suivez un prompt pack, chaque prompt commence par sa référence de clip entre crochets, exactement comme le pack la déclare pour cette image ou ce clip : [Clip 12] pour un prompt vidéo, [Image 12A] pour une image de départ, [Clip 12 TEST 1] pour une variante de test. Elle vient en premier, avant toute ancre de style ou [REFERENCE USE], afin que chaque vignette de la bibliothèque et chaque prise puisse être associée au pack. Détails dans multishot-template.md.
• Les blocs de la Bible sont collés mot pour mot. La paraphrase est une dérive. Lorsqu'une image de départ reproduit parfaitement le look, les prompts vidéo réutilisent le libellé exact de ce prompt d'image, pas le libellé plus ancien de la bible.
• Correspondre au cadre, pas au plan. Regardez le cadre d'ouverture enchaîné ou l'image de départ acceptée avant d'écrire : décrivez les accessoires, le cadrage et la géométrie des obstacles exactement comme le cadre les montre.
• Les guillemets signifient la parole. Citez chaque ligne parlée une fois, dans [ACTION], et ne citez rien d'autre. Deux locuteurs par clip, maximum.
• Du positif partout sauf dans [NEGATIVES]. VE lit chaque autre section comme des éléments à inclure, même avec "no", "not" ou "never" devant, donc décrivez ce qui doit exister et ce qui reste immobile, et mettez chaque exclusion dans [NEGATIVES], chacune rédigée avec "No" ("No music, no hum"). Commencez chaque segment par le mouvement du sujet.
• Caméra : verrouillée sauf demande explicite, chaque mouvement nommé à l'identique dans chaque clip, chaque mouvement a une destination, ne revenez jamais dans un espace qui a quitté le cadre. N'écrivez jamais un mouvement relatif à un autre clip.
• Un détail ne tient qu'à la taille à laquelle VE l'a dessiné pour la dernière fois. Un zoom avant qui agrandit un visage ou un accessoire, ou un accessoire qui quitte le cadre et revient, fait que VE le redessine à partir du texte. Commencez chaque clip à partir d'une image de départ à son cadrage le plus proche ; un plan plus serré est un nouveau clip.
• Enchaînement : signalez le risque de détail, n'imposez pas. Un clip enchaîné s'ouvre sur la dernière image de la prise, et un détail ne tient qu'à la taille à laquelle VE l'a dessiné pour la dernière fois. Lorsqu'un enchaînement planifié risque une dérive des détails (un cadrage plus serré que la dernière image, un retrait puis un retour, un visage ou un accessoire détaillé petit dans la dernière image), dites-le une fois par projet ou section de pack (un épisode par exemple) dans les règles globales de cette section, avec les options : garder le cadrage apparié, relancer le parent, ou partir d'une nouvelle image de départ. La façon d'enchaîner est le choix de l'utilisateur.
• Pas d'événements comptés ; pas de lettrage promis. Décrivez les écrans, les panneaux et autres objets porteurs de texte comme des formes et de la lumière abstraites.
• Les effets ajoutent de la lumière, ne la remplacent jamais. Gardez une lumière clé sur le sujet ; réaffirmez la luminosité dans le segment final ; ne faites jamais d'enchaînement à partir d'un cadre assombri.
• Un bloc [PRODUCTION SOUND] par segment, avec l'étiquette temporelle du segment ; un seul bloc après le dernier segment ne se lie qu'à ce segment et laisse le reste à VE, souvent comme musique. Les sons transitoires liés aux actions ; ne demandez jamais le silence (il se rend comme un grondement et un crépitement) ; adaptez la durée du clip à l'action et à la parole ; terminez chaque bloc par ce qui est entendu dans ce segment.
• Les looks stylisés ont besoin de l'ancre de style au tout début du prompt vidéo (juste après la référence du clip, avant [REFERENCE USE]) et dans chaque [LIGHT AND IMAGE], plus des négatifs anti-réalistes.
• Gardez "Automatically enhance my video prompt" désactivé. Il réécrit en prose courte et supprime la bible, les étiquettes temporelles et la référence du clip. La zone de prompt contient environ 6 000 caractères ; coupez d'abord le texte de style répété et les négatifs.
• Désactivez Consistent Character lors de la création d'images de départ sans personnages (environnements vides, point de vue, inserts). Cela affecte uniquement Create Image ; Create Video l'ignore.

Le document du prompt pack

1. Aperçu : tableau des scènes (scène, clips, plage temporelle, tenue, durée VE) ; note sur le format du prompt ; références à fournir avec chaque clip ; règle de collage (seul le texte à l'intérieur des blocs de code est collé ; les titres portent les métadonnées).
2. Règles globales : les règles ci-dessus et celles des références qui s'appliquent à ce projet.
3. Bible : bloc central du personnage, blocs de tenues, blocs de lieux, ligne de style.
4. Par scène : images de départ (chacune avec une référence déclarée telle que Image 12A, et un prompt autonome qui commence par [Image 12A]), puis par clip — ligne d'en-tête (référence du clip telle que Clip 12 · plage temporelle · durée VE · FRESH from image X ou CHAIN from clip N · balise de rôle) et le prompt multishot complet, commençant par [Clip 12], dans un bloc de code.
5. Montage, timing et contrôle qualité : transitions, liste de contrôle QC par prise (dans prompt-rules.md), éléments ouverts.

Pour les alternatives, ajoutez un nouvel onglet ou une nouvelle section plutôt que d'écraser les clips fonctionnels, et incluez tous les clips adjacents qui doivent changer pour une transition correcte. Conservez les références de clips et d'images stables une fois la génération commencée, car elles identifient les prises ; si des clips sont coupés, gardez les espaces et notez-les. Les alternatives obtiennent leur propre référence (Clip 12B), jamais une réutilisation.

Style de travail pendant la production

• Les utilisateurs signalent les échecs un par un, souvent avec une image. Diagnostiquez le mécanisme (tableau dans prompt-rules.md), corrigez-le globalement, et passez en revue chaque clip non encore généré présentant le même risque.
• Lisez l'image que l'utilisateur envoie : notez ce qui a réellement été rendu et écrivez le prompt suivant pour correspondre à ce qui existe.
• Lorsque l'utilisateur modifie directement le pack, relisez avant d'écrire et n'écrasez jamais ses modifications sans le dire.
• Lorsque l'utilisateur exprime une préférence ("gardez ça", "je préfère ce look"), traitez-la comme une nouvelle règle et appliquez-la partout, y compris en réécrivant le bloc de la bible pour correspondre à l'image.
• Protégez les plans à fort impact : protégez leurs préconditions dans chaque prompt antérieur.
• Lorsque l'utilisateur demande à voir un prompt avant une exécution, montrez le prompt complet prêt à coller, puis demandez à l'exécuter. N'exécutez pas d'abord.
• Isolez les échecs tenaces. Lorsqu'un problème persiste après deux tours de prompt, arrêtez de reformuler. Maintenez un prompt de base fixe et exécutez une prise par variante, chacune modifiant une variable, avec une référence unique par variante ([Clip 12 TEST 1], [Clip 12 TEST 2]), plus une prise de contrôle d'un prompt précédemment propre. Enregistrez les variables qui ont compté.
• Sachez quand vous arrêter. Si une séquence a trop dérivé du concept, dites-le et proposez de redémarrer la séquence.