Communitygithub.com

morrimoz/scénario-vidéo-storyboard

À utiliser lorsque l'utilisateur a besoin de concevoir le script ET le storyboard d'une vidéo produit pour un logiciel, une application, un SaaS, une IA, une API, une fintech ou une startup — qu'il s'agisse d'une vidéo de lancement, d'une vidéo hero pour la page d'accueil, d'un reel de fonctionnalité, d'une démo produit, d'un explainer, d'un teaser, d'un segment keynote, d'une VSL ou d'un extrait pour les réseaux sociaux.

Qu'est-ce que scénario-vidéo-storyboard ?

Cette compétence permet aux agents IA de produire des scripts et storyboards professionnels pour des vidéos de produits technologiques (SaaS, IA, API, fintech, startup) en suivant une méthodologie structurée en cinq étapes. Elle est conçue pour les outils de codage assisté par IA comme Claude Code, Cursor, Codex, ou tout agent capable d'interagir avec des fichiers et de suivre des instructions détaillées. L'agent commence par interroger l'utilisateur sur le contexte du lancement (produit, audience, plateforme de diffusion, preuves disponibles) puis sélectionne une architecture narrative adaptée (AIDA, PAS, VSL, Explain, etc.) en fonction de la durée et de l'objectif. Il construit ensuite une séquence de preuves crédibles, structure le script en beats, et convertit chaque beat en cartes de storyboard prêtes pour la production — avec des indications visuelles, de montage, de doublage et de psychologie du spectateur. Le livrable final est un document unique contenant l'en-tête du script, l'arc narratif et émotionnel, un storyboard scène par scène, ainsi qu'une liste d'actifs nécessaires. L'agent intègre également des tests de qualité et des anti-patrons pour éviter les scripts trop génériques, les déversements de fonctionnalités ou les promesses non prouvées. Cette compétence fonctionne sur n'importe quel éditeur capable d'écrire et de formater du texte structuré.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/morrimoz/video-script-storyboard/tree/HEAD

Demander à votre IA préférée

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

Documentation

Script Vidéo & Storyboard

Rédigez des vidéos produits comme le font les meilleures équipes logicielles : un seul changement clair, une seule séquence de preuves crédible, une seule logique visuelle, une seule prochaine étape — puis convertissez chaque beat en un storyboard prêt pour la production qu'un motion designer peut exécuter immédiatement.

N'écrivez pas une publicité de marque générique avec une UI collée dessus. N'écrivez pas une liste de fonctionnalités avec des adjectifs cinématographiques. Faites comprendre au spectateur ce qui a changé, pourquoi c'est important et quoi faire ensuite — puis remettez un storyboard qui dit exactement à quoi ressemble chaque plan, comment il se lit et comment il bouge.

Le résultat est un document unique avec deux couches :

  1. Couche script - l'argumentaire, la séquence de preuves et le texte (gouverné par la discipline de lancement ci-dessous).
  2. Couche storyboard - des cartes de scène avec les visuels, le texte à l'écran, la voix off, le timing, la psychologie et les notes de mouvement. Lorsque le montage mélange des images réelles, des enregistrements d'écran, des graphismes conçus et des clips générés, marquez chaque scène avec l'une de ces quatre sources et un identifiant de slot afin qu'un monteur puisse y placer les médias plus tard.

Communication avec l'utilisateur

Avant d'écrire, clarifiez la forme du lancement. Posez les questions qui changent le script :

  • Qu'est-ce qui est exactement lancé (nouveau produit, ou nouvelle fonctionnalité d'un produit existant) ?
  • À qui cela s'adresse-t-il maintenant ?
  • Où la vidéo sera-t-elle diffusée : page d'accueil, page de lancement, keynote, extrait pour les réseaux sociaux, publicité payante, App Store, mise à jour pour les investisseurs ?
  • Que peut porter la page ou la campagne en dehors de la vidéo ?
  • Quelle est l'action unique après le visionnage : essayer, en savoir plus, s'inscrire, réserver une démo, regarder le keynote, lire la documentation ?
  • Quelles preuves avez-vous réellement : interface utilisateur, workflow, résultat, client, donnée chiffrée, démo en direct, avant/après ?
  • Quel ton doit avoir la vidéo : sobre, premium, technique, ludique, urgent, calme ?
  • Format(s) d'image : 16:9, 9:16, 1:1 ? (Décidez tôt - cela change le cadrage et le placement du texte.)

