Communitygithub.com

yazzang-homelab/motion-studio

Donnez au mouvement une sensation physique grâce aux ressorts en forme fermée de lib/motion.js : préréglages, springFromFeel, track() pour valeurs multi-cibles, boucles loopTrack, indicateurs, échanges de texte. Utilisez-le pour 'donne l'impression d'être linéaire', 'ajoute du rebond', 'des easings aux ressorts'.

Qu'est-ce que motion-studio ?

Cette compétence permet d'utiliser des ressorts physiques en forme fermée pour animer des interfaces, du texte, des caméras, et des formes dans un projet de film. Contrairement aux animations linéaires classiques, les ressorts accélèrent avec une masse, dépassent légèrement la cible puis s'installent, donnant une sensation naturelle et réactive. L'API comprend des fonctions comme `sp()` pour des animations simples, `track()` pour des valeurs multi-cibles qui s'enchaînent sans à-coup, `loopTrack()` pour des boucles parfaites sans saut à la jointure, `indicator()` pour des indicateurs à étirement, et `swapAlpha()` pour des transitions de texte. Les préréglages (`snappy`, `default`, `heavy`, `playful`) couvrent les cas d'usage courants avec des ratios d'amortissement et des dépassements calibrés. La compétence est conçue pour les projets de film avec `lib/motion.js` et peut être utilisée pour refactoriser un film entier afin de remplacer les interpolations linéaires et les easings prédéfinis par des ressorts physiques, améliorant ainsi la qualité perçue du mouvement.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/springs

Demander à votre IA préférée

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

Documentation

Ressorts (étape du cours 08)

Les easings bon marché passent de A à B sur une courbe fixe. Un mouvement avec masse accélère, dépasse légèrement et s'installe. Les ressorts dans lib/motion.js sont des réponses en forme fermée, donc ils restent une fonction pure du temps : l'image 812 se rend sans simuler les images 0 à 811, et seek(t) reste déterministe.

