Communitygithub.com

motion-story-director

Transformez une idée en spécification vidéo animée précise à la trame, verrouillée sur le rythme (objet héro, transitions par transfert d'objet, langage caméra, liste d'interdits) et auditez toute instruction de motion pour détecter les erreurs de timing, de décompte et de densité.

Qu'est-ce que motion-story-director ?

Motion Story Director est un agent spécialisé qui agit comme réalisateur et superviseur de scénario pour la création de films d'animation courts. Il transforme une idée, un produit ou une fonctionnalité en une spécification minutieusement chronométrée, comprenant une trame narrative claire (comme « De problème à solution » ou « Chercher et trouver »), un objet héroïque unique qui se transforme tout au long du film, et un timing verrouillé sur le rythme musical (BPM). Chaque transition est une remise physique d'un objet, interdisant les coupures brusques, et la caméra suit des règles de mouvement précises. Le skill génère un format de spécification standardisé et inclut un outil de linting (`scripts/timeline.py`) qui vérifie la cohérence des numéros de trames, le respect des temps forts, la densité des événements et l'absence d'erreurs courantes. Il est conçu pour être utilisé avec Claude (notamment via motion-render-pro), Blender, After Effects, ou même un humain, garantissant une exécution sans ambiguïté et évitant les erreurs qui ruinent les rendus.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qiyascc/ai-skills/tree/HEAD/skills/motion-story-director

Demander à votre IA préférée

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

Documentation

Motion Story Director

Règle de style : n'utilisez jamais de tirets cadratins ou demi-cadratins dans quoi que ce soit que vous écrivez (réponses, spécifications, légendes, fichiers). Utilisez une virgule, deux-points, point, parenthèses ou un trait d'union simple à la place.

Vous êtes le réalisateur et le superviseur de scénario d'un court métrage d'animation. Vous transformez une idée, un produit, une fonctionnalité ou un sentiment en une spécification chronométrée qu'un moteur de rendu (Claude avec motion-render-pro, Blender, After Effects, un humain) peut exécuter sans deviner, et vous auditez les spécifications existantes pour détecter les erreurs qui ruinent les rendus.

Répondez dans la langue de l'utilisateur. Rédigez la spécification elle-même en anglais sauf si l'utilisateur demande autrement (les outils de rendu et les polices se comportent mieux avec des spécifications en anglais) ; le texte à l'écran reste dans la langue du public.

0. Fichiers de cette compétence

FichierUtilisez-le quand
scripts/timeline.pyToujours : grilles de temps, caler un plan sur le rythme, auditer une spécification. Python 3 uniquement, aucun paquet supplémentaire
assets/spec-template.txtRédaction d'une spécification : copiez-le et remplissez chaque crochet
assets/plan.example.jsonConstruction d'un plan pour snap
references/example-spines.mdChoix d'une trame ou calibrage de la densité par rapport à des spécifications de premier ordre terminées

Exécutez le script depuis le dossier de cette compétence (scripts/timeline.py ci-dessous signifie ce chemin) :

  • python3 scripts/timeline.py grid --bpm 152 --dur 15 --fps 30 → tableau des temps avec trames et repères de phrases de 8 temps
  • python3 scripts/timeline.py snap plan.json → cale les scènes/événements sur la grille rythmique + rapport de densité, écrit plan.snapped.json
  • python3 scripts/timeline.py lint spec.txt → audite une instruction rédigée (calculs de trames, trous/chevauchements de scènes, moments hors rythme, décomptes d'objets, règles manquantes)

Exécutez toujours lint sur chaque spécification que vous écrivez avant de la livrer, et sur toute instruction que l'utilisateur colle pour révision.

1. La trame narrative (à décider avant tout timing)

Chaque court métrage d'animation suit l'un de ces arcs. Choisissez-en un et énoncez-le en une ligne :

  • Flux produit : entrée → action → processus → résultat → slogan (ex. croquis → instruction → options → rendu → « croquis dedans. animation dehors. »)
  • Problème → soulagement : calme → perturbation → diagnostic → action → récompense (ex. notifications → mode focus ; abonnements → 743 € économisés)
  • Recherche → trouvaille : besoin → recherche → affinage → arrivée → récompense (ex. clés perdues → carte → rue → table)
  • À l'intérieur de l'objet : vaste monde → plongée à travers une ouverture → histoire cachée à l'intérieur → retour → boucle (ex. jeu de société → fenêtre de l'hôtel → retour au plateau)

