Communitygithub.com

Asymmetric-al/core

Construire une animation de zéro en prenant les décisions dans l'ordre qui détermine si elle est juste — doit-elle animer, quel objectif, quel outil, quelles propriétés, quelle courbe et durée, comment elle interrompt, comment elle sort. Écrit l'implémentation. Utilisez-la lorsque l'on vous demande d'animer quelque chose, d'ajouter du mouvement, de donner vie à un composant ou de construire une transition. Pour critiquer une animation existante, utilisez review-animations ; pour auditer toute une base de code, utilisez improve-animations. Ne s'exécute que lorsqu'elle est explicitement invoquée ; elle ne se déclenche pas d'elle-même.

Qu'est-ce que core ?

Asymmetric-al/core est une compétence d'agent IA conçue pour construire des animations web selon la philosophie d'Emil Kowalski. Elle excelle à transformer une demande de mouvement en une implémentation prête pour la revue, en suivant une séquence de décisions obligatoire : (1) l'élément mérite-t-il une animation ? (2) quel est son objectif ? (3) quel outil utiliser (transition CSS, animation CSS, WAAPI ou Motion) ? (4) quelles propriétés animer (transform/opacity uniquement) ? (5) quelle courbe d'assouplissement et durée (ou ressort) ? (6) comment gérer l'interruption et la sortie ? (7) comment intégrer le mouvement réduit et le filtrage au survol. Les règles strictes interdisent les valeurs approximatives, l'utilisation de tokens de durée ou d'assouplissement personnalisés en dehors de ceux définis dans la base de code, l'animation d'éléments déclenchés au clavier (100+ fois/jour), et l'utilisation d'`ease-in` sur des éléments d'interface. Le résultat est une animation prête pour la production, avec commentaire expliquant la décision, les ingrédients, et ce qui doit être vérifié manuellement. La compétence est destinée à des plateformes comme Claude Code, Cursor ou Codex, et son SKILL.md contient des recettes, des règles anti-patrons, et un guide complet pour construire des animations web de qualité.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/animate

Demander à votre IA préférée

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

Documentation

Construction d'animations

Ce dépôt (Asymmetric-al/core)

Utilisez cette compétence pour implémenter des animations web après les contrats de conception-ingénierie et de mouvement opérationnel de Core. Conciliez cette superposition après les mises à jour en amont avant d'exécuter bun run skills:sync.

Déclencheurs

  • Construire ou réécrire une animation web, une transition ou une micro-interaction.
  • Ne pas l'utiliser pour Expo/React Native (animate-expo), un audit de base de code (improve-animations), ou une revue strictement centrée sur le mouvement (review-animations).

Flux de travail

  1. Chargez d'abord docs/ai/skills/emil-design-engineering/SKILL.md et docs/ai/skills/anim/SKILL.md.
  2. Réutilisez les tokens de mouvement Core existants et les primitives Base UI. Ne créez pas de forks de durées, d'assouplissements, et n'introduisez pas d'API Radix.
  3. Gardez le mouvement réduit sur la ligne de base globale dans packages/ui/styles/globals.css.
  4. Si la tâche nécessite un toast, un tiroir, un menu ou une liste déroulante, réutilisez @asym/ui / Base UI. N'invoquez pas pick-ui-library sauf si l'utilisateur a explicitement demandé quelle bibliothèque utiliser.

Liste de vérification

  • L'animation a un objectif et reste sur transform/opacity lorsque c'est possible.
  • Les tokens Core, Base UI et anim priment sur les valeurs amont indicatives.
  • Les utilitaires partagés et @asym/lib/motion-presets sont préférés aux nouvelles valeurs littérales de temporisation.

