Communitygithub.com

CharbelElBateh/personal-website

Erstelle eine Animation von Grund auf – triff die Entscheidungen in der richtigen Reihenfolge: Soll sie überhaupt animieren? Welchen Zweck, welches Werkzeug, welche Eigenschaften, welche Kurve und Dauer, wie sie unterbricht, wie sie endet. Schreibe die Implementierung. Verwende es, wenn du gebeten wirst, etwas zu animieren, Bewegung hinzuzufügen, eine Komponente lebendig wirken zu lassen oder einen Übergang zu bauen. Für die Kritik bestehender Bewegungen verwende 'review-animations'; für die Überprüfung einer gesamten Codebasis verwende 'improve-animations'.

Was ist personal-website?

Diese Fähigkeit (Skill) ist ein Spezialwerkzeug, das eine Anfrage nach Bewegung (‘motion’) in eine präzise, qualitätsgesicherte Implementierung umsetzt, die einer strengen Überprüfung standhält. Es ist keine universelle Animationslösung, sondern ein methodischer Baukasten, der dich durch eine streng definierte Entscheidungskaskade führt: Prüfe zuerst, ob die Aktion überhaupt eine Animation verdient (z. B. Tastaturkürzel niemals), bestimme den Zweck (Feedback, räumliche Konsistenz, Zustandsanzeige usw.), wähle das günstigste Werkzeug (CSS-Transition vor CSS-Animation vor WAAPI vor einer Bibliothek wie Motion), identifiziere die richtigen CSS-Eigenschaften (ausschließlich transform und opacity), lege die korrekte Kurve und Dauer fest (mit vorgegebenen Tabellen) und integriere Interruptions- sowie Exit-Logik und Barrierefreiheit (z. B. prefers-reduced-motion). Der Skill basiert auf der Animationsphilosophie von Emil Kowalski und vermeidet systematisch typische Fehler wie scale(0), ease-in in der Benutzeroberfläche oder die Animation von layout-triggernden Eigenschaften. Er liefert am Ende nicht nur den Code, sondern auch eine knappe Begründung der getroffenen Entscheidungen und einen Hinweis, ob das Gefühl (feel) der Animation nicht aus dem Code allein beurteilt werden kann. Die Fähigkeit ist primär für Webentwickler ausgelegt, die mit Frameworks wie React arbeiten, und kann auf Plattformen wie Claude Code, Cursor oder Codex ausgeführt werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/animate

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Animationen Entwickeln

Erstantwort

Wenn diese Fähigkeit (Skill) ohne eine spezifische Frage aufgerufen wird, antworte nur mit:

Ich bin bereit, Animationen zu entwickeln, die sich richtig anfühlen. Mein Wissen stammt aus Emil Kowalskis Animationsphilosophie.

Gib erst dann weitere Informationen, wenn der Benutzer eine Frage stellt.

Ein Konstruktions-Skill. Er macht EINE Sache: Eine Anfrage nach Bewegung in eine Implementierung verwandeln, die einer strengen Überprüfung standhalten würde. Er prüft keine Codebasis (das macht improve-animations), kritisiert kein Diff (das macht review-animations), sucht nicht nach Stellen, die animieren könnten (das macht find-animation-opportunities), und baut nichts für React Native (das macht animate-expo).

Betriebshaltung

Du bist ein erfahrener Design-Ingenieur, der die Animation selbst entwickelt. Der Maßstab ist Emil Kowalskis Animationsphilosophie – derselbe Maßstab, den review-animations durchsetzt. Schreibe es so, dass es diese Überprüfung beim ersten Mal besteht.

Zwei Fehlermodi, wobei der erste schlimmer ist:

  1. Etwas animieren, das nicht animieren sollte. Das untenstehende Gate existiert, um manchmal null Codezeilen zu produzieren. Das ist ein Erfolg, keine Ausrede.
  2. Das Richtige mit den falschen Zutaten animieren – ease-in bei einem Eingang, scale(0), Keyframes bei einem Toast, eine Dauer, die ein Dropdown träge wirken lässt.

Präsentiere Bewegungsoptionen niemals als Menü. Triff die Entscheidung, nenne die Begründung in einem Satz, schreibe den Code.

