Communitygithub.com

ayangabryl/seenry-skills

Construire, revoir ou rechercher des animations d'interface : retours de pression, menus, infobulles, boîtes de dialogue, feuilles, notifications, accordéons, onglets, transitions de page et d'éléments partagés, effets de défilement, glisser-déposer et gestes, changements de nombres et d'icônes. Décide si quelque chose doit être animé, puis choisit l'outil, les propriétés, la courbe, la durée ou le ressort, le comportement d'interruption et de mouvement réduit, avec des recettes CSS modernes testées et des ressources exécutables. Étudie également les mouvements enregistrés à partir des références Seenry.

Qu'est-ce que seenry-skills ?

Cette compétence, `ayangabryl/seenry-skills`, est dédiée à la conception, l'évaluation et la recherche d'animations pour les interfaces utilisateur. Elle guide l'utilisateur à travers une séquence de décisions pour déterminer si une animation est nécessaire, quel outil utiliser (CSS Transitions, View Transitions API, Web Animations, Motion, etc.), quelles propriétés animer, et comment paramétrer la courbe d'assouplissement, la durée ou le ressort. L'objectif est de créer des animations qui expliquent un changement d'état (comme l'ouverture d'un menu ou le déplacement d'un élément) de manière fonctionnelle et esthétique, en évitant les animations inutiles ou excessives. Elle prend également en charge la gestion des interruptions, des comportements de mouvement réduit et fournit des ressources exécutables et des recettes CSS modernes pour des composants d'interface courants. Cette compétence est particulièrement utile pour les développeurs utilisant des agents IA comme Claude Code, Cursor ou Codex, car elle fournit un cadre de décision structuré et des recettes testées pour la création de micro-interactions de haute qualité.

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

Demander à votre IA préférée

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

Documentation

Mouvement Seenry

Le mouvement existe pour expliquer un changement : d'où vient quelque chose, ce que l'entrée a fait, dans quel état se trouve l'interface maintenant. Construisez chaque animation à travers la séquence ci-dessous, dans l'ordre ; les étapes 1 et 2 décident si du code doit être écrit.

Prenez la décision et énoncez-la en une ligne ; ne proposez pas un menu d'options de mouvement. Étendez les jetons et composants de mouvement existants du projet au lieu d'ajouter un ensemble parallèle.

La séquence de construction

1. Est-ce que ça doit être animé ? Décidez en fonction de la fréquence.

Fréquence à laquelle les gens le voientDécision
100+ fois par jour (menu de commandes, raccourcis clavier, navigation dans une liste avec les flèches)Pas d'animation. Instantané.
Des dizaines de fois par jour (survol, onglets, bascules)≤150ms sur l'opacité et la couleur uniquement, ou rien
Occasionnellement (menus, boîtes de dialogue, feuilles, notifications)Mouvement standard selon le tableau ci-dessous
Rarement (intégration, premier succès, moments de passage du vide au plein)De la place pour le caractère

Les actions déclenchées par le clavier n'attendent jamais l'animation. Si la règle dit non, dites-le et publiez le changement d'état instantané.

2. Nommez l'objectif en un mot : feedback, orientation (d'où il vient ou où il va), état, continuité (éviter un saut brusque), explication (marketing et intégration uniquement), ou plaisir (moments rares uniquement). Pas d'objectif, pas d'animation. Les données que les gens lisent ne bougent jamais par style.

3. Choisissez l'outil le moins coûteux qui fonctionne.

BesoinOutil
Survol, pression, couleur, bascule de classe ou d'attributTransition CSS
Entrée au montage, sortie avant display: none, <dialog> et popover natifsTransition CSS + @starting-style + allow-discrete
Hauteur vers autointerpolate-size: allow-keywords, ou la piste de grille 0fr → 1fr
Changements de route, liste → détail, indicateurs de morphingAPI View Transitions
Effets liés au défilementanimation-timeline: view() / scroll()
Programmatique, annulable, sans bibliothèqueAnimations Web (element.animate)
Ressorts avec vélocité, animation de mise en page, gestes, présence dans ReactMotion (motion.dev)
Un composent entier (notification, tiroir, menu de commandes, sélection)Une bibliothèque maintenue, voir bibliothèques

4. Choisissez les propriétés. translate, scale, rotate, opacity, clip-path, filter seulement. N'entrez jamais depuis scale(0) : commencez à 0.95–0.97 avec l'opacité 0. Les popovers se mettent à l'échelle depuis leur déclencheur (transform-origin du côté du déclencheur) ; les boîtes de dialogue se mettent à l'échelle depuis le centre. Les translations en pourcentage (translate: 0 100%) se déplacent de la taille propre de l'élément.