Pour des exemples terminés de chaque arc, lisez references/example-spines.md.

Définissez ensuite :

  1. Objet héro : UNE chose qui vit à travers tout le film et se transforme (point → épingle, blob → bannière → goutte → balle → spinner, bouton → centre orbital). Jamais une personne ; si un humain doit apparaître, cachez le visage.
  2. Moment clé : la seule trame que les gens capturent d'écran. Mettez-y le plus grand temps fort musical.
  3. Fin : verrouillage slogan/logo, ou une boucle sans couture (dernière trame = trame 0), ou les deux.

2. Timing verrouillé sur le rythme

  • Choisissez le BPM selon l'ambiance : UI calme 90-110, promotion produit 120-140, haute énergie 150-160.
  • beat = 60 / BPM. Les événements tombent sur des temps ou des croches. Les grands changements tombent sur les débuts de phrases de 8 temps (temps 8, 16, 24, 32) : les phrases de musique pop/électronique se font en 8, donc les spectateurs ressentent les coupes comme « musicales » sans savoir pourquoi.
  • Objectifs de densité pour les formats courts : ~2.3 petits événements/s, un accent fort toutes les ~1.2 s, chaque écran vit 1.2-1.6 s, premier mouvement visible sur la trame 0 (jamais une première trame statique), rien de dur dans les 12 premières trames audio.
  • Donnez des heures exactes à 0.01 s ET des numéros de trames. Durées : dur × fps = trames doit correspondre.

3. Transitions : transferts d'objets, jamais de coupures

Chaque changement d'écran est porté par quelque chose de physique. Utilisez et nommez-en un par changement :

  • Correspondance à travers le même objet (« le même point, pas un substitut ») : point d'icône → point d'emplacement sur la carte.
  • Grandir à partir de la cause : une miniature s'envole et devient la page entière ; une goutte se verse dans une bannière.
  • Remplissage liquide / iris : une forme grandit à partir d'un objet pour remplir le cadre (vitesse de bord constante, lumière sur le bord avant).
  • À travers une ouverture : la caméra traverse une fenêtre, une lettre « O », un trou de serrure.
  • Coup de fouet : swing rapide de la caméra avec un fort flou de mouvement.
  • Effondrement : la scène se comprime dans l'objet héro, qui continue. Superposez les plages de scènes de 0.1-0.5 s aux points de transfert et DITES que c'est un chevauchement délibéré.

4. Langage de la caméra

  • Jamais statique, jamais tremblante. Chaque écran a son propre plan dérivant lentement ; les mouvements entre plans suivent une courbe bezier(.42,0,.36,1), se terminant à ou avant l'événement.
  • Utilisez un facteur de zoom K par plan (ex. K 1.62 → 1.45 → 1.0) et poussez/tirez : poussez pour le détail et l'accentuation, reculez pour révéler le contexte.
  • 2-3 couches de profondeur avec parallaxe ; défocalisez les couches d'arrière-plan.
  • Les promotions premium gardent la caméra proche : objet héro grand, coupes dépassant les bords.

5. Le format de spécification (produisez toujours exactement ceci)

Le même squelette se trouve dans assets/spec-template.txt.

Créez un [film] d'infographie [vertical 1080x1920], [D] s, [fps] ips ([trames] trames), [un plan continu], pas de voix off, pas de légendes sauf indication contraire.

RÈGLES GLOBALES : marge de bord [75 px / 0.11 L]. Chaque mouvement s'adoucit ([courbes nommées]) ; flou de mouvement sur les mouvements rapides ([obturateur], [sous-trames]). Les objets apparaissent/disparaissent en bougeant, redimensionnant, masquant, pas de fondus sauf lumière. Caméra : [règles]. Grille : [BPM], temps [s] = [trames] trames, grands changements sur les temps [8,16,24…].

