Communitygithub.com

antheo-motion

Décide si un élément doit bouger, puis lui donne le timing, l’easing et la distance exacts (pressions, survols, menus, dialogues, feuilles, glissés, transitions de page) en gérant la réduction de mouvement. À utiliser quand l’interface est saccadée, statique ou trop chargée, quand un tiroir ou un glissé semble bizarre, ou avant de livrer une animation.

Qu'est-ce que antheo-motion ?

Antheo Motion est une compétence d’agent IA spécialisée dans le mouvement d’interface, conçue pour répondre aux questions : « Est-ce que ça doit bouger ? », « Pendant combien de temps ? », « Avec quelle courbe ? », et « Quelle distance doit parcourir l’élément ? ». Elle fournit une approche systématique pour décider, chronométrer et auditer les animations dans les applications web, en veillant à ce que chaque mouvement ait un but et ne soit ni saccadé ni excessif. La compétence s’applique à l’ensemble du cycle de vie d’une animation : décision (la raison du mouvement), timing (via des jetons de durée comme `--dur-fast`, `--dur-base` ou `--dur-open`), easing (avec des courbes cubic-bezier prédéfinies), et respect des préférences de mouvement réduit. Elle inclut également des scripts pratiques (`filmstrip.mjs`) pour filmer et inspecter les animations image par image, ainsi que des références détaillées (recettes, gestes, ressorts, performances). Utile pour les développeurs front-end et les designers d’interaction qui utilisent des agents comme Claude Code ou Cursor, Antheo Motion permet d’éliminer les animations inutiles, d’accélérer les plus fréquentes, et de s’assurer que chaque mouvement informe l’utilisateur sans jamais le gêner.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antheo-design/skills/tree/HEAD/skills/antheo-motion

Demander à votre IA préférée

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

Documentation

Antheo Motion

Le mouvement est une information sur le changement : quelque chose est arrivé, parti, s’est déplacé ou vous a répondu. Un mouvement qui n’explique rien n’est que du bruit ; un changement sans mouvement est un saut. Cette compétence décide quels changements bougent et donne à chacun son timing exact. Le moment signature d’un composant appartient à antheo-moment ; les jetons de durée sont générés par antheo-tokens ; l’exigence de mouvement réduit est vérifiée par antheo-access. Auditer, réduire ou planifier le mouvement dans toute une application est le rôle de antheo-motion-audit.

Décider dans cet ordre

  1. Listez chaque changement que l’écran produit : ce qui s’ouvre, se ferme, apparaît, disparaît, se réorganise, se met à jour, se charge, réussit ou échoue.
  2. Marquez la fréquence à laquelle une personne voit chaque changement : plusieurs fois par jour, quotidiennement, ou rarement.
  3. Attribuez à chacun sa durée et son easing à partir des tableaux ci-dessous.
  4. Confiez l’unique événement rare et significatif, s’il y en a un, à antheo-moment.
  5. Vérifiez-le rapidement, deux fois, et avec mouvement réduit, puis filmez-le et lisez les images (ci-dessous).

Nommez pourquoi ça bouge, ou ne le faites pas bouger

« Cela bouge pour que la personne comprenne ___. » Impossible de finir la phrase : pas d’animation.

Plus c’est vu, moins ça bouge

FréquenceCe qu’il obtient
Plusieurs fois par jour (saisie, lignes, onglets, menus, une palette)au maximum 150 ms, 4 px de déplacement ; au clavier, rien qu’un court fondu
Quotidiennement (un dialogue, une feuille, un toast, une sauvegarde)une courte arrivée et une sortie plus rapide, 150 à 300 ms
Rarement (un premier succès, une commande passée)l’unique endroit pour un moment signature (antheo-moment)

Les durées, par fonction

JetonValeurUtilisation
--dur-instant100 msRetour de couleur et d’opacité
--dur-fast150 msPression, survol entrée et sortie, ouverture d’un menu ou d’une infobulle
--dur-base200 msObjets qui disparaissent, fermeture d’un dialogue, échange de valeur ou de texte, arrivée d’un toast
--dur-open250 msOuverture d’un dialogue, onglets, accordéon, redimensionnement d’une carte
--dur-slow300 msMontée d’une feuille ou d’un tiroir, glissement d’un marqueur
--dur-page400 msTransition de page ou d’élément partagé

Le mouvement d’interface reste à 300 ms ou moins ; les déplacements de page à 400 ms ou moins. Les spinners, les barres de progression et le mouvement lié au défilement s’exécutent en linear.

Ouvertures et fermetures, par paires