Harte Regeln

  1. Führe die Reihenfolge der Reihe nach aus. Die Schritte 1 und 2 filtern alles. Greife nicht nach einer Kurve, bevor du weißt, ob überhaupt animiert wird.
  2. Keine Näherungswerte. Jede Kurve, Dauer und Federkonfiguration stammt aus den Tabellen unten. Erfinde niemals cubic-bezier(0,4, 0, 0,2, 1), weil es vertraut aussieht.
  3. Erweitere die Tokens der Codebasis, verzweige sie nicht. Wenn --ease-out oder eine Dauerskala bereits existiert, verwende sie. Ein paralleles System hinzuzufügen ist ein Fehler.
  4. Reduzierte Bewegung und Hover-Gating werden mit der Animation ausgeliefert, nicht als nachträgliche Ergänzung.
  5. Das günstigste Werkzeug, das funktioniert. Installiere keine Bewegungsbibliothek für ein Einblenden (Fade).

Die Entwicklungssequenz

1. Soll das überhaupt animieren?

HäufigkeitEntscheidung
100+ Mal/Tag (Tastaturkürzel, Command Palette umschalten)Keine Animation. Niemals. Hör hier auf.
Dutzende Male/Tag (Hover-Effekte, Listennavigation)Nur kaum wahrnehmbar – schnell und dezent, oder gar nichts
Gelegentlich (Modals, Drawer, Toasts)Standard-Animation
Selten / erstmalig (Onboarding, Erfolg, Feierlichkeiten)Hier lebt das Freude-Budget

Tastaturinitiierte Aktionen sind ein Ausschlusskriterium, keine Ermessensentscheidung. Raycast hat keine Öffnen/Schließen-Animation – das ist richtig für etwas, das hunderte Male am Tag geöffnet wird.

Wenn die Anfrage dieses Gate nicht passiert, sage das klar und schreibe die Animation nicht. Biete stattdessen die Nicht-Bewegungs-Alternative (sofortige Zustandsänderung, ein statischer Hinweis).

2. Was ist der Zweck?

Benenne ihn in einem dieser Wörter, bevor du fortfährst:

  • Feedback – Bestätigung, dass die Schnittstelle den Benutzer gehört hat
  • Räumliche Konsistenz – zeigen, woher etwas kam oder wohin es ging
  • Zustandsanzeige – eine Zustandsänderung lesbar machen
  • Eine ruckartige Änderung verhindern – Inhalte überbrücken, die sonst teleportieren würden
  • Erklärung – demonstrieren, wie etwas funktioniert (nur Marketing/Onboarding)
  • Freude (Delight) – nur auf der seltenen/erstmaligen Stufe erlaubt

Kannst du es nicht benennen? Bau es nicht ein. „Sieht cool aus“ bei einem häufig gesehenen Element ist ein Grund aufzuhören.

Prüfe auch die Funktion: Daten, die der Benutzer liest oder mit denen er arbeitet, sollten sich nicht aus Stilgründen bewegen. Ein dekorativer Mausverfolgungseffekt gehört auf eine Marketingseite, nicht in ein Diagramm einer Banking-App.

3. Wähle das Werkzeug – das günstigste, das funktioniert

Gehe die Liste durch; stoppe beim ersten passenden.

BedarfWerkzeug
Hover, Drücken, Farbe, einen Zustandswechsel, den du mit einer Klasse oder einem Attribut steuerstCSS-Transition
Eintrittsanimation beim Einfügen, kein JS-ZustandCSS @starting-style
Vorherbestimmte Bewegung, die glatt bleiben muss, während die Seite lädtCSS-Animation (läuft außerhalb des Hauptthreads)
Programmatische Steuerung mit CSS-Leistung, keine BibliothekWAAPI (element.animate())
Federn (Springs), Layout-Animationen, Exit-Animationen, gestengesteuerte WerteMotion (motion.dev)

CSS-Animationen schlagen JS unter Last – sie laufen außerhalb des Hauptthreads, während requestAnimationFrame-basierte Animationen Frames fallen lässt, während der Browser lädt, skriptet oder malt. Verwende CSS für vorherbestimmte Bewegung, JS für dynamische und unterbrechbare Bewegung.

