Communitygithub.com

motion-language

Montre à un agent comment planifier, construire ou couper un « langage de mouvement » afin que le résultat concret soit un script ou un texte utilisable. La procédure parcourt le Motion Language, la seule distinction qui compte et le vocabulaire. Utilisez-la lorsqu'une nouvelle mission exige ce savoir-faire.

Qu'est-ce que motion-language ?

Cette compétence fournit un langage de mouvement cohérent et systématique pour produire des animations de type « stinger » (accroches visuelles courtes) destinées aux vidéos explicatives avec tête parlante. Elle définit une distinction cruciale entre les « scenes » (qui expliquent un argument) et les « stingers » (qui ponctuent une idée déjà entendue en 2 à 4 secondes). La compétence décompose la bibliothèque d'animations en cinq éléments visuels fondamentaux (fond, verre, éclat, courbe, état) et propose huit types de stingers prêts à l'emploi, chacun associé à une phrase narrative spécifique. Elle s'intègre aux environnements utilisant des fichiers de spécification `composition.json` et s'appuie sur des outils CLI comme `hyperframes` pour la vérification et la génération. La compétence est implémentée avec `scripts/stingers.py` et une galerie de rendu via `scripts/build_stinger_gallery.py`, et elle oriente vers des compétences upstream plus larges comme `hyperframes-animation` pour des besoins plus complexes.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lucasaerb/workless-video-editor/tree/HEAD/skills/motion-language

Demander à votre IA préférée

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

Documentation

Motion Language

Hérite de skills/00-house-rules/SKILL.md. L'implémentation est scripts/stingers.py ; la galerie qui rend tout cela est scripts/build_stinger_gallery.py.


La seule distinction qui compte

Une scène explique. Un stinger ponctue.

scènestinger
durée8–15 s2–4 s
porteun argument à lireune idée déjà entendue
visagecaché ou PiPcaché — on coupe vers lui
combien3–6 dans une vidéo de 10 minun toutes les 20–40 s
si on le retirele propos n'atteint pas son butla vidéo devient plus plate, pas erronée

Se tromper sur ce point est l'échec courant. Une liste à trois éléments avec du contenu réel est une scène compare ; la même liste en steps est une décoration. Si un spectateur doit la lire, ce n'est pas un stinger.

Les stingers sont coupés, pas superposés. Ils occupent le cadre pendant leurs quelques secondes. Un graphique plein écran avec l'intervenant encore visible derrière ressemble à une erreur, et 3 secondes sans son visage ne coûtent rien.


Le vocabulaire

Cinq éléments. Tout ce qui se trouve dans la bibliothèque est une combinaison d'entre eux, ce qui fait que des animations sans rapport se lisent comme un seul système.

fondPresque noir avec une douce élévation radiale. Jamais du #000 plat — un cadre noir pur ressemble à une perte de signal, pas à un design.
verreRemplissage translucide ~4,5 % d'encre, bordure de 1 px ~14 %, rayon 26. La profondeur provient de la bordure et d'un reflet intérieur, jamais d'une ombre portée sur la carte.
éclatUn balayage spéculaire ras sur une carte lorsqu'elle se stabilise. C'est le mouvement signature — c'est ce qui fait qu'un rectangle plat est perçu comme un objet physique.
courbeFines courbes en pointillés à ~10 % d'encre. Les choses se déplacent le long des courbes. Rien ne se téléporte.
étatUne rangée de petits points indiquant l'état du système. Un changement de couleur sur cette rangée signifie « et puis ça a cassé » sans un mot de texte.

Le décalage est de 120–160 ms. En dessous de 100 ms, les éléments frères sont lus comme un seul objet ; au-dessus de 200 ms, le spectateur commence à attendre.

Chaque stinger conserve sa dernière image. Il est coupé sur une parole, donc il doit être sûr de se terminer sur n'importe quelle image après le payoff. Rien ne boucle ; rien ne se termine sur un plateau vide.


La bibliothèque