Importez depuis lib/motion.js du projet de film (chemins relatifs au fichier : ../lib/motion.js depuis film/film.js, ../../lib/motion.js depuis film/scenes/*.js). Les numéros de préréglages complets se trouvent dans ${CLAUDE_SKILL_DIR}/references/presets.md (references/presets.md).

1. API

FonctionRetourneNotes
sp(t, preset = 'default')0 à 1l'appel quotidien ; t est le temps depuis le déclenchement (lt - 0.2), 0 avant le déclenchement
spring(t, k, d, m = 1) / springVel(...) / springPV(...)x / v / [x, v]forme brute k/d ; exact sous-, critique- et sur-amorti
SPRINGS{ snappy, default, heavy, playful }paires {k, d}, voir le tableau ci-dessous
resolveSpring(p){k, d}accepte un nom de préréglage, {k, d} ou {duration, bounce} partout où un ressort est attendu
springFromFeel({ duration, bounce }) / feelFromSpring({k, d}){k, d} / {duration, bounce}paramètres adaptés aux designers (convention Apple)
track(t, keys, spring = 'default') / trackVel(...)valeur / vélocitékeys = [[time, value], ...] trié ; un ressort par changement, additionné ; un troisième élément optionnel remplace le ressort pour ce changement ([2.4, 420, 'heavy'])
loopTrack(t, keys, dur, spring = 'default', cycles = null)valeurboucles sans couture. Les temps des clés sont dans un cycle, 0..dur, et ne sont pas enroulés (en dehors, une erreur est levée). La dernière valeur doit être égale à la première. Une clé exactement à dur est le changement à la jointure
indicator(t, stops, { width = 120, lead = 'snappy', trail = {k: 140, d: 22} }){ left, right }indicateur d'onglet qui s'étire : les bords sur des ressorts différents
swapAlpha(t, tIn, tOut, { inDelay = 0.08, inDur = 0.12, outLead = 0.1, outDur = 0.1 })0 à 1texte dans une boîte en morphing : entrée après le début du morph, sortie avant le suivant
stagger(i, step = 0.03)secondesdélai pour l'élément i
stepTime(t, rate = 12)t par paliers"sur les deux" uniquement pour les dessins, jamais pour la caméra ou les fondus globaux. Passez c.frameLt (ou c.frameT), le temps de l'image de sortie, pour une coupe franche entre les paliers ; c.t / lt sont des temps sous-image et mélangent les deux paliers sur les images où un palier change
loopT(t, dur)t enroulé dans [0, dur)enroulement temporel ; pas suffisant seul pour les ressorts (utilisez loopTrack)
settleTime(spring, eps = 0.01) / overshoot(spring)secondes / fractionplanifiez les arrêts et les points de coupe
easeOutCubic, easeInOutCubic0 à 1uniquement pour les fondus non physiques (opacité) ; jamais pour les choses qui bougent

2. Préréglages

Préréglagek / dRapport d'amortissementDépassementStabilisation (1%)Utilisation
snappy320 / 300.8390.79%0.24 sboutons, interrupteurs, bords d'attaque, curseur
default170 / 260.99700.51 scartes, conteneurs, caméra
heavy90 / 201.05400.78 sgrands caractères, objets 3D, logos
playful220 / 140.47218.6%0.59 smascottes, autocollants

Règle maison : tout petit dépassement sur l'UI (snappy), aucun sur le texte (default ou heavy pour l'échelle et la position du texte héroïque), playful uniquement là où le dépassement est la blague. Nombres complets, conversions de sensation et formules : references/presets.md.

3. Recettes

À l'intérieur d'une scène draw(g, lt, c) : lt est le temps depuis le début de la scène, c.t le temps du film, c.L la mise en page, c.brand les jetons de marque, c.grid la grille de beats, c.film.dur la durée du film (c.dur est la durée de la scène). Avec le flou de mouvement activé, c.t et lt sont le temps sous-image en cours de rendu (le flou de mouvement se fait tout seul) ; c.frameT / c.frameLt sont le temps de l'image de sortie et c.frame son index, identiques pour chaque sous-image. Les extraits supposent const { t, L } = c; et les imports depuis lib/motion.js, lib/draw.js et lib/rng.js.

Entrée unique (déclenchement 0.15 s dans la scène) :

const s = sp(lt - 0.15, 'snappy');
withTransform(g, { x: L.cx, y: lerp(L.cy + 80 * L.u, L.cy, s), s: lerp(0.92, 1, s) }, () => { /* dessiner */ });

