Communitygithub.com

motion-reel

Montre à un agent comment planifier, construire ou éditer un « motion reel » afin que le résultat concret soit une vidéo terminée. La procédure couvre le Motion Reel (Demon Clips Studio), ce que l'utilisateur attend à chaque fois (ne pas lui faire demander deux fois), et le workflow. À utiliser lorsqu'une nouvelle mission fait appel à ce savoir-faire.

Qu'est-ce que motion-reel ?

Cette compétence définit un workflow complet pour la création de vidéos motion reel entièrement générées par code, à l'aide de la bibliothèque Remotion pour la vidéo, de scripts Python pour le son et de Edge TTS pour la voix off. Elle permet à un agent IA de produire des vidéos prêtes à poster, avec un aspect visuel cohérent (Paper Glass Lab), un doublage en hindi, des sous-titres en roman et devanagari, et une bande sonore maîtrisée. Le processus couvre toutes les étapes, de l'idée et du storyboard (jusqu'à 8 beats) à la composition dans Remotion, la création des fichiers de copie structurée en YAML, la génération du son et de la voix, le rendu vidéo avec l'ajout d'outros, la vérification de la conformité (format, loudness, durée, images clés) et la livraison des fichiers finaux. La compétence insiste sur la livraison complète du premier coup, sans demandes répétées, et intègre un vocabulaire de mouvements prêts à l'emploi (pendule, bond, glissade, etc.) et des règles de conception strictes (pas de jaune, pas d'emoji, pas de faux numéros).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wearethedemon/motion-reel-skill/tree/HEAD

Demander à votre IA préférée

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

Documentation

Motion reel (Demon Clips Studio)

Chaque pixel et chaque son de ces reels est créé via du code : Remotion pour l'image, pipeline/synth.py pour le son, Edge TTS ou l'enregistrement personnel de l'utilisateur pour la voix. La référence de construction est « Made in code » : remotion/src/promo/MadeInCode.tsx, pipeline/promo.py, reels/261120-made-in-code/. Lisez-les avant d'écrire un nouveau reel. Reproduisez leurs motifs, pas leur contenu.

Travaillez dans D:\Claude-Chrome\wearethedemon\studio et suivez studio/CLAUDE.md (environnement, chemin de rendu, disque A: pour les fichiers temporaires, demandez avant tout téléchargement, ne commitez que sur demande, pas de mention Claude).

Ce que l'utilisateur attend à chaque fois (ne pas lui faire demander deux fois)

L'utilisateur est direct et s'énerve quand quelque chose doit être demandé deux fois. Livrez tout du premier coup :

  • Voix off. Narration en hindi, chronométrée ligne par ligne sur les temps. Utilisez la voix IA (Edge TTS hi-IN-MadhurNeural) sauf s'il a enregistré la sienne dans l'enregistreur de voix off. Un reel avec seulement de la musique est revenu avec « pas de voix off ? ».
  • L'outro ajoutée. Les fichiers publiable sont -ig.mp4 (Suivre) et -yt.mp4 (S'abonner), avec les effets sonores propres à l'outro et une seule bande sonore masterisée sur l'ensemble du reel et de l'outro.
  • Les deux scripts. Roman Hinglish et Devanagari, donc 4 fichiers : {roman,deva}-{ig,yt}.
  • Mouvement vif mais fluide. Les éléments pop, gigotent, palpitent et dépassent. Rien de saccadé ou de précipité : laissez du temps aux grands mouvements (un passage de pendule dure 1,5 s ; 1 s était « trop rapide et pas fluide »), et ajoutez un flou de mouvement à tout ce qui est rapide.
  • Style maison : Paper Glass Lab. Grille pâle, verre blanc, rouge de chaîne #E5162D / #B80F22, encre et blanc. Les interludes nuit (#0E0E12 plus une lueur rouge) sont autorisés pour le rythme, mais l'utilisateur ne les a pas formellement approuvés, donc gardez-les optionnels. Pas de jaune, pas d'emoji dans la vidéo, pas de faux numéros, pas de badges vérifiés.
  • Affirmations honnêtes. Si le reel dit « chaque son est codé », c'est le cas. Le code à l'écran est la véritable source de ce reel, et un test le vérifie.
  • Construisez ce qui a été demandé. S'ils demandent X, ne proposez pas une version allégée et ne reposez pas la question.

Workflow

1. Format et idée

S'il y a un reel de référence, n'en retenez que le format : la structure, le rythme et les types de mouvements. Jamais son script, ses légendes ou ses designs. Écrivez 5 à 8 beats, une ligne chacun : ce qui bouge, quel texte apparaît, quel son joue. Vérifiez tout fait avant qu'il n'entre dans la copie. Utilisez une carte « Commenter KEYWORD » seulement avec un vrai livrable dans reward.md. Ébauchez ce fichier et marquez-le comme nécessitant l'approbation de l'utilisateur ; il envoie les DM manuellement.

2. Dossier et copie

Créez reels/<YYMMDD>-<slug>/ avec :

  • copy.yaml :
    • handle, keyword, brand.
    • Un bloc roman: et un bloc deva: pour le texte à l'écran.
    • Un bloc voice: : id, rate, lines: [{at, text, roman}]. text est en Devanagari pour le TTS, avec les mots anglais orthographiés comme les dirait une voix hi-IN (कोड, क्लॉड, एडिटर, डी एम). roman est ce que l'utilisateur lit dans l'enregistreur.
  • reward.md : ÉBAUCHE jusqu'à ce que l'utilisateur l'approuve.
  • notes.md :
    • la commande de construction et les fichiers à poster ;
    • une checklist avant publication et une suggestion de cadre de couverture ;
    • le texte de publication : une légende IG avec au maximum 5 hashtags, un titre YT de 100 caractères maximum, et une description avec 3 à 5 hashtags.

3. Feuille de beats d'abord

Placez les temps des beats dans un seul fichier JSON, remotion/src/promo/<slug>.beats.json, en secondes.

  • Partagé : la composition et le mixage Python le lisent tous les deux, ce qui maintient chaque son sur son image.
  • Noms : nommez les beats d'après ce qui se passe (cut, wall, land[], reveal, stretch, toCard, keyword, brand, fadeOut).
  • Fin : les 0,4 dernières secondes restent calmes et silencieuses, pour que la boucle vers l'image 0 soit propre.
  • Durée : 25-30 s de reel, plus l'outro de 3,5 s.

4. Composition

Écrivez remotion/src/promo/<Name>.tsx et enregistrez-le dans Root.tsx, avec calculateMetadata prenant la longueur à partir des beats.

  • Schéma : un schéma zod pour chaque élément de la copie (script: "roman" | "deva", lignes, carte, marque, audio, fps). La copie romane est la valeur par défaut.
  • Temps : en secondes, via ../motion (seconds, springAt, ramp, wiggle, pulse, loop, stagger) et les ressorts dans brand/tokens.ts (SPRING.ui 18/160/0.8, SPRING.stamp 11/220/0.7). Jamais de nombres d'images, donc n'importe quel fps fonctionne.
  • Kit : Backdrop, NightBackdrop, FitLine (adapte une ligne à une largeur), Card, Chip, Stamp, Rich, Phone, CaptionBar, SafeOverlay.
  • Texte :
    • Gardez-le dans la zone de sécurité : x 60-950, y 250-1560. Rien de destiné à être lu ne doit être en dessous de 34 px.
    • Les légendes romanes sont en MAJUSCULES Rajdhani ; les deuxièmes lignes sont en Poppins 600 italique rouge.
    • Le Devanagari n'est pas en majuscules. Il nécessite des tailles maximales plus grandes (environ 148/120 contre 150/128 pour le roman, la pilule 72 contre 64), lineHeight ≥ 1.25 et lang="hi".
  • Variété : mélangez 4 à 6 mouvements du vocabulaire ci-dessous, dans un ordre différent à chaque reel. YouTube traite les modèles répétés comme du contenu non authentique.

5. Son et voix

Voir « Son » ci-dessous. La musique et les effets sonores vont sur un Bus aux temps des beats. La musique est atténuée de −9 dB et les effets de −5 dB sous la voix. Vient ensuite le limiteur, puis loudnorm à −14 LUFS. Chaque ligne de voix se termine avant que la suivante ne commence.

6. Module de pipeline

pipeline/promo.py est câblé au seul reel Made-in-code (SLUG, COMPOSITION, BEATS_JSON, sa music/sfx).

La première fois que vous construisez un deuxième reel, généralisez-le au lieu de copier le fichier :

  • Déplacez les parties partagées (load_copy, voiceover, soundtrack, _master, render, filmstrip, final) dans un module qui prend une configuration de reel : slug, identifiant de composition, chemin des beats, et les music(b) et sfx(b) de ce reel.
  • Gardez promo.py comme une configuration légère pour Made in code, et donnez à l'interface en ligne de commande un --reel <slug>.
  • Faites de même pour l'enregistreur : pipeline/recorder.py Project prend le slug, et pipeline record --reel <slug> fonctionne, de sorte que l'application Voice-over Recorder peut faire la voix off de n'importe quel reel.

Gardez les tests passants, et dites dans votre rapport que vous avez fait ce changement.

7. Vérification du filmstrip avant le rendu complet

Rendez les images clés des beats (6 par ligne, --filmstrip) dans A:\claude-workspace\screenshots\demon-studio\<slug>\ et examinez-les vous-même. Vérifiez :

  • que le texte est lisible et dans la zone de sécurité, et que le Devanagari n'est pas trop petit ;
  • les moments vides (une carte vide pendant 0,6 s a l'air cassée, donc commencez son texte dans les 0,4 s environ) ;
  • que les dernières longues lignes ne touchent pas les bords, et que les effets superposés s'alignent.

Corrigez, re-rendez les images fixes, puis rendez la vidéo.

8. Rendu, outro, fichiers finaux

Construisez le mixage, puis rendez chaque script. final() ensuite :

  • ajoute l'outro de la plateforme : O.render_outro(platform, script, keyword=..., reward=...), avec sa troisième puce « Commenter KEYWORD : reward » ;
  • assemble les deux vidéos et masterise une seule bande sonore sur l'ensemble ;
  • encode en H.264 CRF 18, BT.709 limited range, AAC 320k 48 kHz, +faststart.

9. Vérifiez, puis rapportez

  • Format (ffprobe) : 1080×1920, 30 fps, yuv420p, BT.709, AAC 48 kHz stéréo, longueur = reel + outro.
  • Loudness : −14 ±1 LUFS et pic vrai ≤ −1 dBTP sur chaque fichier final.
  • Audio présent : vérifiez RMS par seconde avec ffmpeg.
  • Images de l'outro : titre, carte, tapez, Suivi/Abonné, puce de mot-clé.
  • Tests : uv run python -m pytest -q réussit. Ajoutez des tests pour le nouveau reel :
    • le code à l'écran est réel ;
    • les beats sont dans l'ordre ;
    • les propriétés sont valides pour les deux scripts ;
    • chaque ligne de voix se termine 0,05 s avant la suivante ;
    • la bande sonore dure toute la longueur avec un silence sur les 0,4 dernières secondes ;
    • le mot-clé a une récompense.

Rapportez en termes simples :

  • les 4 fichiers à poster, sous forme de liens ;
  • le reel beat par beat, sous forme d'une courte liste ;
  • ce que vous avez vérifié, et ce que vous n'avez pas pu (vous ne pouvez pas écouter, donc ils doivent le lire) ;
  • les décisions en suspens : approbation de la récompense, cadre de couverture.

Rappelez-leur que l'aperçu VS Code peut lire ces fichiers silencieusement (« pourquoi il n'y a pas de son ? »). VLC, Windows Media Player ou Chrome les lisent correctement.

Vocabulaire de mouvement (code dans MadeInCode.tsx)

Un objet héros conduit le reel (la boule rouge). Tout le reste réagit à l'endroit où il se trouve, ce qui donne cause et effet : la boule passe, le texte apparaît.

Chemins

  • Pendule. ballAt : x = 540 − SWING·cos(t·TURN), y sur le cercle de la corde (stringY), avec TURN = π / pass et un passage de 1,5 s. PendulumString a une ombre douce et s'accroche au pivot après le cut.
  • Bond. hop(a, b, u, h) est une ligne droite moins 4·h·u·(1−u) : une vraie parabole avec une hauteur d'apex h. Enchaînez les bonds le long d'un escalier de points d'atterrissage. Facilitez le repos final avec Easing.out(Easing.back(1.5)).
  • Vol dans un mur. Ease-in quad, plus un petit arc sin(u·π).
  • Glissade. lensAt : Catmull-Rom à travers les images clés, en facilitant l'entrée sur le premier segment et la sortie sur le dernier.
  • Traînée de flou de mouvement. Trail : échantillonnez les 0,09 dernières secondes du chemin et dessinez ceil(length / 5 px) cercles (48 au maximum) sous un SVG feGaussianBlur, en rétrécissant et en s'estompant vers la queue (0.16·(1−k)^1.4). Les copies se chevauchent, donc cela se lit comme une seule comète, jamais comme des perles.

Texte

  • Wipe qui suit l'objet. SceneSwing/SwingText : chaque légende est un calque plein écran découpé avec clip-path : inset() à la position x de la boule. La nouvelle légende apparaît derrière la boule, l'ancienne devant elle, et la direction alterne à chaque passage.
  • Tampon à l'atterrissage. StackLine : la ligne apparaît avec springAt(c, at, SPRING.stamp) exactement sur le beat d'atterrissage.

Impacts et vie

  • Écrasement et étirement. squashAt : pendant 0,14 s après un atterrissage, sx += 0.3·sin et sy −= 0.26·sin, avec transform-origin : 50% 100%. Un impact contre un mur étire dans l'autre sens.
  • Ripple. Un anneau elliptique plat qui s'étend à partir du point de contact sur 0,45 s.
  • Burst. 14 étincelles et points, initialisés avec random() pour que les rendus se reproduisent exactement. Utilisez-le seulement sur le grand moment (le mot-clé).
  • Gigue et pulsation. wiggle(c, at, dur, hz, amp) secoue la rotation ; pulse(c, at, dur, amount) augmente l'échelle. Multipliez les pulsations ensemble, et ajoutez une pulsation douce toutes les secondes à la fin pour que la carte continue de respirer.
  • Shine. Une barre de dégradé blanc inclinée traverse la pilule une fois.

Scènes

  • Jour à nuit. La boule fait glisser un panneau NightBackdrop à travers le papier. Son bord d'attaque est une ligne inclinée (panelEdge/edgeX, inclinaison facile 0 → 14° → −6°) utilisée pour découper le calque de nuit en polygone.
  • Retour au papier. Coupez à nouveau sur un beat fort.
  • Zoom avant. 3-6 % par scène c'est bien, mais jamais dans une scène avec une loupe.

Mise au point et révélation

  • Boule à loupe. lensRadius/Lens : la boule se gonfle en un anneau rouge (ressort), se remplit de verre, développe une poignée et glisse sur un calque de code gris pendant que le reste s'assombrit. Les mots de révélation apparaissent ensuite à l'intérieur du verre, et elle se referme en boule (Easing.in(Easing.back(1.4))).
  • Grossissement. À l'intérieur du verre, dessinez le même calque mis à l'échelle par ZOOM (2,1) avec transform-origin au centre de la lentille. Si le calque de base bouge (un zoom avant), la copie agrandie dérive hors d'alignement.
  • Code à l'écran. Il provient de code-lines.ts : lignes textuelles de la propre source de ce reel, maintenues synchronisées par un test, colorisées uniquement à l'intérieur de la lentille.

Morphose CTA

  • La forme. Morph construit un rectangle arrondi à partir de trois ressorts : largeur sW, hauteur sH (plus lâche, donc il oscille) et carte sC. w = 60 + 840·sW + 20·sC, h = hPill + 430·sC, et le rayon passe de pilule à 52.
  • La séquence. Boule → pilule avec le texte CTA glissant vers le haut → gigue et shine → carte. La carte contient MessageCircle + « comment karo », puis un mot-clé italique de 190 px tamponné de l'échelle 1,7 à 1 avec une burst, puis la ligne de publication.
  • La fin. Brand verrouillage (emblème, marque nominative Anton, tag mono), un fondu vers la nuit, et une dernière image fixe de 0,4 s. Un filigrane @handle reste en haut à gauche tout du long.

Son (pipeline/synth.py, pipeline/audio.py)

S.Bus(seconds) est une timeline stéréo :

  • add(clip, at, gain_db, pan) place un clip.
  • mix(other, db) additionne deux bus.
  • duck_under(key, depth_db) utilise une sidechain pour atténuer sous un autre bus.
  • fade_out(start, end) et peak().

Lisez à chaque fois le JSON des beats. La règle : chaque beat visuel a un son, et les mouvements rapides ont de l'air. Donnez à chaque whoosh sa propre seed, et panez les petits sons ±0.15-0.7.

VisuelSonGain dB
Passage rapide ou volwhoosh(dur, lo, hi, peak, seed), avec un pic là où ça bouge le plus vite, pané dans la direction−11 à −16
Extrêmes de passage, ticks UItick(freq, dur)−24
Cut, claquement de cordesnap() + riser(dur) dans le coup suivant−13 / −17
Gros impact (mur, mot-clé)impact()−9 / −10
Atterrissagethud(150, 50, 0.4) + pop(900+80·i, 300), qui monte à chaque atterrissage−8 / −13
Allumage, achèvementting(Hz) : 1318.5, 1568, 1760, 2093, 2637−13 à −15
Gonflement, étirement, morphoseboing(f0, f1, dur)−10 à −14
Révélation, étincelle, shineshimmer(base, gap)−13 à −22
Rétrécissement, fermeturezip_down()−14
Giguerattle()−13

Musique à 120 BPM, La mineur Am F C G, barres de 2 s (un passage de 1,5 s = 3 temps, donc mouvement et musique se verrouillent).

  • pad par barre, plus silencieux et plus sombre là où le spectateur lit ou regarde.
  • Un arpège pluck Karplus-Strong en croches, deux octaves plus haut.
  • kick sur les accents de mouvement et en four-on-the-floor dans la montée.
  • hat et sub uniquement dans les scènes de nuit.
  • Un pad final sous la marque nominative.

Voix

  • Voix IA : Edge TTS 7.3.1, hi-IN-MadhurNeural à +8 % (hi-IN-SwaraNeural est l'option féminine). Il est mis en cache dans build/voice/, et seul le texte du script est jamais envoyé.
  • Propre voix : voiceover(mode="auto") préfère la prise de l'enregistreur (audio/voice-take.json), puis audio/my-voice.* (une seule prise coupée aux pauses par pipeline/ownvoice.py), puis la voix IA. --voice ai|own force l'une ou l'autre.
  • Lignes : chaque ligne fait 2 à 6 mots et commence sur son beat. Mesurez chaque clip : il doit se terminer ≥ 0,05 s avant la ligne suivante, et la dernière avant fadeOut. Raccourcissez les mots si nécessaire. Filtre passe-haut à 80 Hz.

Skills associés