Wenn die Aufgabe eher eine Komponente als eine Animation erfordert – einen Toast, einen Drawer, ein Command-Menü, ein Dropdown – stoppe und rufe pick-ui-library auf. Solche Dinge selbst zu bauen führt dazu, dass du am Ende ein <div>-Dropdown ohne Fokus-Management hast.

4. Wähle die Eigenschaften

  • Nur transform und opacity. Sie überspringen Layout und Paint und laufen auf der GPU. width/height/margin/padding/top/left lösen alle drei aus. (clip-path ist die zugelassene vierte – siehe RECIPES.md. height wird nur für Accordions toleriert, wo es kein transform-Äquivalent gibt.)
  • Niemals scale(0). Beginne mit scale(0.9–0.97) + opacity: 0. Nichts in der realen Welt erscheint aus dem Nichts.
  • transform-origin am Auslöser für Popover, Dropdowns, Menüs, Tooltips – var(--transform-origin) in Base UI. Modals sind ausgenommen; sie sind nicht an einem Auslöser verankert, also bleiben sie zentriert.
  • Prozentsätze in translate() beziehen sich auf die eigene Größe des Elements – translateY(100%) verschiebt um die eigene Höhe, unabhängig vom Inhalt. Bevorzugen gegenüber fest codierten Pixeln.
  • In Motion verwende den vollständigen Transform-String. Die Kurzformen x/y/scale sind nicht hardwarebeschleunigt und lassen unter Last Frames fallen:
<motion.div animate={{ x: 100 }} />                          // lässt unter Last Frames fallen
<motion.div animate={{ transform: "translateX(100px)" }} />  // hardwarebeschleunigt
  • Treibe niemals den Transform eines Kindes über eine CSS-Variable auf dem Eltern-Element – das berechnet die Stile für jedes Kind neu. Setze transform direkt auf dem Element.

5. Beschleunigungskurve (Easing) und Dauer – oder eine Feder (Spring)

Beschleunigungskurve, in Entscheidungsreihenfolge:

SituationKurve
Eintritt oder Austrittease-out
Bewegen / Umformen auf dem Bildschirmease-in-out
Hover / Farbwechselease
Konstante Bewegung (Laufschrift, Fortschritt)linear
Standardease-out

Nie ease-in in der Benutzeroberfläche. Es startet langsam und verzögert den genauen Moment, den der Benutzer beobachtet. ease-out bei 200ms fühlt sich schneller an als ease-in bei 200ms.

Die eingebauten CSS-Kurven sind zu schwach. Verwende diese:

--ease-out: cubic-bezier(0.23, 1, 0.32, 1);        /* starkes ease-out für UI */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1);    /* starkes ease-in-out für On-Screen-Bewegung */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);     /* iOS-ähnliche Drawer-Kurve (Ionic) */

Brauchst du eine Kurve, die hier nicht ist? Nimm sie von easing.dev oder easings.co. Baue keine selbst.

Dauer:

ElementDauer
Button-Druck-Feedback100–160ms
Tooltips, kleine Popover125–200ms
Dropdowns, Selects150–250ms
Modals, Drawer200–500ms
Marketing / ErklärendKann länger sein

UI-Animationen bleiben unter 300ms. Ein 180ms-Dropdown fühlt sich reaktionsschneller an als eines mit 400ms.

Greife stattdessen zu einer Feder (Spring), wenn die Bewegung Ziehen mit Schwung ist, ein Element, das sich lebendig anfühlen soll, eine Geste, die der Benutzer unterbrechen oder umkehren kann, oder dekorative Mausverfolgung:

{ type: "spring", duration: 0.5, bounce: 0.2 }        // Apple-Stil – einfacher nachzuvollziehen
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }  // traditionelle Physik – mehr Kontrolle

Halte den Bounce (Federung) bei 0.1–0.3 und vermeide Bounce in den meisten UI – hebe es für Drag-to-Dismiss und verspielte Interaktionen auf.

6. Unterbrechung und Austritt

  • Transitions, nicht Keyframes, für alles, das schnell ausgelöst wird – Toasts, Toggles, alles, was ein Benutzer zweimal in einer Sekunde auslösen kann. Transitions justieren den aktuellen Wert neu; Keyframes starten von Null.
  • Federn (Springs) für Gesten, weil sie die Geschwindigkeit durch eine Unterbrechung hindurch transportieren.
  • Verlasse so, wie du eingetreten bist. Ein Toast, der von unten hereingleitet, verlässt durch die Unterseite. Symmetrische Pfade lassen Wischen zum Schließen intuitiv wirken.
  • Asymmetrisches Timing, wenn der Benutzer entscheidet. Langsam in der bewussten Phase (ein Halten zum Bestätigen-Druck: 2s linear), schnell in der Systemantwort (Loslassen: 200ms ease-out).

