Communitygithub.com

jayfirke/motion-studio

Planifiez un film en tant que réalisateur et montrez-le au propriétaire sous forme de page prévisualisable (animatique avec voix réelle, musique et bruitage, timeline, trois options échangeables pour chaque décision, notes ancrées dans le temps, versions et un bouton d'approbation) avant tout rendu. À utiliser pour tout nouveau film de plus de 10 s, lorsque le propriétaire demande à « le voir d'abord », « prévisualiser », « storyboard », « animatique » ou « visualiser avant de rendre », et lorsqu'il laisse des notes sur une page de prévisualisation. Produit un fichier `approved-video-spec.json` pour les compétences moteur ; ne rend jamais le produit final lui-même.

Qu'est-ce que motion-studio ?

Cette compétence, `video-director-previs`, permet à un agent IA comme Claude Code de jouer le rôle de réalisateur numérique pour la pré-production de films, en particulier pour les séquences de 10 secondes et plus. Elle fournit une application web fixe appelée Previs Studio (une application React + TypeScript) qui permet au propriétaire du projet de visualiser et de commenter chaque aspect du film avant tout rendu coûteux. Chaque décision créative – direction artistique, musique, montage, voix, effets sonores – est présentée avec trois options distinctes, et le propriétaire peut les comparer, laisser des commentaires ancrés dans le temps, et approuver une version finale. La compétence gère l'ensemble du flux de pré-production : de l'interprétation du brief, à la création des storyboards et animatiques, en passant par la production audio (voix via Fish TTS, musique CC0 et bruitages), jusqu'à la gestion des révisions et l'approbation finale. Une fois approuvée, elle produit un cahier des charges (`approved-video-spec.json`) que d'autres compétences moteur (comme HyperFrames, Remotion, ou Diffusion Studio) utiliseront pour le rendu final. Elle fonctionne sur Claude Code, Claude.ai (via Artifacts), et en local, avec un système de commentaires et de base de données intégré pour suivre les notes, les versions et l'activité. La règle d'or est de permettre des décisions créatives coûteuses à l'étape la moins chère : la pré-production.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jayfirke/motion-studio/tree/HEAD/.agents/skills/video-director-previs

Demander à votre IA préférée

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

Documentation

video-director-previs

Prenez des décisions créatives coûteuses à l'étape la moins chère. Cette compétence gère la pré-production : direction, histoire, scénario, storyboard, styleframes, animatique, musique, effets sonores, voix, choix du moteur, assurance qualité, révision, versions et approbation. Les moteurs (HyperFrames, video-shotcraft, Remotion, motion-reel, bang-motion, Diffusion Studio) ne construisent que ce que le propriétaire a approuvé.

Exemple concret : examples/crumb-previs/ (une application de partage de facture fictive). Son pack de données est le film de démonstration dans Previs Studio (_shared/previs/studio/films/011-crumb/).

L'application ne change jamais par film. Previs Studio est une application React + TypeScript fixe (source _shared/previs/app/, voir son README). npm run build y effectue la vérification de type, regroupe et intègre le tout dans _shared/previs/studio/index.html et _shared/previs/page/index.html (template) ; ajoutez une cible dans scripts/inline.mjs pour chaque page par film. npm run smoke pilote la page construite dans un vrai Chrome en mode desktop, tablette, téléphone et plein écran (captures d'écran avec --out). Ne modifiez jamais manuellement le index.html construit.

Ce que le propriétaire obtient : Regarder (lecteur vidéo avec vrai plein écran, prévisualisation au survol, carte de fin ; mode commentaire qui nomme la plus petite partie sous le pointeur, défilement pour agrandir ou réduire, glisser une boîte autour de plusieurs parties, stylo et flèche, glisser sur la rangée de plans pour une plage temporelle ; pistes sonores avec formes d'onde, battements, courbe de duck, solo/mute/volume et effets sonores glissables qui s'accrochent au rythme), choix qui rejouent leur moment en place avec le son, comparaison côte à côte, maintenir pour entendre l'original, Storyboard (cartes qui jouent leur plan en place, Lire tout, choix par plan, une feuille de plans), Plan (directeur en chef, histoire, équipe de réalisation, aspect visuel, son, assets, production, vérifications, versions avec « demander à annuler », exportation du cahier des charges), une révision guidée, Demander au réalisateur, recherche ⌘K, annuler/rétablir, thèmes clair et sombre, infobulles sur chaque contrôle. Les films arrivent uniquement sous forme de packs de données.

Deux foyers, même application

  • Previs Studio (tous les films) : _shared/previs/studio/. Ajouter un film = ajouter films/<id>/previs.json + films/<id>/audio/... et une ligne dans films.json. Localement : python3 -m http.server --directory _shared/previs/studio (ou l'entrée previs-studio dans .claude/launch.json).
  • Page par film : projects/NNN/previs/page/ contient une copie du même index.html (titre <Produit> Previs), films.json avec une ligne dont le path est "", previs.json et audio/.
  • En tant qu'Artifact claude.ai (Claude uniquement) : publiez la page avec les capabilities: {"db": {}, "user": {}, "sample": {}, "comments": {}, "downloads": true}. db stocke les notes et les choix, sample alimente Demander au réalisateur, comments transporte « Envoyer à Claude Code », downloads l'exportation du cahier des charges. Sans elles, la page fonctionne toujours et sauvegarde dans le navigateur.
  • Chemins de base de données : commentaires (demandes de modification épinglées au film ; la collection conserve l'ancien nom) films/<id>/notes (kind frame, region, range, sound, shot, revert ou request ; target, targets, box, strokes, quick, t/t2, picks et version au moment donné) ; choix et ajustements sonores films/<id>/state/picks (tweaks : <scene>.<sfx> {dt, db}, lane.vo|music|sfx {db}, mix.duck {on}) ; options ajoutées films/<id>/state/custom ; approbation films/<id>/state/approval ; statut de Claude films/<id>/state/claude ; activité films/<id>/activity ; notes (pensées libres sur l'ensemble du film : lisez-les comme contexte, jamais comme des tâches) films/<id>/pad.

Bibliothèques : plus de trois options à la demande

Chaque décision est livrée avec trois options de réalisateur ; D['libraries'] en ajoute d'autres que le réviseur (ou l'onglet Demander) peut importer : direction (aspects visuels : ensembles de tokens + fonts_url), music (pistes CC0 avec bpm, phase, tags, level), motion (ease, spring {f,d} ou bezier), pacing, camera, transition, sfx (chaque son du film) et voice (voix Fish : dir, durs, texts pour d'autres langues, intro, sample). La décision voice globale choisit le narrateur ; une voix résout chaque ligne en <dir><scene>-<A|B|C>.mp3, et une voix avec needs et sans dir est lue sous forme de sous-titres jusqu'à ce qu'elle soit enregistrée. Les options ajoutées vivent dans la base de données de la page, sont annulables et vont dans le cahier des charges approuvé. Construisez les bibliothèques avec examples/crumb-previs/libraries.py comme modèle :

  • Musique : recherchez Freesound CC0 (freesound.py search ... --min-dur 20), freesound.py get, puis python3 _shared/previs/music_lib.py <page>/audio/music/lib <oggs> (extraits de 24 s alignés sur le rythme, BPM mesuré) ; écrivez les tags et un pourquoi par piste ; lignes dans _shared/ASSETS.md.
  • Voix : choisissez des voix Fish publiques avec search_voices (pas de clones de personnes réelles ou de personnages), listez-les dans voices/voices.tsv, écrivez voices/lines-<lang>.txt, exécutez voices/make_voices.sh (modèle gratuit), puis vérifiez les prises avec whisper-cli et régénérez celles qui perdent des mots.
  • Le réalisateur IA (onglet Demander, lib/director.ts) peut également concevoir des looks (contraste vérifié, polices Google autorisées), des sensations de mouvement et de nouvelles formulations de lignes (celles-ci nécessitent un enregistrement : il dépose une note de demande pour Claude Code).

Le côté de Claude Code dans les notes (faites ceci à chaque tour)

Le propriétaire envoie des notes depuis la page (« Envoyer à Claude Code » : un commentaire en direct qui réveille une session en observation, ou un message copié). Ensuite : 0. Tirez avant de modifier. Claude sur claude.ai peut répondre à un fil « Envoyer à Claude Code » par lui-même, modifier le fichier de données et publier une nouvelle version. Avant de construire, lisez le previs.json publié, comparez-le avec votre construction locale et reportez toute modification dans build_previs.py afin que la prochaine construction la conserve.

  1. Définissez films/<id>/state/claude {state:"reading"|"working"|"publishing"|"idle", at, message, version, open} pour que la page montre ce que vous faites.
  2. Pour chaque note ouverte : mettez-la à jour avec claude: {state:"seen"} une fois lue, {state:"working"} pendant la modification, puis status:"done", claude:{state:"done", at, msg} et ajoutez {by:"claude", text, at} à replies (épinglez if_version). Utilisez state:"question" (avec la question dans msg) lorsque vous avez besoin du propriétaire, "wontfix" lorsque vous recommandez de conserver. Les notes avec kind:"request" sont des tâches de l'onglet Demander (enregistrer une nouvelle ligne, trouver un son) ; prefer pointe vers l'option que le propriétaire aime ; intent:"question" veut une réponse, pas une modification. Chaque at est l'heure réelle : prenez-la de date -u +%Y-%m-%dT%H:%M:%SZ, jamais une estimation.
  3. Ajoutez des lignes à films/<id>/activity ({at, by:"claude", kind:"seen"|"applied"|"published"|"question", text, version}) : ce que vous avez lu, ce que vous avez modifié, ce que vous avez publié.
  4. Répondez dans le fil de commentaires de la page si le propriétaire a utilisé Envoyer à Claude Code, puis résolvez-le.

Règles

  • Un seul réalisateur, pas de comité. Travaillez vous-même à travers la liste de contrôle spécialisée ci-dessous, dans l'ordre. Pas de workflows ou de sous-agents sauf si le propriétaire le demande (règle de coût).
  • Inférez agressivement ; ne demandez que les vrais bloqueurs (vérité produit, un asset manquant, une question de licence). Jamais un long questionnaire avant que le propriétaire voie quelque chose.
  • Trois options pour chaque décision, par défaut. Direction, musique, sensation de mouvement, rythme, et par scène : transition, caméra, ligne de voix, chaque événement SFX. Les options doivent être réellement différentes. Marquez le choix du réalisateur et donnez à chaque option une phrase simple de raison ou de compromis. « Rien » est une option SFX valide.
  • Vérité produit. Chaque scène est étiquetée real_ui, conceptual_ui, conceptual_visual ou external_footage ; tout ce qui n'est pas réel affiche une étiquette dans le lecteur.
  • Les règles de la maison s'appliquent toujours (AGENTS.md, OWNER.md) : clichés interdits, mentions légales, deux niveaux de texte, bruitages enregistrés, voix par défaut, licences. La page ne joue que de l'audio CC0 ou auto-produit ; Mixkit (rendu uniquement) apparaît uniquement par son nom.
  • Réduisez l'échelle. Un extrait de 6 s peut être une carte de direction, 3 options musicales et une animatique de 6 s. Un film produit de 40 s reçoit l'ensemble complet.
  • Verrous. Une fois que le propriétaire approuve, l'histoire, le texte, l'ordre, le timing et les choix sont verrouillés. Une note ultérieure ne modifie que sa cible ; listez ce que vous avez préservé.

Liste de contrôle spécialisée (le réalisateur couvre chaque point, brièvement)

Histoire (accroche avant 2 s, un état par temps fort) · scénario et lignes de voix (mots par seconde ≤ 3.4) · rythme éditorial (varier la durée des plans, pauses, pas toutes les coupes sur le rythme) · direction artistique (3 directions sous forme d'ensembles de tokens : bg, on-bg, card, on-card, muted, line, paper, on-paper, accent, on-accent, frame, display, ui, mono) · typographie · références (emprunter / éviter / où utilisé ; grammaire, jamais contenu) · caméra (chaque mouvement a une raison) · mouvement (but, easing, dépassement ≤ 4% sur l'UI, aucun sur le texte) · transitions (un simple cut est valide) · assets (existants / nouveaux / générés / placeholders, avec licence) · musique (BPM et phase mesurés, courbe d'énergie, où le drop tombe) · SFX (asset, temps, déclencheur, gain, pourquoi) · mix (voix en avant, duck de 8 dB, impact le plus fort) · moteur (choisi, pourquoi, alternative, repli) · QA.

Fichiers (un dossier par film)

projets/NNN-nom/previs/
  build_previs.py          # écrit page/previs.json ; copiez examples/crumb-previs/build_previs.py et modifiez (scènes = styleframe HTML + animations tweens)
  vo-lignes.txt             # 3 formulations par ligne, pour fish_tts.py
  page/index.html          # construit par _shared/previs/app (npm run build ; ajoutez cette page comme cible dans scripts/inline.mjs)
  page/films.json          # [{"id": "NNN-nom", "name": "Produit", "path": ""}]
  page/previs.json         # l'ensemble du plan
  page/audio/{musique,vo,sfx}/
  changements.jsonl        # journal des modifications append-only, une opération par ligne
  approved-video-spec.json # écrit par _shared/previs/freeze_spec.py après approbation

Étapes

  1. Lisez le brief ou la demande en une ligne et la source du produit (UI réelle, tokens, texte). Écrivez BRIEF.md avec les décisions inférées.
  2. Audio (pas cher, local) :
    • Pistes de fond : mesurez le tempo et la phase par combinaison sur 85–150 BPM sur une enveloppe de débuts basse fréquence (AGENTS-tooling.md, « Previs ») ; coupez des extraits de 24 s commençant sur un temps, normalisez à −18 LUFS : ffmpeg -ss <phase> -t 24 -i piste.wav -af "loudnorm=I=-18:TP=-2,afade=t=out:st=22.5:d=1.5" page/audio/musique/A.mp3.
    • Voix : python3 _shared/tools/fish_tts.py --lines previs/vo-lignes.txt --out-dir previs/vo-wav (modèle gratuit), puis supprimez le silence dans page/audio/vo/sN-{A,B,C}.mp3.
    • Bruitages : copiez les aperçus CC0 depuis _guide/prompt-studio/media/foley/ ou récupérez-les avec freesound.py.
  3. Planifiez dans build_previs.py (voir l'exemple pour chaque champ) : project, summary, chief, story (temps forts → scènes), directors, assets, gates, pipeline, changes, directions (3), global.music|motion|pacing|voice (3 chacun), engine, references, style_rules, audio_notes, qa, versions, film_css (toutes les couleurs via des tokens, classes préfixées f-), fonts_url, et scenes[] avec html, anim (tweens {s, t:[a,b], f, to, e} sur x, y, s, sx, sy, r, o, clip, w, blur ; {s, set, at, until} bascules de classe ; {s, count:[from,to], t, p, d} compteurs ; e:'m' suit le choix Motion), decisions (types de transition cut, push, slide, zoom, iris ; caméra {s,x,y,origin} ; vo {text, src, dur, at, copy}), sfx (at peut être une liste pour des séquences), key (le moment de l'image fixe du storyboard). Donnez à chaque élément que le propriétaire pourrait pointer un simple data-name (« Total reçu », « Bouton de demande »).
  4. Vérifiez localement : servez le dossier de la page, regardez une image fixe de chaque scène et une mi-transition, basculez les trois directions une fois, confirmez qu'il n'y a pas d'erreurs dans la console. Un passage, pas de boucle.
  5. Partagez la page (localement, ou en tant qu'Artifact claude.ai avec les capacités ci-dessus) et ajoutez le film à Previs Studio. Donnez au propriétaire le lien et un résumé de cinq lignes. Arrêtez-vous pour révision.
  6. Boucle de révision (chaque tour est une republication) :
    • Lisez les notes, les choix et l'approbation.
    • Pour chaque note ouverte : ne modifiez que sa cible, ajoutez une opération à changements.jsonl ({"v","cible","t","modification","de","vers","raison","préserver":[...]}), puis marquez la note comme terminée avec une réponse d'une ligne (protocole ci-dessus). Une note revert demande d'annuler une modification listée.
    • Incrémentez versions et ajoutez les changes du tour dans build_previs.py, réexécutez-le, copiez previs.json dans la copie de Studio, republiez. Le lecteur affiche une bannière « ce qui a changé » et le Plan liste chaque modification avec une demande d'annulation.
  7. Approbation : lorsque state/approval a approved: true (il contient picks, tweaks et custom), sauvegardez-le, exécutez python3 _shared/previs/freeze_spec.py projects/NNN-nom/previs --approval <fichier> (il résout les options ajoutées et la voix, et liste needs_before_build comme les lignes non enregistrées), écrivez SHOTLIST.md à partir du cahier des charges, puis passez à la compétence moteur nommée dans le cahier des charges. Le moteur construit exactement le cahier des charges (polissage autorisé, décisions non).

Coût

Travail en solo uniquement. Une prévisualisation de 20 s représente quelques heures d'une seule session (environ 30 à 60 $ équivalent API), avec Fish sur le modèle gratuit et aucun rendu. Le rendu de production et ses vérifications viennent après approbation.

Individual skills in this repo

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

Skills associés