Communitygithub.com

CharbelElBateh/personal-website

Glossaire de recherche inversée qui transforme une description vague d'un effet d'animation web en son terme exact. Utilisez-le lorsque l'utilisateur demande « comment ça s'appelle quand… » ou décrit un effet sans connaître son nom.

Qu'est-ce que personal-website ?

Ce skill transforme une description vague d'un effet d'animation ou de mouvement web (par exemple « le truc qui rebondit quand un popup s'ouvre ») en son terme technique précis (par exemple « Pop in »). Il est conçu pour être utilisé lorsque l'utilisateur demande « comment ça s'appelle quand… » ou décrit un effet sans en connaître le nom, et souhaite obtenir le mot juste pour interagir avec une IA ou un designer. Le skill ne conçoit ni ne construit les effets ; il se limite à les nommer. Le skill s'appuie sur un glossaire complet organisé par catégories (entrées/sorties, séquencement, mouvements, transitions, défilement, feedback, easing, ressorts, boucles, effets de finition, performance, principes). Il répond avec le terme le plus proche, sa description, et éventuellement des alternatives proches avec des notes de différenciation. Les instructions insistent sur la lecture de l'intention plutôt que des mots-clés (« ressors », « glisse », « se dessine »), la citation textuelle du glossaire, la désambiguïsation des termes proches, et la concision (le nom d'abord, les détails seulement si demandé). Les plateformes supportées incluent tous les environnements où un agent IA peut être invoqué (Claude Code, Cursor, Codex, etc.). Le skill est invoqué explicitement ou implicitement lorsque l'utilisateur décrit un effet de mouvement sans le nommer, soit via une question directe, soit via une description dans le flux de la conversation.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/animation-vocabulary

Demander à votre IA préférée

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

Documentation

Vocabulaire d'Animation

Réponse Initiale

Lorsque ce skill est invoqué pour la première fois sans question spécifique, répondez uniquement par :

Je suis prêt à donner un nom à tout effet de mouvement que tu décris, ma connaissance provient de la philosophie d'animation d'Emil Kowalski.

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

Transformez une description vague d'un mouvement ou effet en le terme précis, afin que l'utilisateur sache quoi demander.

Démarrage Rapide

L'utilisateur décrit un effet de manière approximative. Vous retournez le(s) terme(s) correspondant(s) dans ce format :

**Stagger** — Animer plusieurs éléments l'un après l'autre avec un petit délai entre chacun, créant une cascade.

Si plusieurs termes conviennent, listez d'abord la meilleure correspondance, puis 1 à 2 alternatives avec une note d'une ligne sur leur différence.