Une compétence de construction. Elle fait UNE chose : transformer une demande de mouvement en une implémentation qui survivrait à une revue stricte. Elle n'audite pas une base de code (c'est improve-animations), ne critique pas un diff (c'est review-animations), ne cherche pas d'endroits qui pourraient animer (c'est find-animation-opportunities), et ne construit pas pour React Native (c'est animate-expo).

Posture opérationnelle

Vous êtes un ingénieur de conception senior qui construit l'animation vous-même. La référence est la philosophie d'animation d'Emil Kowalski — la même que review-animations applique. Écrivez-la pour qu'elle réussisse cette revue du premier coup.

Deux modes d'échec, et le premier est le pire :

  1. Animer quelque chose qui ne devrait pas être animé. La porte ci-dessous existe pour produire parfois zéro ligne de code. C'est un succès, pas une esquive.
  2. Animer la bonne chose avec les mauvais ingrédients — ease-in pour une entrée, scale(0), des keyframes sur un toast, une durée qui rend une liste déroulante lente.

Ne présentez jamais d'options de mouvement comme un menu. Prenez la décision, énoncez le raisonnement en une ligne, écrivez le code.

Règles strictes

  1. Exécutez la séquence dans l'ordre. Les étapes 1 et 2 filtrent tout. Ne cherchez pas une courbe avant de savoir si cela anime ou non.
  2. Pas de valeurs approximatives. Chaque courbe, durée et configuration de ressort provient des tableaux ci-dessous. N'inventez jamais cubic-bezier(0.4, 0, 0.2, 1) parce que cela semble familier.
  3. Étendez les tokens de la base de code, ne les forkez pas. Si --ease-out-soft ou un token de durée existe déjà dans packages/ui/styles/globals.css, utilisez-le. Ajouter un système parallèle est un défaut.
  4. Le mouvement réduit et le filtrage au survol sont livrés avec l'animation, pas en tant que correctif ultérieur.
  5. L'outil le moins cher qui fonctionne. N'installez pas une bibliothèque de mouvement pour un fondu.

La séquence de construction

1. Cela devrait-il animer ?

FréquenceDécision
100+ fois/jour (raccourcis clavier, bascule de palette de commandes)Jamais d'animation. Arrêtez ici.
Des dizaines de fois/jour (effets de survol, navigation dans les listes)Quasi-imperceptible uniquement — rapide et subtil, ou rien
Occasionnel (modales, tiroirs, toasts)Animation standard
Rare / première fois (intégration, succès, célébration)Le budget de délice vit ici

Les actions initiées par le clavier sont un disqualifiant, pas un jugement à prendre. Raycast n'a pas d'animation d'ouverture/fermeture — c'est correct pour quelque chose d'ouvert des centaines de fois par jour.

Si la demande échoue à cette porte, dites-le clairement et n'écrivez pas l'animation. Proposez l'alternative sans mouvement (changement d'état instantané, un indice statique) à la place.

2. Quel est l'objectif ?

Nommez-le dans l'un de ces mots avant de continuer :

  • Retour — confirmer que l'interface a entendu l'utilisateur
  • Cohérence spatiale — montrer d'où quelque chose vient ou où il va
  • Indication d'état — rendre un changement d'état compréhensible
  • Prévention d'un changement brusque — faire le pont entre des contenus qui se téléporteraient autrement
  • Explication — démontrer comment quelque chose fonctionne (marketing/intégration uniquement)
  • Délice — autorisé uniquement pour le niveau rare/première fois

Vous ne pouvez pas le nommer ? Ne le construisez pas. « C'est cool » sur un élément fréquemment vu est une raison de s'arrêter.

Vérifiez aussi la fonction : les données que l'utilisateur lit ou sur lesquelles il agit ne doivent pas bouger pour le style. Un effet de suivi de souris décoratif appartient à une page marketing, pas à un graphique dans une application bancaire.

3. Choisissez l'outil — le moins cher qui fonctionne

Descendez ; arrêtez-vous au premier qui correspond.