Si l'utilisateur vous remet une liste pléthorique de fonctionnalités, opposez-vous. Une vidéo de lancement hero n'est pas l'endroit pour déverser toute la feuille de route. Suggérez de diviser en un teaser, un film hero, une démo plus approfondie, un post de lancement ou plusieurs modules.

S'il demande "à la Apple" ou "à la Stripe", traduisez cela en structure, pas en mimétisme. Apple signifie réalité changée immédiate et modules produit épurés. Stripe signifie que vous pouvez ouvrir sur des enjeux de catégorie pour les produits techniques, mais vous devez fournir une preuve concrète presque immédiatement.

Privilégiez un seul public et un seul appel à l'action principal. Si le lancement sert plusieurs publics, laissez la page gérer les ramifications.

Si un détail manquant change la direction créative, posez jusqu'à trois questions. Sinon, énoncez vos hypothèses et poursuivez.

Étape 1 - Choisir l'architecture de lancement et le framework

Décidez quel travail cette vidéo accomplit, puis choisissez un framework adapté à sa durée et à son objectif.

Travail de la vidéo (répartition approximative) :

  • Film de lancement hero : faites le rapidement ; la page porte les détails.
  • Démo approfondie : parcourez le workflow et répondez à plus d'objections.
  • Teaser : créez du mystère ; n'essayez pas de tout expliquer.
  • Segment keynote : vous pouvez consacrer quelques beats supplémentaires aux enjeux, mais chaque minute supplémentaire a besoin d'un nouveau module de preuve.
  • Clip de version/fonctionnalité : une mise à jour, un avantage, un renvoi aux notes ou au produit.

Framework par durée et objectif :

FrameworkIdéal pourDuréeStructure
Hook-CTAPublicités sur les réseaux sociaux15-30sProblème → Solution → CTA
PASTrafic froid30-90sProblème → Agitation → Solution
AIDADémo produit / lancements de fonctionnalités60-120sAttention → Intérêt → Désir → Action
L'ExplainerÉducation d'abord60-180sContexte → Comment ça marche → Avantages → CTA
VSL ClassiquePages de vente3-10minHistoire → Problème → Solution → Preuve → Offre → CTA

Directives de durée :

DuréeTypeObjectif
6-15sMicro-contenuNotoriété, viralité
15-30sPublicités réseaux sociauxTrafic, intérêt
30-60sTeasers produit/fonctionnalitéDemandes de démo, clics
60-90sExplainersCompréhension, temps de visionnage
90-180sDémo complètesInscriptions à l'essai
3-10minVidéos de vente VSLDécisions d'achat

Écrivez le script pour un seul travail. Une vidéo devient molle quand elle essaie d'être à la fois teaser, manifeste, démo complète et conclusion de vente. Par défaut, privilégiez la brièveté que l'équipe ne souhaite pas - n'ajoutez du temps de lecture que lorsque l'idée est véritablement difficile à visualiser ou que chaque section ajoutée gagne sa place avec un nouveau module de preuve.

Étape 2 - Choisir l'accroche

Les 3 à 5 premières secondes déterminent la majeure partie du visionnage. Ouvrez sur la réalité changée, pas sur l'autocongratulation. Choisissez une accroche intentionnellement :

  1. Arrivée brutale / réalité changée. Idéal lorsque la marque a déjà l'attention. Dites ce qui est là maintenant ("GPT-5 est là").
  2. Douleur → soulagement. Idéal pour les produits de workflow. Nommez la friction, puis montrez le produit la supprimant. ("Fatigué de [douleur] ?")
  3. Avant/après tension. Idéal lorsque le contraste est visuel et immédiat.
  4. Enjeux macro → démo concrète. Idéal pour les infrastructures, fintech, IA, lancements d'API. Ouvrez sur le changement de catégorie, mais concrétisez-le dans une transaction visible, une commande ou un workflow dès le premier beat principal.
  5. Symbolique / métaphore d'abord. Seulement lorsque le produit n'est pas encore montrable ou trop abstrait. Rattachez rapidement la métaphore au produit.
  6. Démonstration / accroche de preuve sociale. Montrez un résultat impressionnant immédiatement, ou commencez par un chiffre spécifique ("10 000 équipes livrent déjà de cette façon").