Instructions

  1. Lisez l'intention, pas les mots-clés. Les utilisateurs décrivent ce qu'ils voient ou ressentent (« élastique », « glisse », « se dessine tout seul »), pas le nom technique. Faites correspondre la sensation au glossaire ci-dessous.
  2. Citez le glossaire textuellement. Ses descriptions sont faisant autorité — utilisez-les telles quelles, ne paraphrasez pas.
  3. Désambiguïsez les termes proches. Quand deux se concurrencent (Clip-path vs Masque, Pop in vs Rebond, Transition d'élément partagé vs Animation de mise en page), opposez-les pour que l'utilisateur puisse choisir.
  4. Quand rien ne correspond exactement, nommez le terme le plus proche et dites clairement que c'est une approximation, ou décrivez l'effet avec le vocabulaire du glossaire (par ex. « c'est un stagger d'entrées scale-in »).
  5. Restez dans ce glossaire. Si un terme n'y figure vraiment pas, dites-le plutôt que d'en inventer un — vous pouvez expliquer le concept en utilisant ces mots.
  6. Restez concis. Une question de nommage veut un nom, pas un essai. Commencez par le terme ; développez seulement si demandé.

Exemples

Exemple 1 — basé sur la sensation Utilisateur : « Comment ça s'appelle quand un popup semble sortir du bouton sur lequel tu as cliqué au lieu de son milieu ? » Sortie :

**Animation sensible à l'origine** — Un élément s'anime à partir de son déclencheur, comme un popup qui grandit depuis le bouton qui l'a ouvert au lieu de son propre centre qui est le défaut en CSS.

Exemple 2 — désambiguïsation Utilisateur : « Le truc où une image se transforme en une autre image. » Sortie :

**Morph** — Une forme se transforme doucement en une autre forme, ex. Dynamic Island.

Alternatives proches :
- **Crossfade** — si elles se fondent simplement l'une dans l'autre au même endroit.
- **Transition d'élément partagé** — si un élément se déplace et se transforme d'une position à une autre.

Exemple 3 — sensation physique Utilisateur : « Ce scroll iOS qui résiste et revient en arrière quand tu tires trop loin. » Sortie :

**Rubber-banding** — Résistance et retour élastique quand on dépasse une limite (la sensation de dépassement iOS).

Glossaire

Un instantané organisé reflétant la page /vocabulary du projet ; gardez les deux synchronisés si l'un change.

Entrées & Sorties — comment les éléments apparaissent et disparaissent

  • Fade in / Fade out — L'élément apparaît ou disparaît en changeant d'opacité.
  • Slide in — L'élément entre en glissant depuis l'extérieur de l'écran (gauche, droite, haut ou bas).
  • Scale in — L'élément grandit depuis une taille plus petite jusqu'à sa taille réelle en apparaissant, souvent associé à un fade.
  • Pop in — L'élément apparaît avec un léger dépassement, comme s'il rebondissait en place.
  • Reveal — Le contenu est découvert progressivement, souvent en animant un clip-path ou un masque.
  • Enter / Exit — L'animation qu'un élément joue lorsqu'il est ajouté ou retiré de l'écran.

Séquençage & Timing — coordonner plusieurs éléments ou moments

  • Keyframes — Points définis dans une animation (0%, 50%, 100%) que le navigateur remplit entre eux.
  • Interpolation / Tween — Générer toutes les images intermédiaires entre une valeur de début et de fin, pour que le mouvement soit continu.
  • Stagger — Animer plusieurs éléments l'un après l'autre avec un petit délai entre chacun, créant une cascade.
  • Orchestration — Chronométrer délibérément plusieurs animations pour qu'elles donnent l'impression d'un mouvement coordonné.
  • Delay — Temps avant qu'une animation commence.
  • Duration — Combien de temps dure une animation.
  • Fill mode — Si un élément conserve les styles de sa première ou dernière image avant le début ou après la fin de l'animation (ex. forwards).
  • Stepped animation — Une animation divisée en étapes discrètes, comme un compte à rebours.

Mouvement & Transformations — changer la position, la taille ou l'angle d'un élément

  • Translate — Déplacer un élément le long de l'axe X ou Y.
  • Scale — Agrandir ou rétrécir un élément.
  • Rotate — Faire tourner un élément autour d'un point.
  • Skew — Incliner un élément le long de l'axe X ou Y, le déformant hors de sa forme rectangulaire.
  • 3D tilt / Flip — Rotation dans l'espace 3D (rotateX / rotateY) pour ajouter de la profondeur.
  • Perspective — À quel point l'effet 3D semble fort — une valeur faible exagère la profondeur, comme si le spectateur était plus proche.
  • Transform origin — Le point d'ancrage à partir duquel une scale ou rotation grandit ou tourne.
  • Animation sensible à l'origine — Un élément s'anime à partir de son déclencheur, comme un popup qui grandit depuis le bouton qui l'a ouvert au lieu de son propre centre qui est le défaut en CSS.

Transitions Entre États — connecter un état, une vue ou un élément à un autre

  • Crossfade — Un élément disparaît tandis qu'un autre apparaît au même endroit.
  • Transition de continuité — Un changement qui maintient l'orientation de l'utilisateur en connectant visuellement l'avant et l'après. Par exemple, agrandir et rétrécir le même rectangle.
  • Morph — Une forme se transforme doucement en une autre forme, ex. Dynamic Island.
  • Transition d'élément partagé — Un élément se déplace et se transforme d'une position à une autre, comme une vignette qui s'agrandit en carte.
  • Animation de mise en page — Quand la taille ou la position d'un élément change, il s'anime vers le nouvel endroit au lieu de sauter.
  • Accordéon / Collapse — Une section se déploie et se replie doucement en hauteur pour afficher ou masquer du contenu.
  • Transition sensible à la direction — Le contenu glisse dans un sens en avançant et dans le sens opposé en revenant, donnant une sensation de direction à la navigation.

Défilement — mouvement lié au scroll ou à la navigation entre vues

  • Scroll reveal — Les éléments apparaissent ou glissent en place lorsqu'ils entrent dans le viewport.
  • Animation pilotée par le scroll — Une animation dont la progression est directement liée à la position de défilement.
  • Parallaxe — L'arrière-plan et le premier plan bougent à des vitesses différentes pendant le défilement, créant de la profondeur.
  • Transition de page — Une animation jouée lors de la navigation d'une page ou route à une autre.
  • Transition de vue — Le navigateur morphing entre deux états ou pages, connectant les éléments partagés.

Feedback & Interaction — répondre aux actions de l'utilisateur

  • Hover effect — Changement visuel lorsque le curseur passe sur un élément.
  • Press / Tap feedback — Un léger scale-down lorsqu'un élément est cliqué, pour qu'il paraisse physique.
  • Hold to confirm — Un effet de progression qui se remplit pendant que l'utilisateur maintient un bouton enfoncé.
  • Drag — Déplacer un élément en l'attrapant, souvent avec de l'inertie au relâchement.
  • Drag to reorder — Glisser des éléments dans une liste pour les réorganiser, tandis que les autres se décalent pour faire de la place.
  • Swipe to dismiss — Glisser un élément hors de l'écran pour le fermer, comme un tiroir ou un toast.
  • Rubber-banding — Résistance et retour élastique quand on dépasse une limite (la sensation de dépassement iOS).
  • Shake / Wiggle — Un tremblement rapide latéral signalant une erreur ou une entrée rejetée.
  • Ripple — Un cercle qui s'étend depuis le point d'un toucher, confirmant l'appui.

Easing — comment la vitesse change au cours d'une animation

  • Easing — Le taux auquel une animation accélère ou ralentit.
  • Ease-out — Commence vite, finit lentement. Le défaut pour la plupart des UI et tout ce qui répond à l'utilisateur.
  • Ease-in — Commence lentement, finit vite. Généralement évité ; peut sembler lent.
  • Ease-in-out — Lent, vite, lent. Bon pour les éléments déjà à l'écran se déplaçant de A à B.
  • Linear — Vitesse constante. À éviter pour l'UI ; réservé aux spinners ou marquees.
  • Cubic-bezier — Une courbe d'easing personnalisée que vous définissez pour un contrôle précis.
  • Easing asymétrique — Une courbe qui accélère et décélère à des rythmes différents. Semble plus vivant qu'un symétrique.

Animations Ressort — mouvement basé sur la physique comme alternative à l'easing à durée fixe

  • Spring — Mouvement piloté par la physique (tension, masse, amortissement) plutôt qu'une durée définie.
  • Stiffness / Tension — La force avec laquelle le ressort tire vers sa cible. Plus élevé donne une sensation plus rapide.
  • Damping — La rapidité avec laquelle un ressort se stabilise. Un amortissement plus faible signifie plus de rebond et d'oscillation.
  • Masse — Le poids ressenti de l'élément animé. Plus de masse le rend plus lent et plus lourd.
  • Bounce — Un ressort qui dépasse et se stabilise, ajoutant du jeu.
  • Durée perceptuelle — Combien de temps un ressort semble terminé, même s'il continue de micro-s'ajuster en dessous.
  • Momentum — Mouvement qui porte la vélocité, surtout après un drag ou une interruption.
  • Vélocité — La vitesse et la direction d'un élément. Un ressort la porte dans l'animation suivante si interrompu, donc un élément effleuré conserve sa vitesse.
  • Animation interruptible — Une animation qui peut être redirigée en douceur en plein vol au lieu de finir d'abord.

Boucles & Mouvement Ambiant — animations qui tournent toutes seules

  • Marquee — Texte ou contenu qui défile en continu en boucle.
  • Loop — Une animation qui se répète, un nombre défini de fois ou à l'infini.
  • Alternate (yoyo) — Une boucle qui joue en avant puis inverse à chaque itération, au lieu de revenir au début.
  • Orbit — Un élément tournant autour d'un autre sur un chemin continu.
  • Pulse — Un changement doux et répété d'échelle ou d'opacité pour attirer l'attention.
  • Float — Une dérive douce et continue de haut en bas qui donne à un élément statique une sensation de vie et d'apesanteur.
  • Idle animation — Mouvement subtil qui se joue pendant qu'un élément est juste posé là, attendant d'être interagi.

Finitions & Effets — les petites touches qui séparent le bon du grand

  • Blur — Un filtre de flou utilisé pour adoucir un élément ou masquer de petites imperfections.
  • Clip-path — Découper un élément selon une forme, utilisé pour les reveals, masques et curseurs avant/après.
  • Masque — Cacher ou révéler des parties d'un élément en utilisant une forme ou un dégradé — comme clip-path, mais avec des bords doux et fondus.
  • Curseur avant / après — Un séparateur déplaçable qui efface entre deux images superposées pour les comparer.
  • Line drawing — Un chemin SVG qui se dessine tout seul, comme une plume invisible le traçant.
  • Text morph — Texte qui s'anime caractère par caractère quand il change, attirant l'attention sur la nouvelle valeur.
  • Skeleton / Shimmer — Un espace réservé avec un éclat mobile affiché pendant le chargement du contenu.
  • Compteur numérique — Chiffres qui défilent ou comptent jusqu'à une valeur.
  • Chiffres tabulaires — Chiffres à largeur fixe pour qu'ils ne bougent pas en changeant. Essentiel pour les tickers, minuteurs et compteurs.
  • Machine à écrire — Texte apparaissant un caractère à la fois, comme s'il était tapé.

Performance — ce qui garde le mouvement fluide au lieu de saccader

  • Frame rate (FPS) — Images dessinées par seconde. 60ips est la base pour un mouvement fluide ; 120ips sur les écrans plus récents.
  • Jank — Saccade visible quand le navigateur laisse tomber des images parce qu'il n'arrive pas à suivre l'animation.
  • Dropped frame — Une image que le navigateur a manqué de dessiner à temps, causant un petit à-coup dans le mouvement.
  • Compositing — Laisser le GPU déplacer ou fondre un élément sur son propre calque sans refaire la mise en page ou le rendu.
  • will-change — Un indice CSS qu'un élément va bientôt être animé, pour que le navigateur le promeuve sur son propre calque à l'avance.
  • Layout thrashing — Animer des propriétés comme width, height, top ou left qui forcent le navigateur à recalculer la mise en page à chaque image, causant du jank.

Principes à Connaître — concepts qui guident quand et comment animer

  • Animation utile — Le mouvement doit servir une fonction — orienter, donner du feedback, montrer des relations — pas juste décorer.
  • Anticipation — Un petit élan dans la direction opposée avant un mouvement, suggérant ce qui va se passer.
  • Follow-through — Des parties d'un élément continuent de bouger et se stabilisent légèrement après l'arrêt du mouvement principal, ajoutant du poids.
  • Squash & stretch — Déformer un élément pendant qu'il bouge pour transmettre poids, vitesse et flexibilité.
  • Performance perçue — La bonne animation donne l'impression qu'une interface est plus rapide, même quand elle ne l'est pas.
  • Fréquence d'utilisation — Plus un utilisateur voit une animation souvent, plus elle doit être courte et subtile.
  • Cohérence spatiale — Animer pour qu'un élément conserve son identité et sa position à travers les états, pour que les utilisateurs ne perdent jamais la trace de ce qui s'est passé.
  • Accélération matérielle — Animer transform et opacity permet au GPU de garder le mouvement fluide.
  • Mouvement réduit — Respecter le paramètre prefers-reduced-motion de l'utilisateur en atténuant ou supprimant le mouvement.

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

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.

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