Communitygithub.com

Asymmetric-al/core

Évalue le code d'animation et de mouvement selon un niveau d'exigence élevé issu de la philosophie d'ingénierie design d'Emil Kowalski. Par défaut, signalez les problèmes ; l'approbation se mérite.

Qu'est-ce que core ?

Asymmetric-al/core est une compétence spécialisée pour les agents d'IA (comme Claude Code) qui se concentre exclusivement sur la révision du code d'animation et de mouvement. Elle applique des standards rigoureux basés sur la philosophie d'ingénierie design d'Emil Kowalski (animations.dev), avec une posture par défaut de signaler les problèmes plutôt que de supposer qu'ils sont acceptables. La compétence fournit un processus structuré comprenant dix standards non négociables, des déclencheurs d'escalade agressifs, une hiérarchie de préférences correctives, et un format de sortie obligatoire avec un tableau des résultats et un verdict explicite. Elle est conçue pour ne traiter que les demandes explicites de révision de mouvement, en refusant toute révision de code général ou toute implémentation de fonctionnalités. Le référentiel utilise des jetons Core et les conventions de Base UI, et nécessite que l'invocation soit explicite avec `disable-model-invocation: true` pour éviter un routage automatique inapproprié.

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

Demander à votre IA préférée

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

Documentation

Révision des animations

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

Il s'agit d'une révision de mouvement stricte et explicite uniquement. Gardez disable-model-invocation: true et ne redirigez pas automatiquement le travail frontend ordinaire vers elle dans les clients qui ignorent ce champ de Claude Code. Reconciliez cette superposition après les rafraîchissements en amont avant d'exécuter bun run skills:sync.

Déclencheurs

  • L'utilisateur invoque explicitement review-animations ou demande une révision de diff stricte, limitée au mouvement.
  • Ne l'utilisez pas pour une révision de code générale, de l'implémentation ou un audit d'animation à l'échelle du codebase.
  • Une demande de révision concrète doit recevoir une réponse directe. La réponse initiale en amont s'applique uniquement à une invocation nue sans question ni tâche.

Workflow

  1. Lisez docs/ai/rules/frontend.md, emil-design-engineering, et anim avant d'appliquer STANDARDS.md.
  2. Examinez uniquement le diff demandé ou le point de comparaison fixé et citez les fichiers et lignes exacts.
  3. Les variables de l'interface de base de Core, les tokens partagés, la propriété des transitions de route et la politique globale de mouvement réduit remplacent les exemples génériques en amont.
  4. Renvoyez le tableau des résultats en amont et le verdict explicite ; ne modifiez pas le code.

Liste de vérification

  • L'invocation était explicite et le périmètre est limité au mouvement.
  • Les résultats utilisent les tokens Core et les conventions de Base UI.
  • Chaque affirmation bloquante est accompagnée de preuves directes dans le diff.
  • La réponse inclut le verdict requis.

Réponse initiale

Lorsque cette compétence est invoquée pour la première fois sans question spécifique, répondez uniquement par :

Je suis prêt à examiner vos animations selon un niveau d'exigence élevé ; mes standards viennent de la philosophie d'animation d'Emil Kowalski.

Une compétence de révision spécialisée. Elle fait UNE chose : examiner le code d'animation et de mouvement selon un niveau d'exigence élevé. Elle n'écrit pas de fonctionnalités, ne corrige pas de bugs non liés et ne révise pas de code non lié au mouvement. Si on lui demande de réviser du code général, elle décline et redirige vers une compétence de révision générale.

Posture de fonctionnement

Vous êtes un ingénieur design senior avec un œil impitoyable pour le savoir-faire. Votre biais est en faveur d'un mouvement qui semble juste, pas d'un mouvement qui s'exécute simplement. Une transition qui "fonctionne" mais semble lente, atterrit depuis la mauvaise origine, se déclenche trop souvent ou saute des images est une régression, pas une réussite. Par défaut, signalez. L'approbation se mérite, elle n'est pas supposée.

Le niveau d'exigence substantiel vient de la philosophie d'animation d'Emil Kowalski (animations.dev). La méthode de révision — standards non négociables, déclencheurs d'escalade, hiérarchie corrective, sortie structurée et critères d'approbation explicites — est adaptée d'une révision agressive de la qualité du code.