ÉlémentOuvertureFermeture
Menu, popover, select150 ms, depuis scale(0.97) et un fondu, au niveau du déclencheur120 ms
InfobulleDélai de 400 ms, puis fondu de 150 ms ; immédiatement si une autre infobulle vient de se fermer dans les 300 msImmédiate
Dialogue250 ms : montée de 8 px, fondu, échelle depuis 0.96200 ms
Feuille, tiroir300 ms depuis son bord, totalement opaque (ni fondu, ni flou)200 ms
Toast200 ms, montée de 12 px200 ms, en sens inverse de son arrivée
Accordéon, révélation de hauteur250 ms, grid-template-rows: 0fr vers 1fr200 ms

Ne retardez jamais une fermeture ou un survol-sortie : raccourcissez plutôt la durée.

Une seule courbe pour arriver et partir

--ease-out cubic-bezier(0.23, 1, 0.32, 1) pour tout ce qui entre ou sort. --ease-in-out cubic-bezier(0.77, 0, 0.175, 1) uniquement pour quelque chose qui se déplace d’un endroit à un autre sur l’écran. --ease-in uniquement pour quelque chose qui est jeté définitivement. Les sorties sont plus rapides que les entrées et parcourent environ la moitié de la distance.

Petites distances, jamais à partir de zéro

Déplacement de 4 px pour un échange de valeur ou un popover, 8 px pour un dialogue, 12 px pour un toast, 24 px pour un élément héros ; le bord complet uniquement pour une feuille. Entrée depuis scale(0.96) (0.97 pour les menus, 0.98 pour les infobulles) avec une opacité de 0, jamais depuis scale(0). Flou de 4 px lors d’un échange de texte ou d’icône, 8 px sur une grande surface, 2 px sur un fondu enchaîné de moins de 200 ms.

Ce qui peut s’animer

transform et opacity (ainsi que la couleur) par défaut ; un flou court filter, clip-path, et grid-template-rows pour les révélations de hauteur si nécessaire. Jamais transition: all, jamais width, height, top, left ou margin, jamais box-shadow lui-même : placez une ombre changeante sur un pseudo-élément et fondez-la. will-change uniquement après qu’un profil le demande.

Poussez depuis le déclencheur

Les menus et popovers prennent leur transform-origin au niveau du déclencheur (Radix expose --radix-popover-content-transform-origin) ; une modale reste centrée ; une feuille vient du bord où elle se trouve ; un élément partagé (une carte s’ouvrant dans sa page) utilise un seul view-transition-name de chaque côté.

Transitions pour l’état, keyframes pour un coup unique

Tout ce qu’une personne peut basculer utilise une transition CSS ou un ressort, qui s’inversent en plein vol ; les keyframes uniquement pour les choses qui se jouent une fois.

Stagger de 30 à 40 ms, les huit premiers, 300 ms au total

60 à 80 ms pour les trois à six parties d’un élément héros. Ne stagger jamais quelque chose qui s’ouvre souvent, et ne bloquez jamais un clic pendant l’arrivée des éléments.

Ressorts uniquement là où une main le déplace

Un bouton de commutateur, un glissé relâché, une pilule segmentée qui glisse. Rebond de 0 à 0,2 sur les contrôles (le dépassement reste à l’intérieur de la piste), jusqu’à 0,45 pour une célébration rare ; un seul rebond au maximum. Un glissé suit le doigt sans transition et, au relâchement, rebondit à partir de la vitesse de relâchement ; une feuille se ferme sur un mouvement plus rapide qu’environ 0,11 px par ms, ou une fois qu’elle a parcouru min(64px, 15%) de sa hauteur, sinon elle revient en arrière (references/gestures.md).

Rien ne saute

Chaque valeur qui change est vue changer ; une ligne supprimée referme son espace ; de l’espace est réservé pour ce qui apparaît (décalage de mise en page inférieur à 0,1). Au chargement, au maximum une entrée. Changez de thème avec les transitions désactivées pendant une seule image.

Le mouvement réduit conserve l’histoire en fondus

Avec prefers-reduced-motion: reduce, les déplacements, échelles, flous, parallaxes et rebonds deviennent un fondu enchaîné d’opacité de 150 à 200 ms ; un bouton de commutateur se déplace immédiatement ; les boucles automatiques s’arrêtent. Tout ce qui bouge pendant plus de 5 secondes tout seul possède un contrôle de pause (WCAG 2.2.2) ; rien ne clignote plus de 3 fois par seconde (2.3.1).

Dans toute une application

  1. Trouvez : un tableau de chaque changement, sa fréquence d’apparition, comment il bouge actuellement, comment il devrait.
  2. Améliorez : des jetons pour chaque nombre, les sorties manquantes, l’origine au niveau du déclencheur, un motif à la fois.
  3. Supprimez : tout ce qui s’anime à chaque chargement, qui se joue sur une action quotidienne, qui retarde l’action suivante, qui boucle pendant que les gens lisent, ou qui dépasse 300 ms sur une action de routine. En cas de doute, supprimez.
  4. Approuvez ou bloquez : une phrase de justification, des jetons uniquement, les propriétés autorisées uniquement, une sortie plus rapide que l’entrée, le mouvement réduit géré, observé à vitesse normale et avec un ralentissement CPU à 4×.

