Que fait motion-spot ?
Crée des spots qui ont l'air d'être faits en studio, grâce à une méthode issue de l'analyse de 45 spots réalisés avec Claude qui ont cumulé des millions de vues (references/estudio.md). La recette qui revient dans tous :
Un concept avec tension (pas une liste de fonctionnalités) + l'interface ou le produit réel comme protagoniste + une typographie cinétique + une caméra qui n'est jamais immobile + chaque chose au moment précis où la voix la nomme + un pic dans la couleur de la marque + une fermeture nette avec le logo et le slogan.
Tout est code : chaque image est un état d'une page web. Une timeline GSAP en pause est parcourue image par image dans Chrome sans fenêtre, et ffmpeg assemble le MP4 avec flou de mouvement, lueur et grain. Le moteur est déjà prêt et testé dans plantilla/motor/, avec un spot d'exemple complet dans plantilla/escenas.js.
Si l'utilisateur donne une vidéo de référence (« fais la même chose »)
- Démonte la référence avant de concevoir : 8 à 12 images par seconde des sections clés en bonne taille (planche contact avec Read), en annotant chaque élément : quelle UI réelle apparaît, quelle police, quelle couleur, comment elle entre et sort (étirer, flouter, retourner).
- Copie la structure et les éléments réels, pas un « équivalent générique » : si l'original utilise des bulles iMessage, utilise
-apple-system(SF du système) et une bulle avec queue ; s'il utilise la carte de paroles de Spotify, recrée-la avec son étiquette, ses boutons et sa couleur ; s'il utilise un mot géant, c'est Arial Black (fourni sous macOS). - Typographie : jamais celle par défaut. L'utilisateur a rejeté plusieurs fois la typographie par défaut de Claude (sans noire serrée avec un tracking très négatif, Inter, serif italique). Utilise la police de la marque dans ses variantes STATIQUES réelles (par ex.
MonaSans-Black/Bold/Regular.ttfdeSocialMedia/fuentes/, les mêmes que dans les vidéos d'illustration) avec un tracking normal (-0,01 em au maximum), celle de la référence s'il y en a, ou demande/montre 3 essais avant de rendre. Jamais de polices variables à un poids intermédiaire avec un tracking serré. 3b. Interdiction par défaut du « look Claude » : Inter/Anton/serif italique/HUD mono n'apparaissent que si la référence ou la marque les utilise. Avec une référence, la typographie et les éléments sont les siens. - Demande des captures d'écran réelles de ce qui ne peut pas être recréé fidèlement (app, lecteur, couverture) : l'utilisateur les dépose dans
activos/. Spotify et d'autres apps peuvent être bloquées pour contrôle pour des raisons de politique : on ne contourne pas le blocage, on demande la capture ou on utilise une image publique et on prévient. - Montre une planche de photos de ta version à côté de celle de la référence et corrige les différences avant de livrer.
- Lis
references/referencia-fiel.md: processus complet, recettes pour chaque élément (bulles Apple Messages, carte de paroles Spotify, contrôles en SVG, ombrage qui glisse) et les erreurs qui ont déjà coûté des tours. Pièces prêtes dansmotor/ui.jsetmotor/ui.css; exemple complet dansejemplos/video-con-letra/.
Avant de commencer
Tu dois savoir, et si ce n'est pas clair, tu demandes en un seul message, avec des valeurs par défaut proposées :
- Ce qui est annoncé et pour qui (une ligne).
- Actifs réels : logo (SVG de préférence), captures d'écran de l'app ou du site, photos du produit, couleurs. Un site web peut aussi servir. Sans actifs réels, la marque semble générique : demande-les toujours. S'il n'y en a pas, conçois une identité d'exemple et dis-le.
- Format et durée : 9:16 et de 15 à 20 s par défaut. 16:9 pour le web ou YouTube.
- Voix : ElevenLabs (définitive),
say(brouillon) ou sans voix. - Musique : composée par le moteur ou une piste personnelle (recommandé pour publier).
Si l'utilisateur apporte une commande complète (references/encargo.md) ou dit « les décisions sont les tiennes », ne demande pas : produis et explique ensuite dans DECISIONES.md.
Flux
1. Projet
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <dossier-du-spot> # avec l'exemple « Turnito » comme référence
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <dossier-du-spot> --limpio # squelette vide
Copie le modèle, installe les dépendances (environ 10 s) et vérifie que Chrome est disponible. Copie les actifs de l'utilisateur dans activos/.
2. Concept et archétype
Lis references/arquetipos.md et choisis un archétype (plus un plan emprunté pour le moment wow). Écris :
- Le concept en une phrase, avec sa tension : « Le chaos du samedi contre le calme de réserver en 3 clics ».
- L'insight de marque : un détail propre à la marque que personne d'autre ne pourrait utiliser (la flèche d'Amazon qui relie le A au Z, le swoosh qui coupe l'écran). S'il n'y en a pas, le spot sera générique.
3. Script de voix → guion.json
Lis references/voz-y-musica.md. La voix s'écrit avant l'animation, car elle marque le tempo de tout. Une phrase par scène, de 2 à 8 mots, avec accents et signes d'ouverture. Accroche de situation (« Il est 2 heures du matin... »), action, bénéfice, pic et marque + slogan. Écris guion.json avec les scènes, le BPM, le style de musique, la scène pico et les effets.
4. Feuille de plans
Un tableau, une ligne par scène : temps · voix · héros · caméra · techniques de motion graphics (3 ou plus, de references/lenguaje.md) · transition de sortie. Règles :
- Trois couches par plan : fond vivant + héros + détail.
- La caméra bouge toujours. Transitions de motion graphics (coupe sur le beat, zoom à travers, rideau, iris, poussée), pas de fondus.
- Un pic vers 70 % dans la couleur de la marque ou en 3D.
- Minimum 8 techniques différentes dans le spot.
Si le spot est long ou coûteux, montre la feuille à l'utilisateur avant de construire. S'il a dit « fais-le », continue.
5. Système visuel → estilo.css
Lis references/diseno.md. Définis des variables (--fondo, --tinta, --acento, --acento2...) et les classes de l'interface recréée avec un préfixe propre (.ui ...). Typographie : sans noire serrée + un mot en serif italique + mono pour le HUD (déjà installées : Inter, Instrument Serif, JetBrains Mono et Anton).
6. Voix et temps
- ElevenLabs : une génération par scène →
audio/voz/<id>.mp3→node motor/preparar.mjs --recortar. - Brouillon :
node motor/preparar.mjs --borrador-voz. - Ensuite
node motor/preparar.mjs: mesure les voix, quantifie les coupes au pouls et écritguion.tiempos.jsonavec le temps estimé de chaque mot.
7. Construire scène par scène → escenas.js
Lis references/motor.md (API, recettes et pièges connus). Pour chaque scène :
spot.escena('id', (capa, c) => { ... })avec ses trois couches, sa dérive de caméra et ses techniques.- Synchronise avec la voix :
spot.cuando('id', 'palabra'). node motor/render.mjs --fotos <debut+0.1>,<milieu>,<fin-0.1>et regarde la planche (salida/fotos/hoja.jpg) avec Read. Corrige avant de continuer.
Utilise plantilla/escenas.js (Turnito) comme référence de niveau : comment faire l'occlusion, l'orbite, la roue des heures, les notifications, la 3D de voxels, le rideau et le zoom à travers.
8. Musique et mixage
node motor/musica.mjs # compose au BPM, avec une chute dans la scène « pico » ; ou utilise la piste personnelle de guion.json
node motor/mezcla.mjs # voix + musique avec ducking + effets, à -14 LUFS
Avec node motor/servir.mjs, l'utilisateur peut voir l'aperçu avec l'audio et le parcourir.
9. Rendu, révision et polissage
node motor/render.mjs --fotos # planche de 12 photos : composition, orthographe et zones de sécurité
node motor/render.mjs --subida # final : 30 fps, flou 4×, finition, plus la copie de < 10 MB (2 à 3 min par 20 s)
Passe la liste de references/calidad.md (trois passages). Ensuite, fais un tour uniquement de polissage : micro-animations secondaires, accents sur les temps forts, premiers et derniers plans de chaque scène. Le second tour est ce qui sépare le bon de l'excellent.
10. Livraison
salida/spot.mp4etsalida/spot-subida.mp4.- Couverture : la photo du moment le plus frappant, pas la première.
DECISIONES.md: concept, archétype, décisions, ce qui a été écarté, itérations et temps (modèle danscalidad.md).- Dans le chat : le chemin, ce qui est un brouillon (voix
say, musique synthétisée) et 2 ou 3 améliorations concrètes.
Règles à ne pas enfreindre
- Tout est fonction du temps
t. Pas deMath.random,Date.now, d'animations CSS, desetTimeoutni derequestAnimationFramedans le spot. Pour l'aléatoire :ruido(i)ouazar(semilla). - Ne mets jamais
transformdans le CSS de quelque chose que GSAP anime (utilisexPercent/yPercent). C'est la cause numéro un des éléments décalés. - Regarde les photos de chaque scène avant de continuer. Rien n'est livré sans avoir été vu.
- Actifs réels ou on dit qu'ils sont d'exemple. Les interfaces sont recréées avec fidélité à partir de captures, on n'invente pas de « génériques ».
- Marques tierces : un spot d'une marque réelle qui n'appartient pas à l'utilisateur est un exercice de portfolio (« spec »). Il n'est pas publié comme officiel, aucune relation avec la marque n'est suggérée et son logo n'est pas déformé.
- Données : elles appartiennent à l'utilisateur ou sont marquées comme illustratives.
- Je ne peux pas entendre. Je vérifie les niveaux (pic de -1 à -2 dB, -14 LUFS) et que la voix sonne au-dessus de la musique ; l'utilisateur juge à l'oreille.
- Contexte : un spot consomme beaucoup de contexte. Si la session dépasse 40 % de contexte, compacte avant de continuer à construire.
- Paroles de chansons : Claude ne les écrit nulle part (code,
letra.json, chat), même si l'utilisateur les fournit. Pour les vidéos avec paroles : temps dansletra.jsonavec le texte vide, spot qui fonctionne avec et sans paroles, validation avec des phrases neutres dans une copie de test, et l'utilisateur colle les paroles et lance le rendu final. Détail dansreferences/motor.md→ « letra.json ».
Vidéos musicales et avec vidéo de fond
node motor/extraer.mjs <video> --desde S --hasta S extrait les images (activos/clip/) et l'audio de la section ; videoCuadros(...) les affiche synchronisés ; motor/letra.js fait le karaoké à partir de letra.json. Archétype 9 dans references/arquetipos.md.
Si quelque chose échoue
| Symptôme | Cause probable |
|---|---|
window.spot.listo n'est jamais à true | Erreur JS dans escenas.js : le rendu imprime les erreurs de la page. Vérifie les imports et que await spot.terminar() existe |
| Un élément apparaît décalé ou saute | transform dans le CSS plus GSAP ; ou une classe qui entre en conflit avec une autre (.app) ; ou un sélecteur descendant trop large |
| Une scène apparaît en blanc ou noir | L'id n'est pas dans le script (exécute preparar.mjs), ou une transition a laissé la couche avec opacity: 0 |
| Le 3D semble plat | Il manque transform-style: preserve-3d sur un conteneur intermédiaire, ou il y a un overflow ou filter au milieu |
| La voix et l'image ne correspondent pas | Ajuste de ± 0,1 s sur spot.cuando(...) ; vérifie dans servir.mjs avec l'audio |
| Le rendu prend trop de temps | Utilise --blur 1 --escala 0.5 pour les brouillons ; réduis les nœuds avec ombre ou flou ; diminue n dans voxelOla ou particulas |
| Le MP4 pèse trop lourd | C'est le grain : --grano 3 ou --crf 22 ; pour l'upload, --subida |