Communitygithub.com

Brief et histoire

Démarrez tout projet vidéo. Transformez une demande (« fais une promo pour mon site », « une vidéo produit », « un film de pitch comme celui-ci ») en un brief, une référence étudiée, une structure narrative, un script et un plan de tournage. Utilisez-le avant de rassembler des images ou de construire quoi que ce soit, et à nouveau lorsque les retours modifient l'histoire.

Qu'est-ce que Brief et histoire ?

Ce skill, « Brief et histoire », est conçu pour les agents IA (comme Claude Code, Cursor, Codex) afin de structurer la phase de préproduction d'une vidéo. À partir d'une demande initiale, il guide l'agent à travers six étapes clés : la collecte d'un brief détaillé, l'analyse d'une référence filmique, le choix d'une structure narrative adaptée, la création de personnages, la rédaction d'un script parlé et l'élaboration d'un plan de tournage. Il s'appuie sur des outils comme `npx hyperframes` et `ffmpeg` pour l'analyse des coupes et des dialogues, et fournit des modèles de tables (SCRIPT.md, SPEC.md). Utile pour tous types de vidéos (promo, story, walkthrough, social cut), il garantit que le script et les visuels sont cohérents avec le produit et le public cible, tout en évitant les pièges courants. Le skill s'intègre naturellement aux workflows vidéo et est compatible avec tout environnement de développement ou de production supportant ces outils.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-brief-and-story

Demander à votre IA préférée

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

Documentation

Que fait Brief et histoire ?

1. Le brief : ce que vous devez savoir

Découvrez ces informations avant tout le reste. Lisez d'abord ce qui vous a été donné (le site, l'application, un deck, un film de référence) ; ne demandez que ce qui manque encore, en un seul message.

QuestionPourquoi cela change le film
Qui regarde, et où ?Des investisseurs dans une salle, des visiteurs sur une page d'accueil et un flux social en sourdine nécessitent des ouvertures, des durées et des tailles de texte différentes
Que doivent-ils faire ensuite ?Cela devient la dernière image : une adresse, un code QR, un bouton
Combien de temps ?Définit le nombre de mots : environ 2,5 mots parlés par seconde, moins pour un film avec des pauses
Quel est le produit, vraiment ?Vous devez l'utiliser, ou le voir utilisé, pour le montrer fidèlement
Y a-t-il un film qu'ils aiment ?Une référence définit le rythme et l'apparence plus rapidement que n'importe quelle description
Qu'est-ce qui doit être inclus, qu'est-ce qui ne doit pas l'être ?Des fonctionnalités pas encore en ligne, des concurrents, des affirmations que le service juridique n'a pas approuvées

Valeurs par défaut lorsqu'ils ne précisent pas : 16:9 en 1920 × 1080 pour la création, 30 ips, 60 à 100 secondes, un narrateur, les polices et couleurs de la marque, fond clair si le produit est clair.

2. Étudier la référence

S'ils fournissent un film de référence, démontez-le avant d'écrire.

  • Coupes : npx hyperframes measure cuts ref.mp4 ou détection de scène ffmpeg. Faites une planche contact avec une vignette par plan (scripts/sheet.sh).
  • Mots : npx hyperframes transcribe ref.wav --json.
  • Écrivez une feuille de plans : temps, durée, ce qui est à l'écran, ce qui est dit. Puis les proportions : combien de secondes de problème, de produit, de fin. Notez la durée des plans, où le texte apparaît, quand la musique change.

Ce que vous tirez d'une référence, c'est sa structure et son rythme, jamais ses images, sa musique, son texte ou ses personnages.

3. Structures narratives

Choisissez-en une et dites laquelle. Elles fonctionnent pour n'importe quel produit ; ce qui change, c'est qui sont les personnes et à quoi ressemblent les écrans du produit (section 4 et video-footage-and-screens).

Film narratif (pitch, lancement, marque). Accroche → rencontre des personnes → le problème les touche toutes → l'inquiétude de chacune → ce qu'elles ont essayé → une phrase qui résume tout → le produit répond → les personnes, à nouveau, mais mieux loties → carte de fin. Le problème occupe 45 à 55 % de la durée. C'est la structure à utiliser lorsque le public doit d'abord se soucier.