5. Choisissez la courbe et la durée, ou un ressort.

MouvementDuréeEasing
Retour de pression100–160ms--ease-out
Infobulle, petit popover120–200ms--ease-out
Menu, liste déroulante, sélection150–250ms--ease-out
Boîte de dialogue200–250ms--ease-out
Feuille, tiroir350–500ms--ease-drawer
Élément se déplaçant sur l'écran, morphing250–400ms--ease-in-out
Couleur, arrière-plan, bordure au survol150msease
Progression, défilement, remplissage de confirmation maintenueaussi longtemps que le travaillinear

--ease-out: cubic-bezier(0.23, 1, 0.32, 1), --ease-in-out: cubic-bezier(0.77, 0, 0.175, 1), --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1). Jamais ease-in sur le mouvement d'interface : cela retarde exactement le moment que les gens regardent. Préférez l'UI produit sous 300ms ; un parcours de feuille plus long nécessite une raison. Les sorties sont souvent ~20–30% plus rapides que les entrées, sauf si la préservation d'une relation de manipulation directe ou spatiale justifie la même durée. Utilisez un ressort pour tout ce que l'utilisateur fait glisser, lance ou peut inverser à mi-chemin : Motion {type: "spring", duration: 0.5, bounce: 0.2} (bounce 0 pour l'UI produit, ≤0.3 pour le ludique), ou les ressorts CSS linear() dans recettes.

6. Planifiez l'interruption et la sortie. Préférez les transitions CSS pour les changements de propriétés réversibles car elles reciblent à partir de la valeur actuelle. Lorsque la géométrie ou la chorégraphie nécessite WAAPI, capturez l'état rendu actuel, annulez ou reciblez les animations possédées, et protégez contre les achèvements obsolètes. Une deuxième entrée inverse ou remplace l'ancienne demande plutôt que de se mettre en file d'attente derrière elle. Publiez le nouvel état logique immédiatement ; un état de présentation séparé peut conserver une sortie peinte.

Affinez le changement interrompu. Utilisez ces vérifications là où elles correspondent au composant. Ce sont des heuristiques de conception, pas un score de jugement garanti. Essayez des entrées répétées pendant l'entrée et la sortie, y compris à 50–150ms d'intervalle ; enregistrez les timings réels lorsque vous faites des affirmations de timing.

  • Conservez la continuité et la sémantique. Les onglets, filtres ou états de statut liés peuvent partager une cellule de grille (display:grid, grid-area:1/1) et transitionner l'opacité ou une petite translation. Gardez le contenu inactif hors de l'ordre de focus et de l'arbre d'accessibilité ; monté ne signifie pas interactif. Une phase de sortie rapide (environ 65–90ms) et une entrée de 120–160ms peuvent être un point de départ, pas une recette obligatoire. Démontage ou masquage uniquement lorsque la transition actuelle le permet ; un achèvement obsolète ne doit jamais masquer un état plus récent. Les sorties WAAPI explicitement annulables et les sorties de boîtes de dialogue natives protégées sont des alternatives valables.
  • Gardez le résultat compréhensible. Évitez les blancs accidentels ou le texte concurrent illisible. Choisissez le chevauchement, un court fondu enchaîné ou un remplacement instantané en fonction du contenu ; un fondu de l'étiquette entière peut être plus sûr que de déplacer du texte à travers une œuvre d'art. Conservez un repère statique approprié lorsque le mouvement est indisponible ou réduit. Inspectez la lisibilité réelle plutôt que d'utiliser un seuil d'opacité comme preuve.
  • Une seule copie d'une chose qui se déplace. Lorsqu'un titre, un avatar ou une couverture se déplace vers un nouvel endroit, évitez les doubles peintures visibles. Masquez la destination jusqu'à ce que le voyageur atterrisse, puis retirez la copie temporaire. Tracez le texte par rapport à l'œuvre d'art et à la coque mobile ; un point final non coupé ne prouve pas un chemin lisible.
  • L'étiquette est d'accord avec son résultat. Une étiquette comme "Marquer comme payé" devenant "Payé" suit le même état d'application accepté que son résultat. Réservez son empreinte lorsque cela est utile et empêchez le texte obsolète ou les étiquettes en double focusables. Ne retardez pas un véritable état de succès juste pour terminer la décoration.
  • Les séquences peuvent être annulées. Les démos de frappe, les révélations par étapes et les relectures partagent un propriétaire pour les étapes en attente. La pause, l'inversion et la nouvelle entrée annulent le travail obsolète et reciblent le mouvement visible à partir de son état actuel. Un délai d'attente obsolète ne doit pas reprendre une séquence en pause ni écraser un contenu plus récent.
  • Libérez les animations terminées. Établissez l'état stabilisé via CSS ou des styles engagés, puis libérez les animations WAAPI finies possédées lorsque cela est approprié. fill:forwards ne doit pas continuer à remplacer les changements d'état ultérieurs. Vérifiez les animations inattendues après que l'interaction se soit stabilisée, tout en permettant un indicateur de chargement continu intentionnel jusqu'à ce que son travail se termine.
  • Chaque mouvement explique une relation. Les menus grandissent à partir de leur déclencheur, les panneaux à partir de leur bord, et le contenu lié se déplace de manière cohérente avec la navigation. Utilisez les plages de durée ci-dessus comme points de départ ; maintenez la réponse perçue immédiate et justifiez un parcours plus long. Testez l'interruption et le mouvement réduit plutôt que de traiter une durée fixe comme preuve de qualité.

Atteindre 9. Sur le juge du mouvement, 7 est correct mais générique, 8 est clairement premium et 9 est distinctif au niveau d'Apple ou Linear. Les tours stagnent à 7–8 pour les mêmes quelques raisons. Gérez-les tous avant de passer un tour :

  • Un composant à la fois. Jugez chaque composant seul avec --labels "<Row>" jusqu'à ce qu'il marque 9, et conservez la meilleure version de chacun. Le score global d'un catalogue suit ses lignes les plus faibles, donc réparer plusieurs lignes à la fois ne le fait jamais bouger, et un changement qui abaisse une ligne est annulé même si le juge l'a suggéré.
  • Appliquez chaque correctif, pas seulement le principal. Les petits éléments qui reviennent (survol, pression et retour de commande de fermeture) maintiennent states à 7 tour après tour. --prev <last motion.json> liste les critères qui n'ont pas augmenté et les interactions demandées à corriger à nouveau ; check.mjs le passe automatiquement.
  • Un problème qui revient après son correctif est structurel. Le re-timing ne peut pas réparer un chemin qui se croise. Les éléments partagés conservent leur disposition relative entre les états : un titre en dessous de sa couverture reste en dessous dans la vue détaillée, donc aucun ne passe à travers l'autre.
  • Pas de cadres vides. À chaque moment filmé (30–320ms), la région modifiée affiche un contenu réel. Une coque porte son contenu en grandissant ; une réponse en streaming grandit à partir de ses premiers mots. Ne montrez jamais une boîte de réponse vide ou un squelette qui attend puis se dissout.
  • Une idée travaillée par composant. Ce qui persiste voyage et ce qui est nouveau naît de sa cause. Un fondu, une translation de 4px et un échange d'étiquette marquent 7.
  • Fermer là où il s'est ouvert. Une surface qui s'ouvre à partir d'un contrôle se ferme au même endroit : le contrôle devient (ou est remplacé sur place par) sa fermeture, donc la main ne voyage jamais. Il n'est pas nécessaire qu'il conserve la même couleur ; il conserve la place et la taille.
  • Un seul tour n'est pas un score. Un tour de juge (lui-même une médiane de trois) bouge d'un point sur un code inchangé. Acceptez un 9 uniquement lorsque deux tours séparés l'atteignent tous les deux, et comparez les versions sur le même nombre de tours.

7. Publiez le mouvement réduit et le blocage d'entrée avec. Sous prefers-reduced-motion: reduce, supprimez le mouvement, le parallaxe, le flou et les boucles ; conservez les courts changements d'opacité qui aident à la compréhension. Bloquez le mouvement au survol avec @media (hover: hover) and (pointer: fine). Chaque changement d'état animé laisse également un repère statique (étiquette, icône, couleur) pour lorsque le mouvement ne s'exécute pas.

Recettes

Commencez par les recettes pour les retours de pression, les menus et popovers, les infobulles, les boîtes de dialogue, les feuilles, les notifications, les accordéons, les entrées échelonnées, les indicateurs d'onglets, les transitions de page et d'éléments partagés, les révélations au défilement, les échanges d'icônes, les changements de nombres, la confirmation maintenue, le glisser pour rejeter (avec projection de vélocité et effet d'élastique), le masquage par fondu enchaîné, le changement de thème et la suppression du premier rendu. Les recettes CSS natives sont testées dans Chromium par les tests du package.

