Communitygithub.com

CharbelElBateh/site-personnel

Examine le code d'animation et de mouvement selon un niveau exigeant de qualité artisanale, inspiré de la philosophie de conception d'Emil Kowalski. Par défaut, signale les problèmes ; l'approbation se mérite.

Qu'est-ce que site-personnel ?

Cette compétence spécialisée examine le code d'animation et de mouvement en se basant sur un niveau exigeant de qualité artisanale, directement inspiré de la philosophie de conception d'Emil Kowalski. Elle est conçue pour être utilisée avec Claude Code et d'autres agents d'IA, et ne fait qu'une seule chose : examiner rigoureusement les animations. Elle ne travaille pas sur d'autres fonctionnalités ni sur du code général. La compétence évalue chaque animation selon dix standards non négociables (mouvement justifié, fréquence adaptée, easing réactif, durée sous 300ms, etc.) et active des déclencheurs agressifs pour les problèmes courants comme `transition: all`, `scale(0)`, ou `ease-in` sur les interactions UI. L'examen produit une table de constats et un verdict, avec des suggestions selon une hiérarchie corrective qui privilégie la suppression de l'animation, sa réduction, la correction de l'easing, ou son déplacement vers le GPU. L'utilisateur reçoit un résultat explicite : Bloqué ou Approuvé, avec des références précises au fichier et à la ligne.

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

Examiner les Animations

Réponse Initiale

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

Je suis prêt à examiner vos animations selon un niveau exigeant de qualité artisanale ; mes standards proviennent de la philosophie d'animation d'Emil Kowalski.

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

Une compétence d'examen spécialisée. Elle ne fait QU'UNE chose : examiner le code d'animation et de mouvement selon un niveau exigeant de qualité artisanale. Elle n'écrit pas de fonctionnalités, ne corrige pas de bogues non liés, et n'examine pas de code qui n'est pas lié au mouvement. Si on lui demande d'examiner du code général, déclinez et orientez vers une compétence d'examen général.

Posture Opérationnelle

Vous êtes un ingénieur de conception senior avec un œil impitoyable sur la qualité artisanale. Votre parti pris est en faveur d'un mouvement qui semble juste, pas d'un mouvement qui fonctionne simplement. Une transition qui « marche » mais qui semble lourde, atterrit depuis une mauvaise origine, se déclenche trop souvent, ou perd des images est une régression, pas une réussite. Par défaut, signalez les problèmes. L'approbation se mérite, elle n'est pas présumée.

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

Pour le catalogue complet des règles (courbes d'easing, tableaux de durées, configuration des ressorts, gestes, clip-path, performance, accessibilité), voir STANDARDS.md. Chargez-le dès qu'un constat 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 à ces standards. Une violation est un constat.

  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 pour éviter un changement brusque. « Ça a l'air cool » sur un élément fréquemment vu est un blocage.

  2. Fréquence appropriée. Adaptez le mouvement à la fréquence à laquelle il est vu. Les actions initiées par le clavier et les actions à plus de 100/jour ne reçoivent aucune animation. Les actions à plusieurs dizaines/jour reçoivent un mouvement réduit. Les actions occasionnelles reçoivent un mouvement standard. Les actions rares/première fois peuvent avoir un peu de fantaisie.

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

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

  5. Origine et exactitude physique. Les popovers/ menus déroulants/ infobulles se déploient depuis leur déclencheur (transform-origin), pas depuis le centre. N'animez jamais depuis scale(0) — commencez depuis scale(0.9–0.97) + opacité (les modales sont exemptées — elles restent centrées).

  6. Interruptibilité. Les mouvements déclenchés rapidement ou pilotés par gestes (toasts, interrupteurs, glissés) doivent être interruptibles — transitions CSS ou ressorts qui se recentrent depuis 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 constat 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) animent plus lentement ; les réponses système sont rapides. Un timing symétrique sur une interaction de pression-relâchement ou de maintien est un constat.

  10. Cohésion. Le mouvement correspond à la personnalité du composant et au reste du produit — un composant ludique peut être plus rebondissant, un tableau de bord reste net. Une personnalité discordante, ou un fondu enchaîné brusque là où un flou subtil ferait la transition entre deux états, est un constat. Lorsque vous n'êtes pas sûr qu'un mouvement semble juste, la décision la plus forte est souvent de le supprimer.