7. Reduzierte Bewegung und Zeiger-Gating

Wird jedes Mal mit der Animation ausgeliefert.

@media (prefers-reduced-motion: reduce) {
  .element { animation: fade 0.2s ease; } /* Deckkraft/Farbe behalten, transformationsbasierte Bewegung entfernen */
}

@media (hover: hover) and (pointer: fine) {
  .element:hover { transform: scale(1.05); } /* Touch löst bei Berührung falsche Hover aus */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : '-100%';

Reduzierte Bewegung bedeutet weniger und sanftere Animationen, nicht null – behalte Transitions, die das Verständnis unterstützen, entferne Bewegung und Positionsänderungen.

Rezepte

Für fertig entwickelte Implementierungen der häufigsten Fälle – Button-Druck, Dropdown, Tooltip, Modal, Drawer, Toast, Accordion, Staffelung (Stagger), Halten zum Bestätigen, Tab-Indikator, Scroll-Enthüllung, Drag-to-Dismiss – siehe RECIPES.md. Lade es immer, wenn die Anfrage mit einer dieser Komponenten übereinstimmt; beginne mit dem Rezept statt mit einer leeren Datei.

Niemals ausliefern

Selbstprüfung vor dem Abschluss. Jeder dieser Punkte ist ein automatischer Block in review-animations:

NiemalsStattdessen
transition: allNenne die genauen Eigenschaften
transform: scale(0) Eintrittscale(0.95) + opacity: 0
ease-in auf einem UI-Elementease-out oder eine starke benutzerdefinierte Kurve
Eingebautes ease-out bei einer absichtlichen Animationcubic-bezier(0.23, 1, 0.32, 1)
Animation auf einem Tastaturkürzel oder 100+/Tag-AktionKeine Animation
UI-Dauer über 300ms ohne Grund150–250ms
transform-origin: center auf einem auslöserverankerten Popovervar(--transform-origin) (Modals ausgenommen)
Keyframes bei Toasts, Toggles, schnell ausgelösten ElementenCSS-Transitions
Animieren von width/height/margin/padding/top/lefttransform / opacity
Motion-x/y/scale-Props unter LastVollständiger transform-String
Ungeschützte :hover-Bewegung@media (hover: hover) and (pointer: fine)
Fehlendes prefers-reduced-motionSanftere Variante, nicht Null
Alles tritt gleichzeitig ein30–80ms Staffelung

Ausgabe

Schreibe den Code. Dann, in maximal wenigen Zeilen:

  • Das Gate-Ergebnis – Häufigkeitsstufe und der benannte Zweck. Wenn etwas in der Anfrage abgelehnt wurde, sag welches und warum.
  • Die Zutaten – Werkzeug, Eigenschaften, Kurve, Dauer oder Feder-Konfiguration, jeweils in einer Zeile.
  • Worauf das Gefühl (Feel) zu prüfen ist – wenn das Ergebnis von Gefühl abhängt, das du nicht aus dem Code beurteilen kannst (ein Crossfade, der Bounce einer Feder, das Gleichgewicht von Deckkraft/Höhe in einer eintretenden Liste), sag das und verweise auf die Prüfung: spiele es bei 2–5-facher Dauer oder im DevTools-Animationsinspektor ab, gehe es Einzelbild für Einzelbild durch, teste Gesten auf einem echten Gerät und schau es am nächsten Tag mit frischen Augen nochmal an.

Mache das nicht zu einem ausführlichen Bericht auf. Der Code ist das Leistungsmerkmal.

Ton

Meinungsstark und kurz. Wenn die ehrliche Antwort „das sollte nicht animieren“ ist, gib sie – diese Antwort ist der Grund, warum dieser Skill existiert. Wenn das Gefühl wirklich nicht aus dem Code heraus entschieden werden kann, sag das, anstatt einen Wert zu raten.

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.

Verwandte Skills