Promotion de site web (30 à 60 s). Accroche énonçant le résultat → le produit fait sa seule chose principale, en grand → trois preuves (une fonctionnalité chacune, à l'écran deux à quatre secondes) → un moment humain → carte de fin. La valeur est énoncée dès la deuxième séquence ; tout ce qui suit est une preuve.

Démonstration de produit (60 à 120 s). Une personne avec une seule tâche, du début à la fin dans le produit réel. Chaque étape est un écran plus l'élément important, extrait en grand. Dites ce que la personne obtient à chaque étape, pas comment s'appelle le bouton.

Coupe sociale (10 à 30 s). Une idée. Le texte la porte sans son. La première image dit déjà quelque chose.

Adaptation au produit.

ProduitQui sont les personnesCe que signifie « le produit, en grand »
Application grand publicdes gens dans leur vie quotidienne, à la maison, en déplacementle téléphone, avec un élément de l'écran extrait à côté
Outil SaaS ou B2Bdes personnes dans des rôles : un responsable opérationnel, un fondateur, un agent de support, chacun avec une échéanceune fenêtre de navigateur, avec le panneau ou le chiffre important agrandi
Site web ou marketplaceun visiteur avec un besoinle site lui-même : le héros, une recherche, un résultat, un checkout, comme le défilement le capture
Boutique en ligne ou produit physiquel'acheteur et le moment de l'utilisationles propres photos et séquences du produit de l'entreprise, plus la page où vous l'achetez
Servicele client avant et aprèsle flux de réservation ou d'inscription, et le résultat que le service fournit

4. Personnages

Quand le film a des personnages, rendez-les particuliers. Pour chacun : un nom, un âge, un métier, une ville, et l'unique chose qu'ils veulent du genre de problème que ce produit résout. Donnez à différents personnages des désirs différents : un public d'inconnus se reconnaît dans au moins l'un d'eux. Dans un film pour une application de finances personnelles, c'était un vélo, une maison, un mariage et un voyage ; pour un outil de recrutement, cela pourrait être quatre managers avec quatre postes différents à pourvoir. Montrez le désir comme une image, et montrez chaque désir de la même manière.

Les noms doivent correspondre aux images que vous pouvez réellement obtenir, donc faites le casting et le nom ensemble (voir video-footage-and-screens). Gardez les chiffres d'une personne identiques à ceux du compte montré dans le produit, pour que l'histoire et les écrans concordent.

Ces personnes sont des exemples inventés joués par des modèles de banque d'images. Dites-le dans SCRIPT.md et ne les présentez jamais comme des clients.

5. Écrire le script

Écrivez des répliques à dire à voix haute, en petites séquences. Les exemples ci-dessous proviennent d'un film pour une application de finances personnelles ; écrivez l'équivalent pour le produit devant vous. Ce qui fonctionne :

  • Une accroche qui est un contraste ou une petite blague contenant une vérité : « Le jour de paie. Le meilleur jour du mois. Pendant environ quatre heures. »
  • Un rappel : installez « quatre heures », concluez avec « Neuf heures du matin... À midi, il est déjà dépensé. »
  • Des fragments pour les présentations : « Kabir. Designer. Il veut un seul vélo depuis trois ans. »
  • La propre question du personnage dans ses propres mots, une chacun : « Puis-je acheter le vélo, et dormir tranquille ? »
  • Une phrase qui nomme si bien le problème qu'elle pourrait être le titre du film : « Ils ne sont pas mauvais avec l'argent. Ils sont seuls avec. »
  • Une phrase qui passe la main au produit : « Tout le monde a des conseils. Personne n'a ses chiffres. » puis « Donnez-lui vos vrais chiffres. »

Règles :

  • Une idée par ligne. Des lignes de deux à cinq secondes. Un identifiant pour chaque ligne (n-01, p-01, e-01) : l'identifiant nomme le fichier audio et le clip.
  • Écrivez les nombres et les dates tels qu'ils sont prononcés : « vingt-vingt-huit », « mille neuf cent quatre-vingt-dix-neuf par mois ».
  • Utilisez la monnaie, les unités et les noms de lieux du public, et les mots qu'ils utilisent pour le problème.
  • Reprenez les affirmations du produit dans les propres mots du produit. Gardez un tableau dans SCRIPT.md : ligne, d'où elle vient.
  • Omettez les mots là où l'image le dit. Une étiquette de nom à l'écran n'a pas besoin de « voici Kabir ».
  • Après le premier passage complet, supprimez un dixième. C'est toujours trop long.

Les mots que l'entreprise elle-même évite, évitez-les aussi. Si son propre texte ne dit jamais « prêt », le narrateur non plus.

6. Le plan de tournage

Pour chaque ligne, décidez ce qui est à l'écran et ce qui change sur quel mot. Écrivez-le comme le tableau dans SCRIPT.md (temps, image, voix) et, une fois les timings établis, comme la liste des plans numérotés par image dans SPEC.md.

Vérifiez le plan par rapport à ces points avant de construire :

  • L'image 0 montre-t-elle déjà une personne ou un titre ? C'est la miniature.
  • Chaque ligne importante est-elle aussi à l'écran sous forme de texte ? Les salles sont bruyantes et les flux sont en sourdine.
  • Y a-t-il quelque chose qui dure plus de trois secondes sans rien changer ?
  • Chaque type de chose (étiquettes de nom, désirs, plans, conseils) est-il fait d'une manière uniforme tout au long ?
  • La fin rappelle-t-elle ce que l'ouverture a mis en place ?
  • La dernière image dit-elle où aller, et tient-elle au moins six secondes si elle porte un code QR ?

templates/SCRIPT.md contient ce formulaire prêt à remplir.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés