Motion Studio

Que fait Motion Studio ?

Vous êtes le motion designer, le monteur et l'ingénieur du son. Vous écrivez un storyboard.json ; les scripts de ce dossier le rendent image par image dans Chromium headless, ajoutent la voix, des sous-titres, la conception sonore et la musique, et produisent un MP4 final. Pas d'After Effects, pas de timeline.

Tous les chemins ci-dessous sont relatifs à ce dossier de compétence (SKILL_DIR). Exécutez les scripts avec python3 SKILL_DIR/scripts/....

Workflow

1. Brief (ne demandez que ce que vous ne pouvez pas déduire)

Déterminez : objectif et public, plateforme/format (9:16 TikTok/Reels/Shorts - par défaut, 16:9 YouTube, 1:1, 4:5), durée (par défaut 20-40 s), langue, appel à l'action, couleurs de marque. Si l'utilisateur en a donné assez, ne demandez pas - énoncez vos hypothèses en une ligne et continuez.

2. Script

• Accroche dans les 2 premières secondes : une affirmation audacieuse, une question ou un chiffre.
• Une idée par scène, 4 à 8 scènes. ~2,5 mots parlés par seconde.
• Phrases parlées courtes. Écrivez les nombres comme ils doivent être lus à haute voix.
• Terminez par une action claire (CTA).

3. Storyboard

Créez un dossier de projet (ex. ./videos/<slug>/) avec storyboard.json. Consultez references/storyboard.md pour chaque champ, type de scène et accessoire. Partez de templates/storyboard.vertical.json ou templates/storyboard.horizontal.json.

Règles générales (voir references/motion-design.md pour plus de détails) :

• Le texte à l'écran est un titre, pas la narration. 2 à 6 mots par scène.
• Encadrez le mot clé avec des astérisques pour le mettre en évidence dans la couleur d'accent.
• Variez les types de scènes et les transitions ; évitez la même transition 3 fois de suite.
• Placez les captures d'écran/logos de l'utilisateur dans <projet>/assets/ et utilisez des scènes image.
• Les durées des scènes suivent automatiquement la voix off ; définissez duration uniquement pour les scènes silencieuses.

4. Vérification de la configuration (première fois)

python3 SKILL_DIR/scripts/doctor.py - corrigez tout ce qui est marqué ✗. Il n'installe rien lui-même ; build.py exécute npm install lors de la première utilisation. Pour des voix naturelles gratuites : pip install edge-tts.

5. Prévisualisation des images fixes et examen

python3 SKILL_DIR/scripts/build.py <projet> --stills Puis ouvrez <projet>/build/contact_sheet.png (et les images individuelles dans build/stills/) avec votre visionneuse d'images/outil de lecture et vérifiez : le texte tient et est lisible, rien ne se cache derrière les sous-titres, la hiérarchie est claire, les couleurs ont du contraste. Corrigez le storyboard et répétez. Ne sautez jamais cette étape - elle est bien plus rapide qu'un rendu complet.

6. Rendu

python3 SKILL_DIR/scripts/build.py <projet> → <projet>/out/<titre>.mp4 (--preview rend à moitié résolution pour une vérification rapide du mouvement, --workers N définit le nombre de pages de navigateur parallèles, --voice edge|elevenlabs|piper|say|espeak|silent force un fournisseur.)

7. Vérification et livraison

• Utilisez ffprobe sur le MP4 : durée, résolution, présence d'un flux audio.
• Extrayez 2-3 images (ffmpeg -ss 5 -i out.mp4 -frames:v 1 f.png) et examinez-les.
• Indiquez à l'utilisateur où se trouve le fichier, quel fournisseur de voix a été utilisé, et que build/captions.srt existe pour les plateformes qui acceptent les fichiers de sous-titres.
• Si la voix est tombée en mode de repli espeak ou silent, dites-le et expliquez comment obtenir de meilleures voix.

Scènes personnalisées

Lorsque les types intégrés ne suffisent pas, écrivez un module de scène dans le projet (<projet>/scenes/ma-scene.js) et utilisez `