Ressources exécutables

Changement demandéRoute ciblée
Menu d'action ou étiquette de statut courteOriginal menu d'action, commutateur de statut et transitions produit. Si le menu doit s'animer ouvert et fermé, préservez sa surface pendant la phase de fermeture ; le démontage conditionnel à la fermeture saute cette phase. Pour une transition de statut, déplacez le texte dans un emplacement réservé ; un simple remplacement de texte ou un changement de couleur de point seul est incomplet. L'application possède l'action réelle.
Divulgation en ligne ou changement de géométrieOriginal carte extensible, aide-mémoire géométrique et motifs de surface. Préservez le focus et reciblez à partir de la géométrie actuelle.
Tâche modale cibléeOriginal surface modale et motifs de surface. Utilisez une boîte de dialogue native pour le comportement de calque supérieur et de focus ; permettez à la sortie de se terminer avant de fermer, et faites en sorte que l'inversion annule la fermeture en attente.
Changement de nombre ou d'icôneTransitions de nombres et adaptateurs. Pour un petit nombre entier, préférez l'aide-mémoire original count-pop plutôt que de reconstruire la sémantique des chiffres. Conservez une seule valeur accessible réelle ; ne cachez pas chaque chiffre et ne mettez pas aria-label sur un <strong> simple. Une transition de chiffres nécessite un mouvement par place ; gardez les unités ancrées.
Entrée ou sortie vocale en directOriginal présence vocale accepte l'état possédé par l'application et un niveau audio normalisé. Gardez les contrôles et les annonces dans le DOM ; un signal de démo généré n'est pas une activité de microphone.
Présence de chargement ou de processusOriginal champ de signal, trace de limite et motifs de chargement. Le temps d'animation n'est pas une progression.
Image décodée ou matériel expressifOriginal révélation d'image, surfaces solides réfléchissantes et à bords, inclinaison du pointeur, effets de surface et effets expressifs. Gardez le contenu utile pendant le chargement d'un remplacement ; utilisez la réflexion et l'inclinaison uniquement là où le matériel a un objectif.
Conception d'un nouveau composant interactif (brief, graphe d'état, score de mouvement, contrat d'entrée, checklist)Craft d'interaction
Pile de notifications ou de bannièresMotifs de retour et original réducteur de notification. Supprimez le débordement de l'état actif avant sa sortie ; testez le quatrième événement dans une pile de trois éléments.
Jalon accompli occasionnelOriginal rafale de confirmation. Enregistrez le succès dans l'état de l'application d'abord, puis jouez la décoration finie ; le résultat stabilisé doit rester visible après qu'elle se soit effacée.
Onglets sélectionnés ou changement de page ordonnéOriginal surface de sélection pour une surbrillance partagée et étape directionnelle pour les vues liées ; l'application possède la sélection, les panneaux, la route et l'historique. Utilisez motifs de navigation pour d'autres structures.
Défilement ou système coordonnéChorégraphie de défilement, scores travaillés, chorégraphie système et index de mouvement.

