Communitygithub.com

ai-video-script

Rédige la narration et le story-board d'une courte vidéo : script parlé avec une revue en trois passes pour éliminer le style IA, liste des plans, grille des temps forts et film.json comme source unique de vérité. S'exécute après ai-video-brief, avant le rendu.

Qu'est-ce que ai-video-script ?

Cette compétence, conçue pour les agents IA comme Claude Code, Cursor ou Codex, automatise la création de contenu vidéo court après la phase de brief et avant le rendu. Elle produit un script parlé, un story-board détaillé, une grille des temps forts (beat grid) et un fichier film.json qui sert de source unique de vérité pour toutes les étapes suivantes. Le processus comprend une revue en trois passes du script pour éliminer les clichés d'IA, vérifier le chevauchement avec une source éventuelle (moins de 15 % de mots communs, pas de 8 caractères identiques consécutifs), et garantir un style oral naturel. La compétence impose des règles précises de timing (plans de 1,5 à 5 secondes, changement visible toutes les 2 à 3 secondes), de composition des plans (lead, éléments secondaires, arrière-plan) et de synchronisation musicale (actions fortes sur temps forts). Elle ne génère pas de code de rendu, mais uniquement les fichiers textes et de métadonnées (script.md, storyboard.md, beat-grid.json, film.json) prêts pour l'étape de production.

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

Demander à votre IA préférée

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

Documentation

ai-video-script : Rédaction de la narration et story-board

Quand l'utiliser

Le brief est verrouillé et l'utilisateur a choisi un angle narratif. Cette compétence rédige le script parlé, la liste des plans, la grille des temps forts et le fichier film.json. Ne commencez pas le rendu avant que ces fichiers n'existent.

1. Rédiger d'abord le script

  • Rédigez la narration comme un texte parlé, pas comme une prose écrite. Lisez chaque ligne à voix haute dans votre tête : si une phrase ne peut pas être prononcée en une seule respiration, coupez-la.
  • Estimez la durée à environ 4,5 caractères chinois par seconde pour la planification uniquement. La synchronisation finale provient toujours de la durée réelle de la voix off, jamais de l'estimation.
  • Règle de durée des plans : chaque plan prend le maximum entre le temps d'action, le temps de lecture et l'estimation de la narration, plus une pause. La durée totale du film est la somme de toutes les images des plans. N'étirez jamais l'audio pour l'adapter à un plan.

2. Revue en trois passes pour éliminer le style IA

Effectuez les trois passes sur le script avant de passer au story-board. Conservez les notes de revue dans script.md.

  • Passe 1, couper les clichés IA : supprimez les phrases toutes faites, les intensificateurs vides et les phrases qui ne disent rien avec beaucoup de mots. Chaque phrase doit porter un fait, une image ou une action concret.
  • Passe 2, vérification du chevauchement : si le script adapte un texte source, les mots réels communs avec la source doivent représenter au maximum 15 %, sans 8 caractères identiques consécutifs. Réécrivez, ne paraphrasez pas en surface.
  • Passe 3, vérification à voix haute : le script doit donner l'impression qu'une personne parle, pas un essai. Supprimez les constructions propres à l'écrit et les phrases qui ne fonctionnent que sur le papier.

3. Construire le story-board

Utilisez templates/storyboard.md. Règles :

  • Un plan dure de 1,5 à 5 secondes et montre exactement une chose.
  • Un changement visible toutes les 2 à 3 secondes : entrée, action principale, action secondaire, sortie ou transition.
  • Ouvrez les 3 premières secondes avec une petite scène concrète, pas un carton titre. Un exemple concret parcourt tout le film.
  • Chaque ligne de plan comporte : numéro, intervalle de temps, image, action, mouvement de caméra, texte à l'écran (8 caractères maximum), méthode.
  • Choisissez 2 mots d'accent fixes pour tout le film, plus 3 à 8 mots d'accent pour les sous-titres. Utilisez-les de manière cohérente.
  • Alternez les plans A et B au moins toutes les 8 à 12 secondes.
  • Nommez le sujet principal, les éléments secondaires et l'arrière-plan pour chaque plan. Le sujet principal bouge en premier et le plus ; les éléments secondaires le suivent 2 à 5 images plus tard avec un mouvement plus petit.
  • Donnez à chaque grande action six phases : préparation, étirement, impact, écrasement, dépassement, stabilisation.
  • Gardez une direction de lumière principale pour tout le film, avec des reflets et des ombres de contact suivant l'action.

4. Grille des temps forts (beat grid)

Commencez par la musique : choisissez le morceau, définissez son BPM, écrivez templates/beat-grid.json avec les horodatages et les marques de temps forts/faibles. Placez les actions fortes et les coupes sur les temps forts. Déplacez les effets sonores à partir du mouvement lui-même. Utilisez des courbes d'accélération/décélération ; pas de mouvement linéaire sauf mouvement mécanique délibéré.

5. film.json est la source unique de vérité

Écrivez templates/film.json : titre, format, fps, durée, style, voix, et la liste des plans avec heures de début/fin, image, voix off, texte à l'écran et méthode. Chaque étape ultérieure (rendu, voix off, revue) lit ce fichier. Si le script change, mettez d'abord à jour film.json, puis redérivez le reste.

Contrat de sortie

  • script.md (narration + timing + notes de revue en trois passes).
  • storyboard.md (tableau des plans).
  • beat-grid.json (BPM + temps forts/faibles).
  • film.json (source unique de vérité).

Règles

  • N'écrivez pas de code de rendu dans cette compétence. Texte et timing uniquement.
  • Un plan qui ne peut pas être décrit en une ligne du tableau est deux plans ; coupez-le.
  • Les faits incertains restent marqués « à vérifier » jusqu'à contrôle ; ne les lissez jamais avec des formulations confiantes.

Individual skills in this repo

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

Skills associés