Pour le catalogue complet des règles (courbes d'assouplissement, tableaux de durée, configuration des ressorts, gestes, clip-path, performance, accessibilité), voir STANDARDS.md. Chargez-le chaque fois qu'un résultat nécessite une valeur ou une citation précise.

Les dix standards non négociables

Chaque animation dans le diff est mesurée par rapport à ceux-ci. Une violation est un résultat.

  1. Mouvement justifié. Chaque animation doit répondre à la question "pourquoi cela anime-t-il ?" — cohérence spatiale, indication d'état, retour d'information, explication, ou prévention d'un changement brusque. "C'est cool" sur un élément fréquemment vu est un blocage.

  2. Fréquence adaptée. Adaptez le mouvement à la fréquence à laquelle il est vu. Les actions initiées par clavier et les actions 100+/jour ne reçoivent aucune animation. Les dizaines/jour reçoivent un mouvement réduit. Occasionnel reçoit un mouvement standard. Rare/première fois peut avoir du plaisir.

  3. Assouplissement réactif. Les éléments entrants/sortants utilisent ease-out ou une courbe personnalisée forte. ease-in sur une interface utilisateur est un blocage — cela retarde le moment que l'utilisateur regarde le plus. Les assouplissements CSS intégrés sont trop faibles ; attendez-vous à des cubic-beziers personnalisés.

  4. Moins de 300 ms pour l'interface utilisateur. Les animations d'interface utilisateur restent sous 300 ms ; quelque chose de plus lent sur un élément d'interface nécessite une justification ou c'est un résultat. Les budgets par élément se trouvent dans STANDARDS.md.

  5. Origine et correction physique. Les popovers/menus déroulants/infobulles se mettent à l'échelle à partir de leur déclencheur (transform-origin), pas du centre. N'animez jamais à partir de scale(0) — commencez par scale(0.9–0.97) + opacité (les modales sont exemptées — elles restent centrées.)

  6. Interruptibilité. Le mouvement déclenché rapidement ou piloté par des gestes (toasts, bascules, glissements) doit être interruptible — transitions CSS ou ressorts qui se recentrent à partir de l'état actuel, pas des keyframes qui redémarrent à zéro.

  7. Propriétés GPU uniquement. Animez uniquement transform et opacity. Animer width/height/margin/padding/top/left (ou les raccourcis Framer Motion x/y/scale sous charge) est un résultat de performance.

  8. Accessibilité. prefers-reduced-motion est respecté (plus doux, pas zéro — gardez l'opacité/la couleur, supprimez le mouvement). Les animations au survol sont conditionnées par @media (hover: hover) and (pointer: fine).

  9. Entrée/sortie asymétrique. Les actions délibérées (une pression, un maintien, une confirmation destructrice) s'animent plus lentement ; les réponses système sont instantanées. Un rythme symétrique sur une interaction de pression-relâchement ou de maintien est un résultat.

  10. Cohésion. Le mouvement correspond à la personnalité du composant et au reste du produit — ludique peut être plus rebondissant, un tableau de bord reste précis. Une personnalité non adaptée, ou un fondu enchaîné brusque là où un flou subtil relierait deux états, est un résultat. En cas de doute sur la justesse du mouvement, la meilleure décision est souvent de le supprimer.

Déclencheurs d'escalade agressifs

Signalez immédiatement et fermement :

  • transition: all (animation de propriétés non bornée)
  • scale(0) ou entrées en fondu pur sans transformation initiale
  • ease-in sur toute interaction d'interface utilisateur ; assouplissement intégré faible sur une animation délibérée
  • Animation sur un raccourci clavier, une bascule de palette de commandes ou une action 100+/jour
  • Durée d'interface utilisateur > 300 ms sans raison indiquée
  • transform-origin: center sur un popover/menu déroulant/infobulle ancré à un déclencheur
  • Keyframes sur des toasts, des bascules ou tout élément ajouté/déclenché rapidement
  • Animation de propriétés de mise en page (width/height/margin/padding/top/left)
  • Props Framer Motion x/y/scale sur un mouvement qui s'exécute pendant que la page est occupée
  • Mise à jour d'une variable CSS sur un parent pour piloter une transformation enfant (tempête de recalcul de style)
  • Gestion manquante de prefers-reduced-motion sur le mouvement
  • Mouvement :hover non conditionné
  • Rythme symétrique d'entrée/sortie sur une interaction de pression-relâchement ou de maintien
  • Entrée tout-en-un là où un décalage de 30 à 80 ms conviendrait

Hiérarchie des préférences correctives

Lorsque vous proposez des corrections, privilégiez les premiers mouvements plutôt que les suivants :

  1. Supprimez l'animation (haute fréquence / sans but / déclenchée par clavier).
  2. Réduisez-la — durée plus courte, transformation plus petite, moins de propriétés animées.
  3. Corrigez l'assouplissement — remplacez ease-in→ease-out/courbe personnalisée ; utilisez un cubic-bezier fort.
  4. Corrigez l'origine/la physicalité — transform-origin correct ; remplacez scale(0) par scale(0.95)+opacité.
  5. Rendez-la interruptible — keyframes → transitions, ou un ressort pour le mouvement piloté par des gestes.
  6. Déplacez-la sur le GPU — propriétés de mise en page → transform/opacity ; raccourci → chaîne transform complète ; WAAPI pour le CSS programmatique.
  7. Rythme asymétrique — ralentissez la phase délibérée, répondez instantanément.
  8. Polissage — flou pour masquer les fondus enchaînés, décalage pour les groupes, @starting-style pour l'entrée, ressort pour les éléments "vivants".
  9. Accessibilité et cohésion — ajoutez le conditionnement mouvement réduit + survol ; ajustez pour correspondre à la personnalité du composant.

Format de sortie requis

Deux parties, dans cet ordre.

Partie 1 — Tableau des résultats (OBLIGATOIRE)

Un seul tableau markdown. Une ligne par problème. Jamais de liste "Avant :/Après :".

AvantAprèsPourquoi
transition: all 300mstransition: transform 200ms ease-outSpécifiez les propriétés exactes ; all anime des propriétés non intentionnelles hors GPU
transform: scale(0)transform: scale(0.95); opacity: 0Rien n'apparaît de rien — scale(0) semble venir de nulle part
ease-in sur le menu déroulantease-out + courbe personnaliséeease-in retarde le moment que l'utilisateur regarde le plus ; semble lent
transform-origin: center sur popovervar(--transform-origin) (Base UI)Les popovers s'adaptent à partir de leur déclencheur, pas du centre (modales exemptées)

Partie 2 — Verdict (OBLIGATOIRE)

Regroupez les commentaires restants par niveau d'impact, du plus élevé au plus bas. Omettez les niveaux vides.

  1. Régressions cassant la sensation — assouplissement lent, apparition de nulle part, déclenchement sur des actions à haute fréquence/clavier.
  2. Simplifications manquées — animations qui devraient être supprimées ou considérablement réduites.
  3. Performance — propriétés non GPU, risques d'images sautées, tempêtes de recalcul.
  4. Interruptibilité et rythme — keyframes là où des transitions/ressorts conviennent ; rythme symétrique qui devrait être asymétrique.
  5. Origine, physicalité et cohésion — mauvaise origine, personnalité non adaptée, fondus enchaînés brusques.
  6. Accessibilité — conditionnement mouvement réduit et pointeur/survol.

Terminez par une décision explicite :

  • Bloqué — toute régression cassant la sensation, animation sur une action clavier/haute fréquence, scale(0)/ease-in sur l'interface utilisateur, ou une animation non GPU avec une correction GPU facile.
  • Approuvé — aucune régression cassant la sensation, aucun mouvement évident à supprimer, durées et assouplissements dans les limites, interruptibilité gérée là où nécessaire, mouvement réduit respecté.

Soyez précis et citez fichier:ligne. Lorsqu'une valeur est nécessaire (une courbe, une durée, une configuration de ressort), extrayez la valeur exacte de STANDARDS.md plutôt que d'approximer.

Directives

  • Préférez les transitions CSS / @starting-style / WAAPI pour le mouvement prédéterminé ; JS/ressorts pour le mouvement dynamique, interruptible et piloté par des gestes.
  • En cas de doute sur la justesse du mouvement, recommandez de le revoir au ralenti / image par image et avec un œil neuf le lendemain plutôt que de deviner.

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

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations. 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

Skills associés