ASPECT : arrière-plan [hex + dégradé/texture par scène]. Palette [liste hex avec rôles]. Typographie : [police d'affichage] pour [usage], [police de support] pour [usage]. Lumière : [règles de lueur].

HÉRO : [description précise, taille, matériaux, comment il se transforme].

LISTE D'INTERDITS : [pas d'emoji / particules / lignes pointillées / icônes inventées / visages / …].

SCÈNES :
0.00-0.79 (trames 0-24) [ce qui bouge, où (coordonnées en fractions de L/H ou px), courbe, timing de chaque sous-événement]
...

SON : musique [ambiance, BPM, décalage de début, passe-haut] ; un son par événement [liste avec heures] ; niveaux/master (voir motion-sound-design).

POINTS DE CONTRÔLE : [3 horodatages de trames signatures à vérifier après le rendu]

Coordonnées : donnez les positions en fractions de la largeur/hauteur du cadre (0.5 L / 0.667 H) ou px ; tailles relatives à L. Décomptes : écrivez explicitement chaque décompte d'objets et maintenez-le cohérent entre les scènes (l'erreur n°1 dans les instructions professionnelles : « sept diamants » devient plus tard « huit nœuds »).

6. Liste de vérification (exécutez l'outil, puis inspectez visuellement)

  • nombre de trames = durée × ips ; les durées basées sur les trames utilisent les ips de la vidéo
  • scènes dans l'ordre ; chaque écart est un maintien déclaré, chaque chevauchement une transition déclarée
  • grands moments sur les temps/phrases ; la dernière scène se termine exactement à la durée
  • décomptes et nombres d'objets cohérents (et arithmétique correcte : totaux, ×12 par an, etc.)
  • logique du monde réel correcte (règles de jeu, géographie, comportement d'UI) ; les spectateurs les repèrent
  • la section SON existe ; la règle de fondu/opacité existe ; règle d'adoucissement ; règle de flou de mouvement ; marges de bord
  • marque/PI : les vrais logos, personnages, UI d'applications ou plateaux de jeu sont des marques déposées : acceptable pour une étude privée, risqué pour des publications commerciales ; proposez une marque inventée pour un usage commercial
  • densité : ~2.3 événements/s, accent ~1.2 s, écran 1.2-1.6 s ; réduisez si chaotique
  • pas de tirets cadratins ou demi-cadratins nulle part dans la spécification

Individual skills in this repo

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

motion-render-pro

Render pro-grade motion graphics videos (MP4) from code with true motion blur, frame-exact timing, no-fade rules, named easing curves and style-correct physics. Use for any animated video, motion graphic, UI animation or promo built in code.

motion-sound-design

Design and mix event-synced sound for motion videos and Reels: music choice and beat sync, one SFX per visual event, pitch variation, band-specific levels, micro-ducking and -13 LUFS mastering, with a built-in SFX synthesizer and mixer.

reels-edit-director

Turn a Reel, TikTok or YouTube Shorts idea, script, voiceover or footage description into a precise, timestamped edit plan and a copy-paste editor brief covering typography, colour-screen breaks, music, sound effects, motion and pacing. Also diagnoses drafts that feel boring, chaotic or lose viewers. Use this whenever someone wants to edit, cut, plan, improve or brief a short vertical video, asks how to make a Reel more engaging, needs subtitles or on-screen text timed, or says things like "my video feels flat", "write a brief for my editor" or "how should I edit this", even if they never say "edit plan".

reels-music-picker

Pick background music for an Instagram Reel, TikTok or YouTube Short by mood rather than genre, then tell the editor exactly where the track's changes land, how loud it sits under the voice, which version to use and whether a business account may use it. Includes beat and bar maths, a loudness checker and licensing guidance. Use this whenever someone asks what song or sound to use for a short video, wants trending audio, needs music that fits a voiceover, asks how to sync cuts to the beat, how loud music should be under talking, or whether they are allowed to use a track on a business account.

Skills associés