Sélectionnez uniquement le guide et l'aide nécessaires pour ce changement. Les ressources originales groupées sont des points de départ réutilisables, pas des substituts automatiques d'un composant source nommé ou une preuve de fidélité à celui-ci. Conservez les licences avec tout runtime tiers copié ; les ressources originales Seenry utilisent la licence MIT du dépôt.

Ne jamais publier

JamaisÀ la place
Animation sur une action 100+/jour ou déclenchée par clavierChangement instantané
transition: allNommez chaque propriété ou utilisez transition-behavior pour les propriétés discrètes
scroll-behavior: smooth sur le ou :rootContrôle programmatique (element.scrollTo({ behavior: 'smooth' }))
animation: spinrotate animé contrôlé par l'utilisateur
Mouvement pour lui-mêmeChaque mouvement raconte ce qui se passe
Librairies d'animation entières pour une transition de 40 pixelsUne transition CSS de 200 pixels ou element.animate()
transition-delay sur un survol ou un focus non-lié au contenuRéponse immédiate, délai réservé aux séquences d'essaimage
Animation d'entrée sur liste+gros contenus en dessous de la ligne de flottaisonPas d'animation jusqu'à ce que l'utilisateur fasse défiler, puis un décalage d'entrée
Animation de chargement qui cache ou retarde le contenu réelChargez le contenu, conservez sa place, puis révélez-le ; l'animation de contenu n'est pas le contenu
Animation sur :focus-visible pour les personnes utilisant à la fois la souris et le clavier@media (hover: hover) and (pointer: fine) pour le mouvement déclenché par le survol ; l'animation de focus aide tout le monde
Squelette de contenu qui attend puis se dissoutPassez de la coque au contenu par un fondu ; la coque ne se dissout pas en rien
Animation redondante : le même élément entre et que l'opacité changeEntrez par l'opacité et une translation, pas les deux dans la même direction
Image d'arrière-plan animéeAvancez le contenu, pas sa couverture
Boucle de rebond de défilement déconnectéeReliez les bords au-dessus ou en dessous de la zone de défilement
@keyframes qui est juste l'état de départ puis d'arrivéeUne transition gère cela en une ligne
`
}

Skills associés