BesoinOutil
Survol, pression, couleur, une bascule d'état que vous contrôlez avec une classe ou un attributTransition CSS
Animation d'entrée au montage, pas d'état JSCSS @starting-style
Mouvement prédéterminé qui doit rester fluide pendant que la page chargeAnimation CSS (s'exécute hors du thread principal)
Contrôle programmatique avec performances CSS, sans bibliothèqueWAAPI (element.animate())
Ressorts, animations de disposition, animations de sortie, valeurs pilotées par gestesMotion (motion.dev)

Les animations CSS battent JS sous charge — elles s'exécutent hors du thread principal, tandis que les animations basées sur requestAnimationFrame perdent des images pendant que le navigateur charge, exécute des scripts ou peint. Utilisez CSS pour le mouvement prédéterminé, JS pour le mouvement dynamique et interruptible.

Si la tâche nécessite un composant plutôt qu'une animation — un toast, un tiroir, un menu de commandes, une liste déroulante — réutilisez @asym/ui et Base UI. N'invoquez pas pick-ui-library sauf si l'utilisateur a explicitement demandé quelle bibliothèque utiliser. Faire ces choses à la main, c'est ainsi que vous vous retrouvez avec une liste déroulante <div> et aucune gestion de focus.

4. Choisissez les propriétés

  • transform et opacity uniquement. Ils sautent la mise en page et la peinture, et s'exécutent sur le GPU. width/height/margin/padding/top/left déclenchent les trois. (clip-path est le quatrième sanctionné — voir RECIPES.md. height est toléré uniquement pour les accordéons, où il n'y a pas d'équivalent transform.)
  • Jamais scale(0). Partez de scale(0.9–0.97) + opacity: 0. Rien dans le monde réel n'apparaît de rien.
  • transform-origin au déclencheur pour les popovers, listes déroulantes, menus, infobulles — var(--transform-origin) dans Base UI. Les modales sont exemptées ; elles ne sont pas ancrées à un déclencheur, donc elles restent centrées.
  • Les pourcentages dans translate() sont relatifs à la taille de l'élément lui-même — translateY(100%) se déplace de sa propre hauteur quel que soit le contenu. Privilégiez-les par rapport aux pixels codés en dur.
  • Dans Motion, x, y, et scale sont des transformations indépendantes prises en charge. Ils sont performants. Utilisez une chaîne transform complète uniquement lorsque l'animation doit rester sur le compositeur pendant que le thread principal est occupé :
<motion.div animate={{ x: 100 }} />
<motion.div animate={{ transform: "translateX(100px)" }} />
  • Ne pilotez jamais la transformation d'un enfant à partir d'une variable CSS sur le parent — cela recalcule les styles pour chaque enfant. Définissez transform directement sur l'élément.

5. Assouplissement et durée — ou un ressort

Assouplissement, dans l'ordre de décision :

SituationAssouplissement
Entrée ou sortieease-out
Déplacement / transformation à l'écranease-in-out
Survol / changement de couleurease
Mouvement constant (marquise, progression)linear
Par défautease-out

Jamais ease-in sur l'interface utilisateur. Il commence lentement, retardant le moment exact que l'utilisateur regarde. ease-out à 200ms semble plus rapide que ease-in à 200ms.

Les assouplissements CSS intégrés sont trop faibles. Utilisez ceux-ci :

--ease-out-soft: cubic-bezier(
  0.22,
  1,
  0.36,
  1
); /* Token Core; assouplissement fort pour l'interface */
--ease-in-out-soft: cubic-bezier(
  0.77,
  0,
  0.175,
  1
); /* assouplissement fort pour le mouvement à l'écran */
--ease-drawer: cubic-bezier(
  0.32,
  0.72,
  0,
  1
); /* Courbe de tiroir à la iOS (Ionic) */

Besoin d'une courbe qui n'est pas ici ? Prenez-la sur easing.dev ou easings.co. Ne la fabriquez pas à la main.

Durée :

ÉlémentDurée
Retour de pression de boutonvar(--duration-press) (120ms)
Infobulles, petits popoversvar(--duration-micro) (150ms)
Listes déroulantes, sélecteursvar(--duration-standard) (220ms)
Modalesvar(--duration-modal) (220ms)
Tiroirsvar(--duration-drawer) (320ms)
Marketing / explicatifPeut être plus long

Les animations d'interface restent en dessous de 300ms. Une liste déroulante de 180ms semble plus réactive qu'une de 400ms.

Utilisez un ressort à la place lorsque le mouvement est un glissement avec inertie, un élément qui doit sembler vivant, un geste que l'utilisateur peut interrompre ou inverser, ou un suivi de souris décoratif :

{ type: "spring", duration: 0.5, bounce: 0.2 }        // Style Apple — plus facile à raisonner
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }  // Physique traditionnelle — plus de contrôle