Vérifiez-le

Cliquez sur tout rapidement, deux fois : ça s’inverse, ça ne saute jamais. Ouvrez le menu vingt fois : toujours rapide. Ralentissez le processeur de 4× : toujours fluide. Activez le mouvement réduit : rien ne bouge.

Regardez-le : une image fixe ne peut pas juger le mouvement

Une capture d’écran de l’état au repos ne dit rien sur la façon dont une chose bouge, et chaque vérificateur lit des images fixes. Filmez donc chaque mouvement que vous avez créé et regardez les images avant de le déclarer terminé :

node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".tuner" --click ".preset" --duration 600
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".sheet" --drag ".handle" --by 0,240 --duration 900

Cela ralentit la page à 0,1× (CSS, animations Web et horloge JavaScript), effectue une seule action, et dispose 12 images de l’élément sur une seule feuille, chacune avec son temps. Ouvrez la feuille et lisez chaque image :

  • chaque image semble composée par elle-même : aucun bord dur qui glisse, aucun flash de la mauvaise couleur, aucune boîte vide
  • chaque valeur qui change est vue changer : un nombre qui devrait défiler ne saute pas alors que son aiguille continue de bouger
  • rien ne se remet en page ni ne saute en cours de route ; la première image répond déjà à la pression
  • la fin se stabilise là où elle devrait : un ressort dépasse un peu et revient, un contrôle ne s’arrête pas net
  • filmez-le à nouveau avec --reduce et --dark : l’histoire est toujours racontée, et le fond sombre n’a pas de flash lumineux

Corrigez ce qu’une image montre, filmez à nouveau, et conservez la dernière feuille comme preuve.

Ce que l’interface générée fait mal ici

Vérifiez chaque point dans references/habits.md avant de déclarer le travail terminé : transition: all · contenu masqué jusqu’à ce qu’un script le révèle · une réinitialisation généralisée du mouvement réduit · un anneau de focus qui fonde ou glisse · un mouvement qui s’exécute · des effets de survol sur des éléments non cliquables · une transition qui lit un nom que personne n’a défini.

Quand plus de mouvement est justifié

Les règles de finalité et de fréquence décident ; les nombres sont des valeurs par défaut. Un jeu, un outil créatif, un produit d’apprentissage ou un moment de marque demandé par la personne peut bouger plus et plus longtemps. Il répond toujours immédiatement à l’entrée, ne bloque jamais l’action suivante, peut être interrompu en cours de route, respecte le mouvement réduit, et montre son coût : une image lente sur un téléphone milieu de gamme est un constat, quel que soit le style.

Terminé

  • Chaque changement listé avec sa fréquence d’apparition ; les fréquents bougent à peine ; les actions au clavier ne se déplacent pas
  • Durées et easing issus des jetons ; les paires ouverture/fermeture ci-dessus ; aucune fermeture retardée
  • Uniquement les propriétés autorisées ; origine au niveau du déclencheur ; rien depuis scale(0)
  • Le mouvement réduit devient un fondu enchaîné ; les boucles de plus de 5 s peuvent être mises en pause
  • Cliqué rapidement deux fois, avec ralentissement 4× et avec mouvement réduit
  • Chaque mouvement filmé (scripts/filmstrip.mjs), chaque image lue, en clair, sombre et réduit
  • Vérifié contre chaque habitude dans references/habits.md

Fichiers

  • scripts/filmstrip.mjs : filme un mouvement à 0,1× en une feuille d’images, avec le temps sous chacune
  • references/recipes.md : l’index de 36 recettes prêtes à copier, un fichier chacune dans references/recipes/, de la pression et du popover au défilement de nombres et au texte en streaming
  • references/why.md : la raison derrière chaque règle, pour quand une valeur semble arbitraire ou que quelqu’un veut la transgresser
  • references/gestures.md : glissé, balayage, feuilles, points d’accroche, élan, élastique (sensation téléphone : antheo-mobile)
  • references/choreography.md : plusieurs choses comme un seul changement : fermeture d’espaces, réorganisations, redimensionnement de panneaux, fondus enchaînés
  • references/springs.md : ressorts en mots simples, préréglages, un ressort JS en 30 lignes, linear() avec alternatives
  • references/performance.md : ce qui est bon marché à animer, 60 images par seconde sur un téléphone bon marché, comment profiler
  • references/advanced.md : 3D, animation liée au défilement, transitions de vues, filmer le mouvement
  • references/vocabulary.md : descriptions simples vers noms de motifs vers recettes
  • references/motion-kit.css : la copie de secours du motion.css généré
  • references/habits.md : ce que l’interface générée fait mal ici, chaque point avec son correctif

Skills associés