Gardez la phrase d'ouverture simple. Évitez "révolutionnaire", "innovant" et autres remplissages similaires, sauf si le beat suivant prouve l'affirmation de manière visible. Testez l'accroche indépendamment - elle doit fonctionner comme une publicité autonome.

Étape 3 - Construire la séquence de preuves

Organisez le milieu par modules de preuve, pas par ordre de menu de fonctionnalités. Pour chaque module, écrivez :

  1. Affirmation : ce qui a changé.
  2. Preuve : le plan, le moment du workflow, le résultat, la métrique ou la démonstration qui la rend crédible.
  3. Implication : pourquoi le spectateur devrait s'en soucier.

Séquencez par tâche utilisateur ou résultat. Un workflow réaliste bat une liste de fonctionnalités. Donnez à chaque affirmation majeure l'espace pour s'imposer - un module de preuve fort bat trois modules faibles. Si le produit est technique ou axé sur l'infrastructure, gagnez en spécificité tôt ; ne restez pas longtemps au niveau marketecture.

Où placer les éléments de conversion (utilisez-les uniquement lorsque cela est honnête et approprié) :

  • Preuve sociale précoce (15-25%) : construisez la crédibilité avant les grandes affirmations.
  • Preuve de fonctionnalité (40-60%) : un témoignage ou un résultat après chaque avantage clé.
  • Preuve finale (80-90%) : axée sur les résultats, juste avant le CTA.

