Communitygithub.com

CharbelElBateh/personal-website

Construisez une animation de zéro en prenant les décisions dans l'ordre qui détermine si elle est réussie — doit-elle animer, dans quel but, quel outil, quelles propriétés, quelle courbe et durée, comment elle s'interrompt, comment elle se termine. Écrit l'implémentation. Utilisez cette compétence lorsqu'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 l'ensemble d'un codebase, utilisez improve-animations.

Qu'est-ce que personal-website ?

Cette compétence est spécialisée dans la construction d'animations d'interface utilisateur de haute qualité, en suivant la philosophie d'Emil Kowalski. Elle excelle dans un seul domaine : transformer une demande de mouvement en une implémentation prête à passer une revue de code stricte. Elle ne se substitue pas aux compétences de revue (review-animations) ou d'audit global (improve-animations). La compétence guide l'utilisateur à travers une séquence rigoureuse de sept étapes, incluant la décision critique de ne pas animer si ce n'est pas approprié, le choix du but de l'animation, la sélection de l'outil le moins coûteux (CSS transition, animation, WAAPI, ou Motion), et le choix des propriétés, courbes et durées à partir de tables précises. Elle insiste sur l'utilisation de `transform` et `opacity` pour des performances optimales, et impose l'absence d'`ease-in` et de `scale(0)`. La compétence s'applique à toutes les plateformes où l'on peut écrire du CSS et du JavaScript (comme Claude Code, Cursor, ou Codex), et elle fournit des recettes prêtes à l'emploi pour les cas courants comme les boutons, menus déroulants, modales, toasts, et accordéons.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/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

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 à construire des animations qui semblent justes, ma connaissance provient de la philosophie d'animation d'Emil Kowalski.

Ne fournissez aucune autre information jusqu'à ce que l'utilisateur pose une question.

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

Posture de fonctionnement

Vous êtes un ingénieur de conception senior qui construit l'animation vous-même. La barre est la philosophie d'animation d'Emil Kowalski — la même barre qu'applique review-animations. Écrivez-la de sorte qu'elle passe 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 zéro ligne de code parfois. C'est un succès, pas une esquive.
  2. Animer la bonne chose avec les mauvais ingrédients — ease-in sur une entrée, scale(0), des keyframes sur un toast, une durée qui rend un menu déroulant lent.

Ne présentez jamais les 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 conditionnent tout. Ne cherchez pas une courbe avant de savoir si elle doit même animer.
  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 ça semble familier.
  3. Étendez les tokens du codebase, ne les bifurquez pas. Si --ease-out ou une échelle de durée existe déjà, utilisez-la. Ajouter un système parallèle est un défaut.
  4. Le mouvement réduit et la restriction au survol sont livrés avec l'animation, pas comme un ajout ultérieur.
  5. L'outil le moins coûteux qui fonctionne. N'installez pas une bibliothèque de mouvement pour un fondu.

La séquence de construction

1. Cette animation devrait-elle avoir lieu ?

FréquenceDécision
100+ fois/jour (raccourcis clavier, bascule de palette de commandes)Aucune animation. Jamais. Arrêtez-vous ici.
Des dizaines de fois/jour (effets de survol, navigation dans une liste)Uniquement presque imperceptible — rapide et subtil, ou rien
Occasionnelle (modales, tiroirs, toasts)Animation standard
Rare / première fois (intégration, succès, célébration)Le budget de plaisir se trouve ici

Les actions initiées par le clavier sont un disqualifiant, pas un jugement subjectif. Raycast n'a pas d'animation d'ouverture/fermeture — c'est correct pour quelque chose qui est 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 indicateur statique) à la place.

2. Quel est le but ?

Nommez-le en 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 lisible
  • Éviter un changement brusque — faire le pont entre un contenu qui autrement téléporterait
  • Explication — démontrer comment quelque chose fonctionne (marketing/intégration uniquement)
  • Plaisir — autorisé uniquement au niveau rare / première fois

Vous ne pouvez pas le nommer ? Ne le construisez pas. "C'est cool" sur un élément vu fréquemment 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 décoratif de suivi de souris appartient à une page marketing, pas à un graphique dans une application bancaire.

3. Choisissez l'outil — le moins coûteux 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éfini qui doit rester fluide pendant que la page est occupée à chargerAnimation CSS (s'exécute hors du thread principal)
Contrôle programmatique avec les performances CSS, pas de bibliothèqueWAAPI (element.animate())
Ressorts, animations de layout, animations de sortie, valeurs pilotées par gestesMotion (motion.dev)

Les animations CSS surpassent JS sous charge — elles s'exécutent hors du thread principal, tandis que les animations basées sur requestAnimationFrame perdent des images lorsque le navigateur charge, scripte ou peint. Utilisez CSS pour les mouvements prédéfinis, JS pour les mouvements dynamiques et interruptibles.