Gardez le rebond entre 0,1 et 0,3, et évitez le rebond dans la plupart des interfaces — réservez-le pour le glissement pour rejeter et les interactions ludiques.

6. Interruption et sortie

  • Transitions, pas de keyframes, pour tout ce qui est déclenché rapidement — toasts, bascules, tout ce qu'un utilisateur peut déclencher deux fois par seconde. Les transitions reciblent à partir de la valeur actuelle ; les keyframes redémarrent à zéro.
  • Ressorts pour les gestes, car ils transportent la vélocité à travers une interruption.
  • Sortez comme vous êtes entré. Un toast qui glisse depuis le bas part par le bas. Les chemins symétriques sont ce qui rend le glissement pour rejeter évident.
  • Temporisation asymétrique là où l'utilisateur décide. Lent sur la phase délibérée (une pression maintenir pour confirmer : 2s linéaire), rapide sur la réponse système (relâchement : 200ms ease-out).

7. Mouvement réduit et filtrage du pointeur

Livré avec l'animation, à chaque fois.

@media (prefers-reduced-motion: reduce) {
  .element {
    animation: fade 0.2s ease;
  } /* gardez opacity/color, supprimez le mouvement basé sur transform */
}

@media (hover: hover) and (pointer: fine) {
  .element:hover {
    transform: scale(1.05);
  } /* le tactile déclenche de faux survols au toucher */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : "-100%";

Le mouvement réduit signifie moins et plus douces animations, pas zéro — gardez les transitions qui aident à la compréhension, supprimez les changements de mouvement et de position.

Recettes

Pour des implémentations prêtes à construire des cas courants — pression de bouton, liste déroulante, infobulle, modale, tiroir, toast, accordéon, décalage, maintenir pour confirmer, indicateur d'onglet, défilement révélé, glisser pour rejeter — voir RECIPES.md. Chargez-le chaque fois que la demande correspond à l'un de ces composants ; partez de la recette plutôt que d'un fichier vierge.

Ne jamais livrer

Auto-vérification avant de terminer. Chacun de ces éléments est un blocage automatique dans review-animations :

JamaisPlutôt
transition: allNommez les propriétés exactes
transform: scale(0) entréescale(0.95) + opacity: 0
ease-in sur un élément d'interfaceease-out ou une courbe personnalisée forte
ease-out intégré sur une animation délibéréecubic-bezier(0.23, 1, 0.32, 1)
Animation sur un raccourci clavier ou une action 100+/jourPas d'animation
Durée d'interface au-dessus de 300ms sans raison150–250ms
transform-origin: center sur un popover ancré au déclencheurvar(--transform-origin) (modales exemptées)
Keyframes sur des toasts, bascules, éléments déclenchés rapidementTransitions CSS
Animer width/height/margin/padding/top/lefttransform / opacity
Props x/y/scale de Motion sous chargeChaîne transform complète
Mouvement :hover non filtré@media (hover: hover) and (pointer: fine)
prefers-reduced-motion manquantVariante plus douce, pas zéro
Tout entrer en même tempsDécalage de 30–80ms

Résultat

Écrivez le code. Ensuite, en quelques lignes maximum :

  • Le résultat de la porte — niveau de fréquence et objectif nommé. Si quelque chose dans la demande a été rejeté, dites quoi et pourquoi.
  • Les ingrédients — outil, propriétés, courbe, durée ou configuration de ressort, en une ligne chacun.
  • Que vérifier manuellement — si le résultat dépend d'une sensation que vous ne pouvez pas juger à partir du code (un fondu enchaîné, le rebond d'un ressort, l'équilibre opacité/hauteur dans une liste entrante), dites-le et pointez vers la vérification : jouez-le à 2–5× la durée ou dans l'inspecteur d'animations DevTools, parcourez-le image par image, testez les gestes sur un vrai appareil, et regardez à nouveau le

Individual skills in this repo

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

Asymmetric-al/core

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

Asymmetric-al/core

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Skills associés