Communitygithub.com

storyboard-director

Crée des storyboards de production où chaque plan enregistre le texte, la position, les visuels, le mouvement, le son, le timing et son lien avec le script.

Qu'est-ce que storyboard-director ?

Ce skill guide un agent IA (comme Claude Code, Cursor ou Codex) dans la création de storyboards de production complets et rigoureux, destinés à des vidéos verticales 1080×1920 à 60 FPS. Il va bien au-delà d'une simple suite d'images : chaque plan (beat) doit documenter de manière structurée le texte (VO et à l'écran), les visuels, les positions en coordonnées normalisées, les mouvements, le son, les transitions et le timing précis en trames. Le skill impose un workflow en 8 étapes, depuis le verrouillage du brief jusqu'à la validation de la continuité et de la durée totale, et fournit un modèle de sortie standardisé. Utile pour tout projet de vidéo courte (réseaux sociaux, publicités, tutoriels), il garantit que le storyboard soit directement utilisable par d'autres agents (comme frame-time-engineering) pour l'implémentation technique, tout en évitant les erreurs de communication fréquentes comme les positions vagues ou les durées non contiguës.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/achmdfzn/motionforge-atelier/tree/HEAD/.claude/skills/storyboard-director

Demander à votre IA préférée

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

Documentation

STORYBOARD DIRECTOR

Obligatoire

Un storyboard n'est pas une simple liste d'images. Chaque scène et plan doit indiquer : texte/narration, visuels, position/disposition, mouvement, son et temps. Utilisez le modèle docs/templates/STORYBOARD_TEMPLATE.md.

Workflow

  1. Verrouillez le brief, le format vertical 1080×1920, 60 FPS, la durée, l'audience, le guide de style et le message principal.
  2. Divisez le script en phrases/plans atomiques ; donnez-leur des ID stables (S01-B01, etc.). Ne fusionnez pas des phrases différentes sans raison.
  3. Pour chaque plan, écrivez le texte VO exact, le texte à l'écran exact, ce qui est visible, le sujet/élément et l'action.
  4. Définissez les positions avec des coordonnées normalisées 0..1 (x, y, w, h), l'ancre, l'alignement, le calque/z-order, la zone de sécurité et le sens de lecture. Incluez les tailles/positions en pixels si nécessaire.
  5. Définissez le cadrage, la caméra, les transitions, le mouvement d'entrée/sortie, la durée, l'image de début/fin et le chevauchement.
  6. Enregistrez l'audio : clip VO, musique, ambiance, bruitages, image de déclenchement, durée, gain relatif, fondu et pauses/silence.
  7. Associez chaque phrase VO à un ou plusieurs visuels/plans qui clarifient son sens. Évitez les visuels littéraux répétitifs ; utilisez la métaphore quand c'est plus pertinent.
  8. Validez la continuité, la lisibilité sur mobile, la zone de sécurité, le timing et que la durée totale correspond.

Sortie obligatoire par plan

  • ID, scène, image de début/fin, durée en images et en secondes.
  • ID de phrase VO + texte.
  • Texte à l'écran + position.
  • Visuel/élément + composition et position.
  • Mouvement/caméra + easing.
  • Cue audio : type, fichier/placeholder, début/fin, niveau relatif, fondu.
  • Transition entrée/sortie et notes de continuité.

Règles

  • Tout texte visible doit être écrit textuellement, pas "ajouter un titre".
  • Toutes les positions doivent être explicites, pas "approximativement au milieu".
  • Tout son doit être enregistré, y compris la décision de n'avoir aucun son/silence.
  • N'inventez pas d'éléments qui n'existent pas encore ; marquez-les PLACEHOLDER et listez les besoins en ressources.
  • Durée d'un plan à 60 FPS : durationInFrames = endFrame - startFrame avec une borne de fin exclusive.
  • Un logo de fin + CTA est obligatoire et doit être spécifique à la vidéo, pas générique.

Conventions d'ID et de temps

  • ID de plan : S<scene>-B<beat> avec deux chiffres (S01-B01). Les ID ne changent pas quand un plan est déplacé ; un plan inséré reçoit un nouvel ID (S02-B03) au lieu de tout renuméroter.
  • Intervalle semi-ouvert [startFrame, endFrame) : l'image endFrame appartient déjà au plan suivant.
  • Conversion de secondes en une seule fois, à un seul endroit : frame = round(seconds × fps). Après cela, chaque nombre dans le storyboard est une image entière.
  • Les plans consécutifs doivent être contigus : l'endFrame du plan N = l'startFrame du plan N+1. Le chevauchement n'est autorisé que pour les fenêtres de transition enregistrées dans la colonne Transition.
  • Total : l'endFrame du dernier plan = la durationInFrames de la composition.

Format de sortie

  • En-tête : ID du projet, canvas, FPS, durée (secondes + images), chemins vers le guide de style et le plan audio.
  • Tableau des plans suivant docs/templates/STORYBOARD_TEMPLATE.md.
  • Notes par plan pour les plans complexes (mouvement multi-étapes, personnages, 3D).
  • Correspondance phrase-plan quand il y a une VO, ou une seule ligne "non applicable — pas de VO".
  • Fiche des cues audio, y compris les silences intentionnels.
  • Spécification de l'écran de fin sur mesure.
  • Liste des ressources PLACEHOLDER avec les besoins et le statut de licence.

Liste de contrôle QA

  • Chaque plan a un ID, une image d'entrée/sortie, un texte textuel (ou "—"), un visuel, une position normalisée, un mouvement, un son et une transition.
  • Les plans sont contigus à partir de l'image 0 ; la somme des durées = durationInFrames.
  • Le texte important se trouve dans la zone de sécurité et se lit sur un écran de téléphone (taille, contraste, temps d'affichage).
  • Le texte reste à l'écran assez longtemps pour être lu ; les phrases longues sont divisées ou bénéficient de plus de temps.
  • Chaque phrase VO a un plan associé ; chaque plan a un objectif éditorial.
  • Le silence est écrit explicitement, pas laissé vide.
  • Le mouvement est décrit en fonction de l'image (de/à, intervalle d'images, easing), prêt à être traduit par frame-time-engineering.
  • L'écran de fin continue le motif de la vidéo et son CTA est textuel.
  • Chaque ressource qui n'existe pas encore est marquée PLACEHOLDER.

Mini exemple

Un plan d'accroche textuelle de 2 secondes :

ID planImagesVOTexte à l'écranVisuelPositionMouvementSonTransition
S01-B010–120—Pourquoi votre vidéo semble-t-elle générique ?Fond sombre unix .08, y .40, w .84 ; aligné à gauche ; z 2Chaque mot entre toutes les 10 images, glisse vers le haut de 24 px, durée 14 images, ease-outSilence 0–30, SFX-001 whoosh à 30cut

Mouvement prêt à coder : le mot i commence à l'image i × 10 ; opacity 0→1 et translateY 24→0 sur [i×10, i×10+14].

Modes d'échec

  • "Le texte apparaît au milieu" → ne peut pas être codé ; écrivez x/y/w/h, l'ancre et l'alignement.
  • Plans décalés d'une image (0–119 puis 120–240) → la convention exclusive n'a pas été utilisée ; passez tout en semi-ouvert.
  • Texte modifié dans le code mais pas dans le storyboard → le storyboard est la source de vérité pour le texte ; mettez d'abord à jour le storyboard.
  • La durée totale ne correspond pas à la composition → recalculez à partir du tableau ; ne corrigez pas dans le code.
  • Visuels trop littéraux par phrase → utilisez une démonstration, un schéma ou une métaphore ; enregistrez la raison.
  • L'écran de fin est un logo + "Suivez-nous" → pas sur mesure ; construisez un pont visuel à partir du motif de la vidéo.

Individual skills in this repo

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

Skills associés