Que fait oleg-motion ?
Motion design déterministe à partir d’images fixes : une scène HTML rendue image par image dans Chrome headless, encodée avec ffmpeg. Tout est une fonction pure du temps, donc les boucles se ferment exactement et les rendus sont reproductibles. Parlez à l’utilisateur dans sa langue ; conservez les noms de fichiers et le JSON de la scène en anglais.
$OM ci-dessous désigne le répertoire de cette compétence (le dossier contenant ce SKILL.md).
0. Assurez-vous que ça fonctionne (une fois par machine)
Exécutez tout via le lanceur $OM/om — il place en premier dans le PATH le Node, ffmpeg et Python
propres à la compétence, ce qui fonctionne sur un Mac propre sans outils de développement.
$OM/om doctor # ce qui est installé
bash $OM/scripts/setup.sh # cœur : Node.js, ffmpeg, moteur de rendu (télécharge ce qui manque)
$OM/om setup --psd # + import PSD
$OM/om setup --ml # + calques automatiques pour images plates (~1 Go incl. modèles)
$OM/om update # dernière version depuis GitHub (fonctionne sans git), puis configuration
L’installation ne nécessite ni mot de passe admin, ni Homebrew, ni git : les outils manquants sont
téléchargés dans ~/.cache/oleg-motion/tools (remplacez le dossier avec OLEG_MOTION_HOME) ; les outils
déjà présents sur la machine sont utilisés s’ils sont suffisants. Le cœur seul peut déjà animer n’importe
quelle image (caméra, particules, lumière, superpositions). Demandez avant d’exécuter --ml — il
télécharge des modèles. Si om n’est pas exécutable (décompressé depuis un zip), appelez bash $OM/om ….
1. Brief — regardez d’abord, puis demandez avec des options cliquables
Les gens déposent un fichier et disent « faites bouger ça ». La plupart ne peuvent pas décrire le mouvement en mots, donc ne posez pas de questions ouvertes — regardez d’abord l’image vous-même (ouvrez-la), listez ses éléments (titre, prix, bouton, logo, photos, produit, flèches…), puis demandez.
Kit de marque d’abord. Si la demande mentionne une marque/projet, ou qu’un *.brand.json /
oleg-motion.brand.json se trouve dans le dossier de travail, ou que $OM/brands/ contient un kit
correspondant, chargez-le et passez --brand à la scene : ses valeurs par défaut répondent à la
plupart des questions (ignorez celles-ci) et ses protect / avoid / notes sont des règles
strictes. Format : references/brand-kit.md. Pas encore de kit → proposez d’en sauvegarder un lors de la
livraison (étape 6).
Ne demandez jamais sur le savoir-faire — les durées, l’easing, les amplitudes, les décalages, les nombres de particules sont des valeurs par défaut professionnelles (references/motion-guidelines.md). Modifiez-les seulement quand la personne le demande. Chaque question offre une valeur par défaut qu’ils peuvent simplement accepter.
Sautez les questions quand l’utilisateur dit « просто зроби » / « just do it » / « à votre guise », ou que les réponses sont déjà dans la demande : choisissez les valeurs par défaut et indiquez-les en une ligne.
Sinon, demandez une fois, avec des options — utilisez l’outil AskUserQuestion quand disponible
(cartes cliquables ; sinon un message avec des options numérotées). Jusqu’à 4 questions, chacune avec
votre option recommandée en premier, construite à partir de ce que vous avez vu dans l’image :
- Où sera-t-elle diffusée ? → profil : « як є — ne pas modifier les proportions » (
source: le rapport hauteur/largeur d’origine, grand côté limité à 1920 px), publication Instagram 4:5 (feed-portrait), Stories/Reels 9:16 (story), bannière de site web (web-hero/web-strip), affichage publicitaire GIF (display-*). Adaptez les 4 options à l’image : si son rapport correspond déjà à un format (ex. 4:5 → publication Instagram), proposez ce format au lieu d’un « як є » distinct (même résultat) et recommandez-le ; sinon recommandez d’abord « як є ». Un format avec un autre rapport recadre l’image (fit: cover) ou ajoute des marges floues (contain-blur) — dites-le, et ce qu’il coupe (bords du titre, CTA), pour que la personne ne soit pas surprise. - Personnage ? → 3–4 ambiances qui correspondent à l’image, décrites par la sensation, pas par le
nom : « calme & premium », « énergique », « festif », « presque immobile ». Mentionnez l’ambiance
correspondante dans la description (
premium,energetic,festive,calm… ; liste complète :$OM/om moods). - Structure ? → « les éléments apparaissent, puis bouclent » (
intro-loop, bon pour les posts sociaux), « boucle uniquement » (loop, bon pour les bannières de site), « un seul passage avec une fin » (oneshot). - Quel est le héros ? (multiSelect) → les 3–4 éléments les plus importants que vous avez trouvés, par ex. « titre SUMMER SALE », « bouton CTA », « photos », « produit ». Le héros reçoit le mouvement principal ; tout le reste reste calme.
Valeurs par défaut si aucune réponse : profil à partir du rapport hauteur/largeur, 6 s (intro 2 s + boucle 4 s pour intro-loop), MP4, ambiance choisie dans la palette et le sujet. Une vidéo de référence (« comme ça ») prime sur toute réponse — décomposez-la avec references/reference-analysis.md et reproduisez son rythme, pas son contenu.
2. Plan de mouvement — accord sur les mots avant le rendu
Avant le premier rendu, montrez le plan en langage clair (langue de l’utilisateur), une ligne par élément, avec les durées — par ex. :
Intro (2 s) : le logo apparaît → le titre monte ligne par ligne → « -30 % » surgit → le bouton et le produit apparaissent par le bas. Boucle (4 s) : « -30 % » brille légèrement, un éclat le traverse · le bouton pulse · le produit flotte légèrement · poussière chaude en fond. Ne bouge pas : logo (seulement une étincelle), prix après apparition, dates.
Demandez « On fait comme ça, ou quelque chose à changer ? » dans le même message et ne procédez qu’après un oui (ou quand l’utilisateur a ignoré les questions — alors rendez directement et montrez le plan avec le résultat). Modifier le plan coûte des secondes ; modifier un rendu coûte des minutes. Le plan décide aussi quels éléments nécessitent leur propre calque à l’étape suivante.
3. Obtenez les calques
Choisissez selon l’entrée — l’objectif est un layers.json avec des rôles (voir references/scene-format.md) :
| entrée | commande |
|---|---|
| JPG/PNG plat, ML installé | $OM/om py $OM/scripts/ml/auto_layers.py in.jpg --out work/layers |
| PSD | $OM/om py $OM/scripts/psd_layers.py in.psd --out work/layers |
| dossier de calques PNG | $OM/om layers-from-dir path/to/pngs |
| création design (cartes, boutons, flèches, photos avec têtes dépassant du cadre) ou auto-layers erronés | écrivez regions.json (boîtes/polygones + mode masque) → $OM/om py $OM/scripts/ml/cut_regions.py regions.json --out work/layers (format dans le docstring du script) |
| image plate, sans ML | écrivez layers.json à la main : un calque background (et demandez des zones de texte si les particules doivent éviter le texte) |
Pour regions.json, trouvez les coordonnées en mesurant, pas à l’œil : seuillez les pixels clairs/sombres
et imprimez les boîtes englobantes des composants ; pour les cartes photo, scannez la couleur du cadre et
ajustez les bords (un polygone 3–5 px à l’intérieur du vrai bord laisse une ligne brillante dans
l’arrière-plan et découpe la carte). Utilisez mask: "contrast" pour le texte/logos/lignes sur fond
uni, "full" + popout pour les cartes photo avec une tête qui dépasse, "seg" pour les objets sur
photos chargées.
Ouvrez toujours preview.png / les PNG des calques et vérifiez la séparation avant de construire la
scène : les calques automatiques peuvent mal étiqueter (un logo détecté comme texte, un prix comme titre,
un sujet qui est en fait l’arrière-plan). Corrigez les rôles dans layers.json — les rôles décident ce qui
peut bouger. Si le détourage du sujet est mauvais, abandonnez ce calque plutôt que d’animer un bord
irrégulier.
4. Construisez la scène
$OM/om scene --layers work/layers/layers.json --mood energetic \
--profile feed-portrait --structure intro-loop [--brand brand.json] \
[--intensity 1] [--speed 1] [--density 1] --out work/scene.json
Cela ébauche scene.json à partir du bundle d’ambiance (et du kit de marque). Modifiez-le ensuite pour
correspondre au plan convenu — c’est là qu’est le savoir-faire : des durées d’intro par calque décalées
de 50 à 100 ms (cascade entière ≤ 2 s, entrées 400–800 ms, ease-out ; rebond seulement sur un élément
ludique), lumière/lueur du héros, mouvement décoratif (flèches rebondissent, badges tournent), particules
dans une couleur d’accent de l’image ou du kit de marque. Lisez references/effects.md pour chaque effet
et ses paramètres, et references/motion-guidelines.md pour les limites qui maintiennent le professionnalisme.
5. Rendu, regardez, itérez
$OM/om render work/scene.json --out work/out --quality draft # vérification rapide
$OM/om render work/scene.json --out work/out --formats mp4,webm,gif # final
Après chaque rendu, regardez *-sheet.jpg (8 images) et, en cas de doute, extrayez des images
individuelles (ffmpeg -ss 2.5 -i out.mp4 -frames:v 1 f.png) et visualisez-les. Le rapport
(*-report.json, résumé dans stderr) vérifie : la couture de boucle, les flashs (≤3/s), les calques
verrouillés ne bougeant pas, les zones de sécurité (texte/prix/CTA ≥ 10 % des bords, logos ≥ 5 % ;
cut = un changement de format a recadré, as-designed = la source était déjà aussi serrée), le budget
de fichier.
Corrigez les échecs avant de livrer — une couture visible signifie généralement des cycles non
entiers ; un échec de budget signifie moins de particules/grain, ou une taille/fps GIF inférieure.
Montrez à l’utilisateur la version de travail (la planche contact ou le MP4) et invitez les ajustements dans ses propres mots — « plus lent », « moins de brillance », « sans particules », « bouton plus lumineux », « enlève l’intro ». references/tweaks.md fait correspondre ces phrases à des modifications de scène ; appliquez-les, re-rendez en version de travail, et ne rendez la version finale que lorsqu’il est satisfait.
Coût sur un laptop (M1, 8 Go) : calques automatiques ≈ 3–4 min par image (exécutez-le une fois, puis itérez sur la scène) ; rendu ≈ 0,2–0,4 s par image (6 s à 30 ips ≈ 1 min). Prévenez l’utilisateur avant les longues étapes.
6. Livrez
Donnez à l’utilisateur : les fichiers (chemins + tailles), l’affiche JPG, une phrase sur ce qui bouge,
et pour les sites web l’indice d’intégration <video autoplay muted loop playsinline poster="…">. Si la
plateforme cible a des limites strictes (taille exacte, codec, Mo max), dites qu’elles ont été
respectées — ou non. S’il s’agissait d’un travail de marque et qu’aucun kit n’existe encore, proposez en
une ligne d’en sauvegarder un (references/brand-kit.md) afin que la prochaine fois les questions soient
déjà répondues.
Règles pour garder la qualité (et pourquoi)
- Un mouvement héros, ≤ deux mouvements ambiants. Les spectateurs lisent une chose à la fois ; un mouvement supplémentaire entre en concurrence avec le message.
- Les prix, textes légaux et logos restent rigides. Le mouvement brouille et fait trembler les
lettres — la lisibilité et la confiance en la marque priment sur l’effet. Les rôles l’imposent ; ne
réassignez pas un prix à
textpour lui donner du mouvement. - Ne simulez pas le mouvement d’une personne. Une personne détourée ne peut pas courir ou agiter la main ; faire osciller ou pulser la figure entière ressemble à une marionnette en carton. Donnez de la profondeur aux personnes (parallaxe de caméra) et une introduction, rien de plus.
- Petites amplitudes. 3–6 % de poussée de caméra, 2–4° d’inclinaison, ≤ 2 % de respiration. Les grands zooms et la parallaxe provoquent le mal des transports et semblent amateurs.
- Cycles entiers uniquement. La boucle est parfaite parce que chaque mouvement effectue un nombre
entier de cycles par boucle — ne définissez jamais de
cyclesfractionnaires. - Première image = affiche finie. En mode
loop, la première image a déjà tout en place ; utilisezintro-loopquand des entrées sont souhaitées. - Pas de redessin génératif du texte. Cette compétence ne repeint jamais le texte ou les produits ; la vidéo IA (optionnelle, voir references/ai-video.md) est uniquement pour les arrière-plans, avec les calques d’origine recomposés par-dessus.
Dépannage
Playwright is not installed,Node.js is missing, erreursffmpeg→bash $OM/scripts/setup.sh.- Images vides ou noires → un chemin de calque est erroné (vérifiez les avertissements stderr) ou la scène n’a pas de calque d’arrière-plan.
- Détection de texte ignorée →
ocrmacest uniquement macOS ; ailleurs, passez les calques de texte manuellement. - Halos de bordure en parallaxe → réduisez
depthParallax.amp, ou repeignez le panneau (les calques automatiques le font sauf si--no-inpaint). - GIF trop volumineux → les profils
display-*le réduisent automatiquement ; sinon, abaissez ips/largeur.