Celui-ci commence visible : la position et l'échelle sont à leurs valeurs de départ pendant que le ressort est à 0, donc l'image 0 n'est pas vide. Elle serait vide si s pilotait la seule chose à l'écran via l'opacité ou un cache. Pour une scène qui est à l'écran à l'image 0 (l'accroche), ouvrez en pleine action en déclenchant le ressort AVANT la scène : sp(lt + 0.3, 'snappy'), ou kinetic(g, 'FAIS-LE BOUGER.', x, y, lt + 0.3, { ... }), ou kinetic(..., { delay: -0.3 }). À lt = 0, le texte est alors à 0.3 s dans son ascension au lieu de ne pas être dessiné (kinetic ignore chaque glyphe dont le ressort est encore à 0). La critique signale une image 0 vide comme une P0 (l'image 0 est presque vide).

Une valeur avec plusieurs cibles (ne redémarrez jamais un ressort ; ajoutez-en un par changement) :

// curseur x en px logique : repose à 200, bouge à 1.0 s et 2.4 s, revient à 3.6 s
const cx = track(t, [[0, 200 * L.u], [1.0, 640 * L.u], [2.4, 420 * L.u], [3.6, 200 * L.u]], 'snappy');

Le temps de la première clé est ignoré : sa valeur est la valeur de repos depuis le début. Chaque changement après cela démarre son propre ressort à son propre moment, et la somme reste continue en position et vélocité même lorsqu'une nouvelle cible arrive avant que la dernière ne se soit stabilisée.

Morphing d'une seule forme (le conteneur ne coupe jamais ; chaque propriété est une piste sur les mêmes temps de clés) :

const K = [0, 1, 2, 3].map((n) => c.grid.bar(n));       // changements d'état sur les temps forts, depuis la grille
const w = track(t, [[K[0], 320], [K[1], 120], [K[2], 760], [K[3], 320]].map(([k, v]) => [k, v * L.u]));
const h = track(t, [[K[0], 96], [K[1], 120], [K[2], 480], [K[3], 96]].map(([k, v]) => [k, v * L.u]));
const r = track(t, [[K[0], 48], [K[1], 60], [K[2], 32], [K[3], 48]].map(([k, v]) => [k, v * L.u]));
fillRoundRect(g, L.cx - w / 2, L.cy - h / 2, w, h, Math.max(0, r), c.brand.colors.fg);
withAlpha(g, swapAlpha(t, K[1], K[2]), () => ring(g, L.cx, L.cy, 36 * L.u, sp(t - K[1] - 0.1), { color: c.brand.colors.accent }));

Couleurs : ressortez une progression de 0 à 1 et mélangez avec mixColor(a, b, p) depuis lib/draw.js (elle sature p), ou, pour une couleur avec plusieurs cibles, pistez chaque canal et saturez à 0 à 255. Le rayon et les tailles qui peuvent dépasser en dessous de zéro nécessitent Math.max(0, ...).

Indicateur d'onglet qui s'étire entre les arrêts :

const { left, right } = indicator(t, [[0, x0], [1.5, x1], [3.0, x2]], { width: 140 * L.u });
fillRoundRect(g, left, y, right - left, 6 * L.u, 3 * L.u, c.brand.colors.accent);

Boucle sans couture (la valeur et sa vélocité correspondent à travers la jointure) :

// boucle de 6 s : a au repos, b à 1.5 s, c2 à 3 s, retour à a à 4.5 s
const x = loopTrack(t, [[0, a], [1.5, b], [3, c2], [4.5, a]], c.film.dur, 'default');
// la même boucle avec le retour comme changement à la jointure : la dernière clé se trouve exactement à dur
const y = loopTrack(t, [[0, a], [1.5, b], [3, c2], [c.film.dur, a]], c.film.dur, 'default');

Règles de loopTrack (vérifiées par rapport à lib/motion.js) :

RègleDétail
les temps des clés restent dans 0..durils sont relatifs au cycle et jamais enroulés ; un temps en dehors lève loopTrack: la clé <i> au temps <t> est en dehors de 0..<dur> (un tout petit peu après dur suite à l'arithmétique de la grille est toléré)
la première clé est la valeur de reposson temps est ignoré (elle doit quand même être dans 0..dur) ; la valeur est celle à partir de laquelle le premier changement commence
la dernière valeur est égale à la premièresinon elle lève la dernière valeur (...) doit être égale à la première (...)
une clé à dur est le changement à la jointurele ressort commence à t = 0 du cycle suivant : l'image 0 (= image dur) montre la valeur avant la jointure et ease vers la première valeur. Cela équivaut à écrire [[0, pre], [0, post], ...]. Écrivez le changement à la jointure une fois, à 0 ou à dur
un changement juste avant dur peut encore bouger à l'image 0la somme est exactement périodique, donc la position et la vélocité correspondent à travers la jointure quelle que soit la synchronisation. Pour ouvrir sur une image fixe, gardez le dernier changement au moins settleTime(preset) avant dur (0.51 s pour default)
cyclesle nombre de cycles précédents additionnés suit le temps de stabilisation et la dernière clé, donc les clés tardives sont sûres ; cycles le remplace

Un simple loopT plus track saute à la jointure car les ressorts déclenchés vers la fin bougent encore à t = 0. loopTrack additionne aussi les ressorts des cycles précédents (assez pour se stabiliser) et donne, avec les clés [[0, 0], [2, 100], [4, 40], [6, 0]] et dur 6, les valeurs 0.001 / 99.997 / 40.002 à t = 1 / 3 / 5. Vérifiez la jointure dans out/review/<fmt>/loop.png après npm run critique : |last - first| devrait ressembler à un pas normal et |end - first| (l'état final non enroulé) devrait être noir.

Apparitions échelonnées (graines par élément, jamais un flux partagé) :

for (let i = 0; i < n; i++) {
  const r = rngFor('tile', i);
  const s = sp(lt - stagger(i, 0.035) - range(r, 0, 0.06), 'playful');
  // dessiner la tuile i mise à l'échelle par s
}

Texte cinétique : kinetic(g, str, x, y, lt, { size, family, weight, color, spring: 'snappy', stagger: 0.035, rise: 0.6, by: 'char' | 'word', mask, delay, alpha, align, baseline, style, tracking }). family par défaut à brand.fonts.display et weight au poids le plus proche que la famille a enregistré, donc laissez les deux de côté sauf si le design nécessite une autre police. mask: true coupe la course à sa boîte de ligne pour que les glyphes s'élèvent depuis derrière un bord au lieu de fondre ; delay décale toute la course (négatif ouvre en pleine action). Pour le texte héroïque, passez spring: 'default' ou 'heavy' lorsque l'ascension est assez grande pour que le dépassement de 0.8% se voie. Copie multi-lignes : wrapText(g, text, maxW, font(size, family)) renvoie les lignes (ne coupe jamais à l'intérieur d'une syllabe Hangul) ; dessinez-les avec y + i * 1.2 * size ou plus et donnez à chaque ligne son propre delay.

Dessins sur les deux (aspect dessiné à la main) : const td = stepTime(c.frameLt, 12) pour l'animation propre du dessin (le temps de l'image de sortie, donc chaque palier est une coupe franche même avec le flou de mouvement activé) ; gardez les mouvements de caméra, les fondus et l'UI sur lt continu, ou les panoramiques font un pas 12 fois par seconde et sont perçus comme un décalage.

4. Refactoriser un film complet

Utilisez le modèle d'invite dans le projet : lisez prompts/refactor-springs.txt et suivez-le (ou collez-le comme tâche). Il remplace chaque interpolation linéaire et easing standard qui déplace quelque chose par des préréglages, track(), loopTrack(), indicator() et swapAlpha(), garde le timing, et rapporte chaque changement. Ensuite :

  1. npm run lint (doit être propre).
  2. npm run stills et node tools/critique.mjs --strip-at <t> au moment le plus chargé : strip.png montre 12 images consécutives, ce qui expose les pops, les redémarrages et les glissements qu'une planche contact cache.
  3. Enregistrez le changement dans le prochain tour de critique (/motion-studio:critique-loop).

5. Erreurs à attraper

ErreurÀ quoi ça ressembleCorrection
redémarrer un ressort à chaque cible (sp(t - tNew) depuis l'ancienne valeur)la vélocité saute à 0, un coude visibletrack() avec toutes les cibles
sommes artisanales de ressorts avec leurs propres valeurs de départsauts quand deux changements se chevauchentun track() par valeur ; les préréglages par changement vont dans le troisième élément de la clé
loopT seul sur une valeur de ressortsaut à la jointureloopTrack() avec des clés dans 0..dur et dernière valeur == première
dépassement sur du textele texte vacille, semble bon marchédefault / heavy pour le texte
playful sur le chrome de l'UIinterface de jouetsnappy pour l'UI
ressort uniquement sur l'opacité alors que la position est linéaireles fondus sont beaux, les glissements sont bon marchéressortez la position ; l'opacité peut suivre easeOutCubic
tout sur le même préréglage et le même délaimécanique, pas de hiérarchiecommencez par snappy, suivez avec default, stagger() le reste

Suite : /motion-studio:conception-sonore pour verrouiller le mouvement sur le beat, puis /motion-studio:boucle-de-critique.

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

Skills associés