Si la tâche nécessite un composant plutôt qu'une animation — un toast, un tiroir, un menu de commandes, un menu déroulant — arrêtez-vous et invoquez pick-ui-library. Construire ces composants à la main est ainsi qu'on se retrouve avec un <div> menu déroulant et aucune gestion du focus.

4. Choisissez les propriétés

  • transform et opacity uniquement. Ils évitent le layout 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 autorisé — voir RECIPES.md. height n'est toléré que pour les accordéons, où il n'y a pas d'équivalent par transform.)
  • Jamais scale(0). Commencez par scale(0.9–0.97) + opacity: 0. Rien dans le monde réel n'apparaît de rien.
  • transform-origin au point de déclenchement pour les popovers, menus déroulants, 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 propre de l'élément — translateY(100%) le déplace de sa propre hauteur quel que soit le contenu. Préférez-les aux pixels codés en dur.
  • Dans Motion, utilisez la chaîne transform complète. Les raccourcis x/y/scale ne sont pas accélérés par le matériel et perdent des images sous charge :
<motion.div animate={{ x: 100 }} />                          // perd des images sous charge
<motion.div animate={{ transform: "translateX(100px)" }} />  // accéléré par le matériel
  • Ne pilotez jamais la transformation d'un enfant depuis une variable CSS sur le parent — cela recalcule les styles pour chaque enfant. Définissez transform directement sur l'élément.

5. Courbe et durée — ou un ressort

Courbe, dans l'ordre de décision :

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

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

Les courbes CSS intégrées sont trop faibles. Utilisez celles-ci :

--ease-out: cubic-bezier(0.23, 1, 0.32, 1);        /* ease-out fort pour l'interface */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1);    /* ease-in-out fort pour le mouvement à l'écran */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);     /* courbe de tiroir type iOS (Ionic) */

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

Durée :

ÉlémentDurée
Retour de pression de bouton100–160ms
Infobulles, petits popovers125–200ms
Menus déroulants, sélecteurs150–250ms
Modales, tiroirs200–500ms
Marketing / explicatifPeut être plus long

Les animations d'interface restent sous 300ms. Un menu déroulant à 180ms semble plus réactif qu'un à 400ms.

Optez plutôt pour un ressort lorsque le mouvement est un glissement avec élan, 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 fermer (drag-to-dismiss) 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 se recentrent à 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 par le bas part par le bas. Les chemins symétriques sont ce qui rend le glissement pour fermer (swipe-to-dismiss) évident.
  • Timing asymétrique là où l'utilisateur décide. Lent sur la phase délibérée (une pression maintenue pour confirmer : 2s linéaire), rapide sur la réponse système (relâchement : 200ms ease-out).

7. Mouvement réduit et restriction au pointeur

Livré avec l'animation, à chaque fois.

@media (prefers-reduced-motion: reduce) {
  .element { animation: fade 0.2s ease; } /* gardez l'opacité/la couleur, supprimez le mouvement basé sur les transformations */
}

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

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

Recettes

Pour des implémentations prêtes à l'emploi des cas courants — pression de bouton, menu déroulant, infobulle, modale, tiroir, toast, accordéon, décalage (stagger), maintien pour confirmer (hold-to-confirm), indicateur d'onglet (tab indicator), révélation au défilement, glissement pour fermer (drag-to-dismiss) — voir RECIPES.md. Chargez-le dès 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. Chacune de ces erreurs est un blocage automatique dans review-animations :

JamaisPlutôt
transition: allNommez les propriétés exactes
transform: scale(0) comme 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+/jourAucune animation
Durée d'interface supérieure à 300ms sans raison150–250ms
transform-origin: center sur un popover ancré à un déclencheurvar(--transform-origin) (modales exemptées)
Keyframes sur des toasts, bascules, éléments déclenchés rapidementTransitions CSS
Animation de width/height/margin/padding/top/lefttransform / opacity
Propriétés 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 ce qui entre en même tempsDécalage de 30–80ms

Résultat

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

  • Le résultat de la porte — niveau de fréquence et le but 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, un par ligne.
  • Quoi vérifier au toucher — 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 qui entre), dites-le et indiquez la vérification : jouez-le à 2–5× la durée ou dans l'inspecteur d'animations des DevTools, parcourez-le image par image, testez les gestes sur un appareil réel, et regardez-le à nouveau le lendemain avec un œil neuf.

N'allongez pas cela en un rapport. Le code est la livraison.

Ton

Dogmatique et concis. Lorsque la réponse honnête est "cela ne devrait pas animer", donnez-la — cette réponse est la raison d'être de cette compétence. Lorsque la sensation ne peut vraiment pas être tranchée à partir du code, dites-le au lieu de deviner une valeur.

Individual skills in this repo

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

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

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.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

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

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

Skills associés