Ordre de traitement des objections : Est-ce que ça marche ? (démo + preuve) → Est-ce que ça marchera pour moi ? (cas d'utilisation) → Est-ce compliqué ? (montrez la simplicité) → Est-ce que ça vaut le coup ? (ROI/valeur) → Et si ça échoue ? (garantie/inversion du risque).

Menez avec la transformation, pas avec les fonctionnalités. Nommez la douleur avant la solution. Créez l'urgence par la valeur, pas par la rareté factice - jamais de comptes à rebours fictifs ou de rareté artificielle.

Étape 4 - Écrire les beats, les visuels, le rythme et le CTA

Pensez en beats, pas en paragraphes. Types de beats courants : contexte (ce qui a changé / ce qui fait encore mal), produit (la nouvelle capacité), preuve (action en direct, résultat, témoignage), lancement (qui y a accès, quoi faire, où approfondir).

Les transitions doivent faire avancer l'argumentaire, pas décorer. Coupe franche sur une nouvelle affirmation. Chevauchement ou pont pour la continuité. Ralentissez brièvement lorsque le spectateur doit analyser une interface utilisateur, du code ou un résultat.

Grammaire visuelle - restez contraint : un seul focus produit, une seule logique de mouvement, une seule direction artistique de soutien, un seul niveau de stylisation. Gardez l'interface ou la preuve concrète comme héroïne. Animez juste assez pour clarifier et élever, jamais au point que le produit livré paraisse décevant après.

Le texte à l'écran remplit l'un des quatre rôles suivants : étiqueter le moment, encadrer l'avantage, diriger l'attention, ponctuer la révélation. Ne l'utilisez jamais comme une transcription de la voix off. Si le cadre est chargé, simplifiez les mots ; si la ligne fait un travail explicatif, calmez le cadre. Prévoyez un visionnage sans son (la plupart regardent sans son) - l'histoire doit se lire avec le texte/les visuels seuls.

Voix off (si utilisée) : écrivez-la en morceaux de pensée parlés. Une phrase doit acheter une action visuelle, une révélation ou un avantage clair. Privilégiez le ton conversationnel devant l'interface utilisateur - la prose de documentation semble rigide à l'oral. Laissez les moments importants respirer.

CTA : restez simple et orienté vers l'action. Par défaut, un seul CTA après une séquence de preuves complète ou à la fin ; laissez la page gérer les ramifications par public/prix/doc. Minimum deux CTA uniquement pour les VSL plus longues (un teaser à mi-parcours une fois que suffisamment de preuves ont été apportées, plus le final). Soyez précis ("Commencez l'essai gratuit", pas "En savoir plus") et supprimez les frictions ("Pas de carte de crédit" si vrai). Si le CTA semble être une interruption, il est probablement trop tôt.

Étape 5 - Produire le storyboard (le livrable)

Convertissez le script en un document avec ces sections. Soyez concret sur ce que le spectateur doit comprendre et pourquoi la scène existe. Laissez l'exécution plan par plan au motion designer ou au monteur. Si la production a besoin d'une remise, terminez par quatre listes : les images à tourner, les prompts de clips générés, les scènes conçues et les enregistrements d'écran à capturer.

1. En-tête du script

# [Titre de la vidéo]

**Type** : [Film de lancement / Reel de fonctionnalité / Explainer / Démo produit / Publicité sociale / VSL]
**Durée** : [secondes totales]
**Format d'image** : [16:9 / 9:16 / 1:1]
**Objectif** : [Objectif de conversion principal]
**Public cible** : [Persona spécifique]
**Framework** : [AIDA / PAS / Hook-CTA / Explainer / VSL]
**Choix de l'accroche** : [Quelle accroche et pourquoi]

## Message clé
[Une phrase : que doivent retenir les spectateurs ?]

## Action souhaitée
[CTA spécifique : que doivent faire les spectateurs ?]

2. Arc narratif + parcours émotionnel

## Arc narratif
Accroche (0-Xs) : [Comment nous captons l'attention]
Construction (Xs-Ys) : [Comment nous construisons l'intérêt/le désir]
Apogée (Ys-Zs) : [Point culminant / proposition de valeur principale]
Fermeture (Zs-Fin) : [CTA et résolution]

## Parcours émotionnel
Début : [Frustré / Curieux / Dépassé]
→ Milieu : [Plein d'espoir / Intrigué]
→ Fin : [Conflant / Excité à l'idée d'agir]

3. Storyboard scène par scène

Écrivez une carte par scène :

## Scène N : [Nom de la scène] (Xs-Ys, Durée : Zs)

**Objectif narratif** : [Pourquoi cette scène existe - fait avancer l'histoire ET la conversion]

**Texte à l'écran** :
"[Texte exact à l'écran]"

**Voix off** (facultatif) :
"[Mots exacts prononcés]"

**Description visuelle** :
[Ce que voient les spectateurs - assez spécifique pour construire, pas pour trop spécifier]
- Arrière-plan / environnement
- Point focal principal (généralement le produit/la preuve)
- Visuels de soutien
- Traitement du texte

**Psychologie du spectateur** :
[État émotionnel créé · objection traitée (le cas échéant) · désir construit]

**Éléments de preuve / vente** :
[Correspondance affirmation→preuve · preuve sociale · inversion du risque · accent sur les avantages - uniquement si honnête]

**Transition vers la suivante** :
[Comment cela s'enchaîne et pourquoi cela fait avancer l'argumentaire]

**Notes pour le motion designer** :
[Rythme (rapide/lent), style (audacieux/subtil), moments clés à souligner, sur quoi s'attarder]

4. Exigences de production

## Actifs nécessaires
- [ ] Fichiers du logo
- [ ] Captures d'écran / maquettes / enregistrements d'écran du produit
- [ ] Photos ou citations de clients (si utilisation de témoignages)
- [ ] Éléments de dataviz, icônes
- [ ] Musique / direction VO

## Éléments de copie
- Titres / sous-titres (liste complète)
- CTA (liste de chaque instance)
- Citations de preuve sociale (liste complète, avec source)

## Directives de marque
- Voix : [Professionnelle / Décontractée / Technique / Amicale]
- Ton : [Sobre / Premium / Urgent / Calme / Passionnant]
- Restrictions : [Règles de copie ou visuelles, non-négociables vs. bonus]

Gardez les lignes de voix off parlables, le texte à l'écran court et la direction visuelle concrète. Marquez les métriques inventées ou les noms de démo comme des espaces réservés. Fournissez une direction visuelle, pas des spécifications techniques - laissez l'exécution plan par plan au motion designer.

Tester le script et le storyboard avant la remise

Clarté et preuve :

  • Le premier beat rend-il la nouvelle réalité claire ?
  • Chaque affirmation majeure obtient-elle une preuve visible ?
  • Un spectateur sceptique pourrait-il expliquer ce qui a changé après un seul visionnage ?
  • Le milieu est-il organisé par workflow/résultat, pas par déversement de fonctionnalités ?
  • Si vous supprimiez le logo de la marque, la preuve semblerait-elle toujours spécifique à ce produit ?

Rythme et densité du texte (lisez-le à voix haute) :

  • Une phrase qui essaie de couvrir plusieurs actions visuelles ?
  • Texte à l'écran qui répète la voix off ?
  • Grandes affirmations empilées sur un mouvement chargé ?
  • Aucune pause là où le spectateur a besoin d'analyser l'interface ?
  • Temps de lecture qui a augmenté sans ajouter de meilleure preuve ?
  • Si un moment semble surchargé, réduisez un canal : moins de mots, mouvement plus calme ou moins de texte.

Adéquation du CTA :

  • Le spectateur a-t-il vu suffisamment de preuves avant le CTA ?
  • Le CTA semble-t-il être la prochaine étape logique ?
  • Le film essaie-t-il de segmenter les audiences que la page devrait segmenter ?

Préparation à la production :

  • Chaque scène a un timing et une durée.
  • Les descriptions visuelles sont claires et spécifiques.
  • Les actifs sont listés ; les notes du motion designer sont présentes ; l'objectif narratif est énoncé par scène.
  • Le format est prêt pour la remise sans clarification.

Si la réponse à une question de clarté est non, le script est encore trop générique.

Améliorer un brouillon faible

Resserrez l'abstraction en preuves. Remplacez les affirmations vagues par une étape de workflow, un résultat, un avant/après visible, une commande réelle, un artefact concret, un nombre avec contexte ou un résultat utilisateur. "Collaboration puissante" est faible. "Réviser, commenter et livrer à partir du même fichier" est plus fort. Montrer que cela se produit est encore plus fort.

Supprimez l'amas d'informations. Ne laissez pas la thèse macro, la narration dense, l'interface utilisateur chargée et de nombreuses étiquettes arriver en même temps. Choisissez le canal principal par beat : si le visuel le porte, simplifiez la ligne ; si le concept est abstrait, calmez le visuel et laissez la ligne expliquer ; si l'avantage est nouveau, faites une pause assez longtemps pour l'enregistrer.

Divisez un film boursouflé en plusieurs actifs. Teaser pour l'anticipation · film hero pour le cas principal · démo approfondie pour la compréhension · page de lancement/notes pour les détails · extraits pour les réseaux sociaux/annonces. Les lancements répétés battent généralement un méga-lancement surdimensionné.

Anti-patrons

Au niveau du script : ouvrir sur des adjectifs au lieu d'une réalité changée · manifeste de marque sans preuve · déversement de fonctionnalités (cinq fonctionnalités, deux secondes chacune, zéro preuve) · CTA générique ("En savoir plus") · vidéo qui essaie d'être un teaser, un film hero, une démo, une VSL et un post de lancement en une seule fois.

Au niveau des visuels : l'interface utilisateur du produit est minuscule dans le cadre · animation qui submerge l'interface utilisateur · texte à l'écran qui répète la voix off · le produit réel n'apparaît qu'à la moitié ou se cache derrière des graphiques abstraits · tout le film a l'air d'un maquillage de modèle 3D que le produit réel ne peut pas égaler · le motion designer doit deviner quoi construire.

Au niveau du CTA : aucun CTA (le spectateur ne sait pas quoi faire) · CTA trop tôt (pas assez de preuves) · CTA vague ou rempli de jargon · plus d'un CTA dans une vidéo courte sans raison · le CTA promet quelque chose que la page ne livre pas.

Si le brouillon présente l'un de ces problèmes, corrigez-le en amont avant de construire le storyboard. Si vous devez pousser en retour, faites-le - nous écrivons des vidéos qui fonctionnent, pas des vidéos qui font plaisir à tout le monde.

Skills associés