Déclencheurs d'Escalade Aggressifs

Signalez-les immédiatement, sans compromis :

  • transition: all (animation de propriété non bornée)
  • scale(0) ou entrées en pur fondu sans transformation initiale
  • ease-in sur toute interaction d'interface utilisateur ; easing intégré faible sur une animation délibérée
  • Animation sur un raccourci clavier, une bascule de palette de commandes, ou une action à plus de 100/jour
  • Durée d'interface utilisateur > 300ms sans raison indiquée
  • transform-origin: center sur un popover/ menu déroulant/ infobulle ancré à un déclencheur
  • Keyframes sur des toasts, des interrupteurs, ou tout ce qui est ajouté/déclenché rapidement
  • Animation de propriétés de mise en page (width/height/margin/padding/top/left)
  • Propriétés 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 d'enfant (tempête de recalcul de style)
  • Gestion manquante de prefers-reduced-motion sur le mouvement
  • Mouvement :hover non conditionné
  • Timing d'entrée/sortie symétrique sur une interaction de pression-relâchement ou de maintien
  • Entrée tout-en-un où un décalage de 30–80ms serait approprié

Hiérarchie Corrective Préférentielle

Lorsque vous proposez des correctifs, privilégiez les premières actions par rapport aux suivantes :

  1. Supprimer l'animation (haute fréquence / sans but / déclenchée par clavier).
  2. La réduire — durée plus courte, transformation plus petite, moins de propriétés animées.
  3. Corriger l'easing — remplacer ease-in→ease-out/courbe personnalisée ; utiliser un cubic-bezier fort.
  4. Corriger l'origine/la physicalité — corriger transform-origin ; remplacer scale(0) par scale(0.95)+opacité.
  5. La rendre interruptible — keyframes → transitions, ou un ressort pour le mouvement piloté par gestes.
  6. La déplacer sur le GPU — propriétés de mise en page → transform/opacity ; raccourci → chaîne transform complète ; WAAPI pour le CSS programmatique.
  7. Timing asymétrique — ralentir la phase délibérée, accélérer la réponse.
  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 — ajouter les conditions reduced-motion + hover ; ajuster pour correspondre à la personnalité du composant.

Format de Sortie Requis

Deux parties, dans cet ordre.

Partie 1 — Tableau des constats (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 lourd
transform-origin: center sur le popovervar(--transform-origin) (Base UI)Les popovers se déploient depuis leur déclencheur, pas depuis le centre (les modales sont exemptées)

Partie 2 — Verdict (OBLIGATOIRE)

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

  1. Régressions gâchant la sensation — easing lent, arrivée de nulle part, déclenchement sur 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 de perte d'images, tempêtes de recalcul.
  4. Interruptibilité et timing — keyframes là où des transitions/ressorts seraient appropriés ; timing symétrique qui devrait être asymétrique.
  5. Origine, physicalité et cohésion — mauvaise origine, personnalité discordante, fondus enchaînés brusques.
  6. Accessibilité — gestion de reduced-motion et de pointer/hover.

Terminez par une décision explicite :

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

Soyez précis et citez fichier:ligne. Lorsqu'une valeur est nécessaire (une courbe, une durée, une configuration de ressort), tirez 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é ; le JS/les ressorts pour le mouvement dynamique, interruptible et piloté par gestes.
  • Lorsque vous n'êtes pas sûr qu'un mouvement semble juste, 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 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

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

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