{ "kind": "converge", "from": "tout converge vers un seul endroit", "dur": 3.4,
  "chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
kindla phrase sous laquelle il se placedur
converge« Tout cela converge vers un seul endroit. » Des tuiles voyagent le long de courbes en pointillés vers un noyau lumineux ; les points d'état se remplissent à mesure qu'il prend la charge.3,0–3,6
overload« Et puis ça s'est arrêté de fonctionner. » Le même noyau se fissure en rouge. Partage la géométrie de converge pour que les deux se montent comme une seule histoire.2,4–3,0
steps« Il y en a trois. » Cartes de verre numérotées, décalées, éclat sur chacune. Le plus réutilisable et le plus surutilisé.2,6–3,2
swap« Ceci, pas cela. » A est barré et remonte ; B arrive en dessous. Les deux restent lisibles.3,0–3,6
countup« C'était quarante-trois pour cent. » Un nombre grimpe, sa taille augmentant avec la valeur, sur une ligne de source visible.2,6–3,4
beatsTrois phrases courtes, percutantes. Chacune bénéficie d'une entrée différente sur une même grille de rythme partagée.2,4–3,2
surround« Tu es submergé d'outils. » Des tuiles étiquetées entourent un centre maintenu, puis se referment. Le centre ne bouge jamais.3,2–4,0
photoUne image trouvée, retraitée. Carte de verre, lent Ken Burns, légende, ligne de crédit.2,8–4,0
clipLa même carte contenant une vidéo au lieu d'un fixe. Pas de Ken Burns — elle bouge déjà.2,4–3,0

Utilisez-les dans composition.json exactement comme une scène — même ancrage from / at / dur, même erreur fatale si la phrase ne se résout pas.


B-roll : le stinger photo / clip

Deux traitements, et full choisit entre eux. full est opt-in ; omettez-le pour obtenir la carte.

full: true — B-ROLLfull: false — CITATION
cadreplein écran, sans cartecarte de verre, éclat, dérive lente
texte sur le cadreun tiers inférieur nommant ce qu'est le planlégende et ligne de crédit
source sur le cadrejamaisobligatoire
à utiliser pourdes vidéos et des images fixes qui portent un momentune capture d'écran, un graphique, une page de prix, un document

Le B-roll est plein écran et ne porte pas de référence source. Instruction permanente de l'humain, 2026-08-14. Il prend tout le cadre comme le B-roll dans tous les montages que quiconque a vus. Le seul texte autorisé dessus est un tiers inférieur indiquant ce qu'est le plan, jamais d'où il vient. L'attribution a toujours lieu — dans _FINAL/ATTRIBUTION.md du projet, que fetch_stock.py écrit au téléchargement et qu'aucun montage ne peut ignorer. Pexels et Pixabay rendent tous deux le crédit à l'écran facultatif, donc le registre satisfait la licence à lui seul et le cadre reste propre.

Cela remplace le paragraphe qui se trouvait ici pour le B-roll, qui disait qu'un clip plein écran « ressemble à une vidéo différente » et mettait tout dans une carte. Ce raisonnement tient toujours pour le cas de la citation et uniquement pour lui : lorsque le spectateur est censé lire l'élément comme une preuve que vous citez, full: false et la ligne de source revient sur le cadre.

Le constructeur par défaut reste la carte, et c'est délibéré. Inverser la valeur par défaut retraiterait silencieusement chaque scène photo déjà écrite contre elle — dont working/stingers/plan.json de drop-005 — et une spécification qui rendait une carte hier doit rendre la même carte aujourd'hui. Les nouveaux travaux demandent "full": true ; skills/executive-animator le fait toujours. Le changement d'un mot dans st_photo suffit si la carte est un jour entièrement retirée.

Note géométrique : le plein écran utilise object-fit: cover, donc fournissez une source déjà en 16:9. Un crop 2,19:1 affiché en plein écran perd 221 px de chaque côté, ce qui fait qu'un diagramme se retrouve avec sa première et sa dernière colonne coupées alors que chaque portail signale une boîte correcte.

Un constructeur, deux noms. photo pour une image fixe, clip pour une vidéo ; il bifurque sur l'extension du fichier, donc le nom n'existe que pour rendre une spécification lisible. Ce qui change réellement :

photoclip
élément<img><video muted playsinline> avec timing du framework
Ken Burnsoui, 1,00 → 1,07 sur la carteaucun

La vidéo n'a pas de Ken Burns. Le clip fournit son propre mouvement, et une rampe d'échelle sur un mouvement réel est précisément ce qui fait qu'un stock ressemble à un stock. Une image fixe est immobile et a besoin de la dérive pour rester vivante ; un clip non.

// B-roll. Plein écran, tiers inférieur indiquant ce que c'est, pas de source sur le cadre.
{ "kind": "clip", "from": "tout bouge en même temps", "dur": 3.0,
  "src": "broll/cut-data-flow.mp4", "caption": "Tout bouge en même temps" }

// Citation. Un document que le spectateur lit comme preuve, donc la carte et le crédit reviennent.
{ "kind": "photo", "full": false, "from": "la page de prix a changé", "dur": 3.2,
  "src": "assets/pricing.png", "caption": "Tarifs Anthropic, août 2026",
  "credit": "ANTHROPIC.COM · RÉCUPÉRÉ 2026-08-13" }

Le tiers inférieur est positionné à cap_left / cap_bottom, par défaut à 96 / 186 — paysage, ce qui dégage les 96 à gauche et 132 en bas de youtube_long. Un appelant 9:16 doit passer son propre cap_bottom : les reels réservent 520 en bas et la bande karaoké occupe y 1150-1400, donc la valeur par défaut paysage place une légende sous la barre de progression. Il n'existe pas de paire qui convienne aux deux cadres.

src se résout par rapport au fichier de spécification et le constructeur le copie dans le dossier assets/ du projet, donc un chemin erroné échoue bruyamment à la construction plutôt que de donner une carte vide. Obtenez les deux à partir de scripts/fetch_stock.py, qui imprime le bloc prêt à coller.

L'attribution est une obligation de registre, pas une obligation de cadre. Chaque élément de niveau 3 obtient sa ligne dans _FINAL/ATTRIBUTION.md du projet, écrit par fetch_stock.py au téléchargement — c'est ce qu'exige config/broll-policy.md et ce n'est pas optionnel. Que le crédit aussi apparaisse sur le cadre est une décision de design, et pour le B-roll la réponse est non. Sur une carte de citation il reste, s'affiche selon WCAG AA, et une attribution que personne ne peut lire n'est pas une attribution.

Résolvez d'abord chaque image dans l'ordre des niveaux. Une photo est un niveau 3 : n'y recourez que lorsque vos propres images et une superposition de niveau 2 n'ont vraiment rien à offrir. Le Ken Burns s'exécute sur le <img> à l'intérieur de la carte de découpage, jamais sur la carte elle-même.

⚠ Ne copiez pas le long motif d'insertion vidéo tiers. La référence dont ce langage est issu dure 50 secondes de séquences d'interview de quelqu'un d'autre. config/broll-policy.md l'interdit catégoriquement, et aucun bon design de mouvement ne le rend nôtre. Les photos avec attribution sont acceptables ; reprendre la moitié d'une vidéo ne l'est pas.


Le menu plus large — à quoi recourir quand rien ci-dessus ne convient

Deux corpus amont existent et les deux sont plus grands que cette bibliothèque. Lisez-les plutôt que d'inventer du mouvement.

Compétence hyperframes-animation — 48 règles atomiques + 22 plans de scène. Chargez-la avec Skill(hyperframes-animation), puis ouvrez rules-index.md et lisez la règle dont vous avez besoin dans rules/<name>.md. La valeur par défaut de la maison est composer 2–4 règles atomiques sur une seule timeline en pause ; un plan de scène est pour quand vous voulez un plan complet de 4–5 phases.

Le registre de blocs — 373 blocs installables : npx hyperframes catalog --query "<concept>", puis npx hyperframes add <block>.

Situation → règle

Curaté pour un explicatif avec tête parlante. Voici les règles qui survivent notre format ; les 48 autres supposent pour la plupart une UI de produit ou un curseur piloté que nous n'avons pas.

quand la ligne est…règlepourquoi ça convient
un nombre, une statistique, un pourcentagecounting-dynamic-scale, stat-bars-and-fillsdéjà implémenté comme countup ; utilisez les règles directement pour les barres, les anneaux, les remplissages d'étoiles
une liste percutante, en rafalekinetic-beat-slam, waterfall-entryimplémenté comme beats ; waterfall-entry est la cascade plus douce
une définition ou un terme qui arrivegradient-text-sweep, depth-scatter-assembleles glyphes ne bougent jamais dans la première ; la seconde les assemble depuis la profondeur
« voici sa forme » (un diagramme)svg-path-drawle contour se dessine lui-même. Mesurez avec getTotalLength() à la configuration
« c'est entouré / enfoui / connecté »radial-surround, avatar-cloud-network, orbit-3d-entryimplémenté comme surround ; les deux autres ajoutent des lignes de connexion et une entrée 3D
une idée qui en remplace une autrescale-swap-transition, card-morph-anchor, morph-swapimplémenté comme swap ; card-morph-anchor transforme le conteneur lui-même
« regarde de plus près ceci »depth-of-field-blur, coordinate-target-zoom, viewport-changemise au point, ou une caméra virtuelle sur un wrapper .world
accentuation d'un mot parléasr-keyword-glow, css-marker-patternslueur synchronisée avec les horodatages des mots — nous avons déjà des temps de mots mesurés
un accent dur et percutantchromatic-glitch, particle-burst, motion-blur-streakà utiliser avec parcimonie ; un par vidéo au maximum
un battement d'atterrissage calmetitlecard-reveal (plan), ambient-glow-bloomun mouvement faible est la charge utile, pas un défaut
n'importe quelle entréespring-pop-entrancele pop canonique. En cas de doute, celui-ci

Plans de scène à connaître

La plupart des 22 sont des formes de publicité pour le lancement de produit. Quatre correspondent à ce que nous faisons réellement :

  • kinetic-type-beats — le cheval de bataille. Les mots portent le plan, pas de décor, pas de surface.
  • dataviz-countup — quand les données portent l'argument.
  • comparison-split — deux capacités pesées en même temps (notre scène compare est une cousin plat).
  • titlecard-reveal — le battement de respiration, exactement un mouvement retenu.

Sautez cursor-ui-demo, device-surface-showcase, cta-morph-press, prompt-type-submit-generate et le reste de la famille de démos à moins que nous ne montrions réellement une UI de produit. Ils sont excellents et ne sont pas notre format — un explicatif avec tête parlante qui exécute soudainement une fausse démo d'application ressemble à une publicité.

Le contrat que chaque règle amont suppose

Bon à savoir avant d'en copier une, car les enfreindre n'échoue pas la vérification — cela échoue le rendu :

  • UNE timeline GSAP en pause sur window.__timelines. Jamais de lecture automatique, jamais de deuxième timeline.
  • Cherche en toute sécurité dans les deux directions — fromTo avec des états-from explicites, des valeurs absolues, jamais de += relatif. L'état doit être une fonction pure du temps de la timeline.
  • Déterministe — pas de Math.random(), pas de Date.now(). Aléatoire pseudo-aléatoire uniquement dérivé d'un index. Répétitions finies, jamais repeat: -1.
  • Transformations et peinture uniquement. Les interpolations width / height / top / left sont interdites ; utilisez des proxies de scale/translate ou des masques.
  • Les décalages de groupe sont plafonnés pour qu'une arrivée soit lue comme un seul battement — items × stagger ≤ ~0.5s.
  • Pré-calculez les constantes de mise en page. Ne dérivez jamais une position au moment de l'interpolation ; le rendu échantillonne en parallèle et la mesure se désynchronise.

Ajouter un nouveau concept

  1. Cherchez d'abord dans le registre — npx hyperframes catalog --query "<concept>". 373 blocs existent. radial-surround, morph-swap, split-tilt-cards et particle-image-reveal sont des cousins proches des choses dans cette bibliothèque et peuvent être un meilleur point de départ qu'un nouveau code.
  2. Construisez-le à partir des cinq éléments ci-dessus. Un concept qui a besoin d'un sixième élément est soit une scène, soit un signe que le vocabulaire a besoin d'une extension délibérée — pas d'une exception.
  3. Ajoutez-le aux KINDS dans scripts/stingers.py.
  4. Rendez la galerie et regardez-les tous ensemble. C'est la seule façon de savoir si un nouveau venu a rejoint la famille ou s'est simplement posé à côté d'elle.
python3 scripts/build_stinger_gallery.py <out> --photo <image>
cd <out> && npx hyperframes check
python3 scripts/probe_frames.py <out> --plan --grid sheet.png

Trois défauts que cette bibliothèque a déjà détectés

Chacun a passé un hyperframes check propre avant que quiconque ne regarde une image :

  1. GSAP ne peut pas animer ::after. Il résout les cibles avec querySelector, qui ne renvoie jamais un pseudo-élément, donc chaque éclat ne faisait rien silencieusement. L'éclat est maintenant un véritable élément enfant (SHEEN_EL). Si vous ajoutez une carte, mettez-la à l'intérieur.
  2. GSAP ne peut pas [suite tronquée]

Individual skills in this repo

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

Skills associés