Communitygithub.com

CharbelElBateh/personal-website

Ein Reverse-Lookup-Glossar, das eine vage Beschreibung einer Web-Animation oder eines Bewegungseffekts in den genauen Fachbegriff umwandelt („das Hüpfende, wenn ein Popover aufgeht“ → Pop-in; „das iOS-Gummiband-Scrollen“ → Rubber-banding). Verwende dies, wenn der Benutzer fragt „Wie nennt man das, wenn…“ oder einen Bewegungseffekt beschreibt, ohne seinen Namen zu kennen, und das richtige Wort benötigt, um einen KI-Assistenten oder Designer zu prompten. Dient der Benennung eines Effekts, nicht der Gestaltung oder Umsetzung.

Was ist personal-website?

Diese Fähigkeit (Skill) fungiert als Reverse-Lookup-Glossar für Web-Animationen und Bewegungseffekte. Sie nimmt eine lockere, gefühlsbasierte Beschreibung eines visuellen Effekts – etwa „das Fedrige, wenn ein Popover aufgeht“ – und liefert den präzisen Fachbegriff (z. B. *Pop in*). Der Skill ist für Entwickler, Designer und KI-Nutzer gedacht, die den korrekten Namen eines Effekts benötigen, um ihn in einem Prompt, einem Designtool oder einer Konversation präzise zu referenzieren. Die Antworten folgen einem autoritativen Glossar, das Begriffe aus den Bereichen Einstiegs- und Ausstiegsanimationen, Bewegungsabläufe, Easing, Federanimationen, Scroll-Effekte, Feedback-Interaktionen, Performance und mehr abdeckt. Der Skill erkennt die Absicht hinter der Beschreibung, klärt bei ähnlichen Begriffen auf und nennt bei ungenauen Treffern die nächstliegende Alternative. Er ist plattformunabhängig und kann in jedem Kontext eingesetzt werden, in dem ein Bewegungseffekt benannt werden muss – ohne selbst Code zu generieren oder Animationen zu entwerfen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Animationsvokabular

Erstantwort

Wenn dieser Skill zum ersten Mal ohne eine konkrete Frage aufgerufen wird, antworte nur mit:

Ich bin bereit, jedem von dir beschriebenen Bewegungseffekt einen Namen zu geben – mein Wissen stammt aus Emil Kowalskis Animationsphilosophie.

Gib keine weiteren Informationen, bis der Benutzer eine Frage stellt.

Wandle eine vage Beschreibung einer Bewegung oder eines Effekts in den genauen Fachbegriff um, sodass der Benutzer weiß, wonach er fragen muss.

Schnellstart

Der Benutzer beschreibt einen Effekt ungenau. Du gibst den passenden Begriff / die passenden Begriffe in folgendem Format zurück:

**Stagger** — Animiert mehrere Elemente nacheinander mit einer kleinen Verzögerung zwischen den einzelnen Elementen, sodass eine Kaskade entsteht.

Wenn mehrere Begriffe infrage kommen, liste den besten Treffer zuerst auf, dann 1–2 Alternativen mit einem kurzen Hinweis, wie sie sich unterscheiden.

Anleitung

  1. Lies nach der Absicht, nicht nach Schlüsselwörtern. Benutzer beschreiben, was sie sehen oder fühlen („federnd“, „gleitet weg“, „zeichnet sich ein“), nicht den technischen Namen. Ordne die Empfindung dem folgenden Glossar zu.
  2. Zitiere das Glossar wörtlich. Seine Beschreibungen sind maßgeblich – verwende sie wie sie sind, paraphrasiere nicht.
  3. Klärung ähnlicher Begriffe. Wenn zwei Begriffe konkurrieren (Clip-path vs. Mask, Pop in vs. Bounce, Shared element transition vs. Layout animation), grenze sie ab, sodass der Benutzer wählen kann.
  4. Wenn nichts genau passt, nenne den nächstgelegenen Begriff und sage klar, dass es sich um eine Annäherung handelt, oder beschreibe den Effekt mit dem Vokabular des Glossars (z. B. „das ist ein Stagger von Scale-in-Eingängen“).
  5. Bleibe innerhalb dieses Glossars. Wenn ein Begriff hier wirklich nicht vorkommt, sage das lieber, als einen zu erfinden – du darfst das Konzept aber mit diesen Worten erklären.
  6. Halte es kurz. Eine Frage zur Benennung will einen Namen, keinen Aufsatz. Beginne mit dem Begriff; erweitere nur, wenn gefragt.

Beispiele

Beispiel 1 – gefühlsbasiert Benutzer: „Wie nennt man das, wenn ein Popover aus dem Button herauszuwachsen scheint, den du geklickt hast, anstatt aus seiner Mitte?“ Ausgabe:

**Origin-aware animation** — Ein Element animiert aus seinem Auslöser heraus, wie ein Popover, das aus dem Button wächst, der es geöffnet hat, anstatt aus seiner eigenen Mitte, was in CSS die Voreinstellung ist.

Beispiel 2 – Begriffsklärung Benutzer: „Das Ding, bei dem ein Bild in ein anderes Bild übergeht.“ Ausgabe:

**Morph** — Eine Form verwandelt sich sanft in eine andere Form, z. B. Dynamic Island.

Nahe Alternativen:
- **Crossfade** — wenn sie einfach an derselben Stelle ineinander überblenden.
- **Shared element transition** — wenn ein Element von einer Position zur anderen wandert und sich dabei transformiert.

Beispiel 3 – Physikgefühl Benutzer: „Das iOS-Scrollen, bei dem es Widerstand leistet und zurückschnappt, wenn du zu weit ziehst.“ Ausgabe:

**Rubber-banding** — Widerstand und Zurückschnappen, wenn du über eine Grenze hinausziehst (das iOS-Überscroll-Gefühl).

Glossar

Ein kuratierter Snapshot, der die /vocabulary-Seite des Projekts widerspiegelt; beide bei Änderungen synchron halten.

Einstiege & Ausstiege — wie Elemente erscheinen und verschwinden

  • Fade in / Fade out — Element erscheint oder verschwindet durch Änderung der Opazität.
  • Slide in — Element tritt ein, indem es von außerhalb des Bildschirms hereingleitet (links, rechts, oben oder unten).
  • Scale in — Element wächst beim Erscheinen von kleiner zur vollen Größe, oft in Kombination mit einem Fade.
  • Pop in — Element erscheint mit einem leichten Überschwingen, als ob es an seinen Platz springt.
  • Reveal — Inhalt wird nach und nach freigelegt, oft durch Animation eines Clip-Pfads oder einer Maske.
  • Enter / Exit — Die Animation, die ein Element abspielt, wenn es zum Bildschirm hinzugefügt oder von ihm entfernt wird.

Ablauf & Timing — Koordination mehrerer Elemente oder Momente

  • Keyframes — Definierte Punkte in einer Animation (0%, 50%, 100%), zwischen denen der Browser die Lücken füllt.
  • Interpolation / Tween — Erzeugen aller Zwischenbilder zwischen einem Start- und Endwert, sodass die Bewegung kontinuierlich ist.
  • Stagger — Animiert mehrere Elemente nacheinander mit einer kleinen Verzögerung zwischen den einzelnen Elementen, sodass eine Kaskade entsteht.
  • Orchestration — Bewusstes Timen mehrerer Animationen, sodass sie sich wie eine einzige koordinierte Bewegung anfühlen.
  • Delay — Zeit vor dem Start einer Animation.
  • Duration — Dauer einer Animation.
  • Fill mode — Ob ein Element vor Animationsbeginn oder nach Animationsende die Stile seines ersten oder letzten Schlüsselbildes behält (z. B. forwards).
  • Stepped animation — Eine Animation, die in diskrete Schritte unterteilt ist, wie ein Countdown-Timer.

Bewegung & Transformationen — Ändern der Position, Größe oder des Winkels eines Elements

  • Translate — Bewegen eines Elements entlang der X- oder Y-Achse.
  • Scale — Vergrößern oder Verkleinern eines Elements.
  • Rotate — Drehen eines Elements um einen Punkt.
  • Skew — Neigen eines Elements entlang der X- oder Y-Achse, sodass es aus seiner rechteckigen Form geschert wird.
  • 3D tilt / Flip — Drehen im 3D-Raum (rotateX / rotateY) um Tiefe zu erzeugen.
  • Perspective — Wie stark der 3D-Effekt wirkt – ein niedrigerer Wert verstärkt die Tiefe, als ob der Betrachter näher dran wäre.
  • Transform origin — Der Ankerpunkt, von dem aus eine Skalierung oder Drehung wächst oder sich dreht.
  • Origin-aware animation — Ein Element animiert aus seinem Auslöser heraus, wie ein Popover, das aus dem Button wächst, der es geöffnet hat, anstatt aus seiner eigenen Mitte, was in CSS die Voreinstellung ist.

Übergänge zwischen Zuständen — verbinden eines Zustands, einer Ansicht oder eines Elements mit einem anderen

  • Crossfade — Ein Element blendet aus, während ein anderes an derselben Stelle einblendet.
  • Continuity transition — Eine Änderung, die den Benutzer orientiert hält, indem sie Vorher und Nachher visuell verbindet. Beispielsweise dasselbe Rechteck größer und kleiner machen.
  • Morph — Eine Form verwandelt sich sanft in eine andere Form, z. B. Dynamic Island.
  • Shared element transition — Ein Element wandert und transformiert sich von einer Position in eine andere, wie ein Thumbnail, das sich zu einer Karte ausdehnt.
  • Layout animation — Wenn sich Größe oder Position eines Elements ändert, animiert es an die neue Stelle, anstatt zu springen.
  • Accordion / Collapse — Ein Abschnitt dehnt und zieht seine Höhe sanft zusammen, um Inhalt zu zeigen oder zu verbergen.
  • Direction-aware transition — Inhalt gleitet in eine Richtung vorwärts und in die entgegengesetzte Richtung rückwärts, sodass die Navigation eine Richtung hat.

Scroll — an Scrolling oder Navigation zwischen Ansichten gebundene Bewegung

  • Scroll reveal — Elemente blenden ein oder gleiten ein, wenn sie in den sichtbaren Bereich gelangen.
  • Scroll-driven animation — Eine Animation, deren Fortschritt direkt an die Scrollposition gebunden ist.
  • Parallax — Vorder- und Hintergrund bewegen sich beim Scrollen mit unterschiedlicher Geschwindigkeit, was Tiefe erzeugt.
  • Page transition — Eine Animation, die beim Navigieren von einer Seite oder Route zu einer anderen abgespielt wird.
  • View transition — Der Browser wechselt zwischen zwei Zuständen oder Seiten und verbindet dabei gemeinsame Elemente.

Feedback & Interaktion — Reaktionen auf Benutzeraktionen

  • Hover effect — Visuelle Änderung, wenn der Mauszeiger über ein Element bewegt wird.
  • Press / Tap feedback — Eine dezente Verkleinerung beim Klicken eines Elements, damit es sich physisch anfühlt.
  • Hold to confirm — Ein Fortschrittseffekt, der sich füllt, während der Benutzer eine Taste gedrückt hält.
  • Drag — Bewegen eines Elements durch Greifen, oft mit Schwung nach dem Loslassen.
  • Drag to reorder — Ziehen von Elementen in einer Liste, um sie neu anzuordnen, während die anderen Platz machen.
  • Swipe to dismiss — Ziehen eines Elements aus dem Bildschirm, um es zu schließen, wie ein Drawer oder Toast.
  • Rubber-banding — Widerstand und Zurückschnappen, wenn du über eine Grenze hinausziehst (das iOS-Überscroll-Gefühl).
  • Shake / Wiggle — Ein schnelles Hin-und-Her-Zittern als Signal für einen Fehler oder eine abgelehnte Eingabe.
  • Ripple — Ein Kreis, der sich vom Berührungspunkt aus ausbreitet und den Druck bestätigt.

Easing — wie sich die Geschwindigkeit im Verlauf einer Animation ändert

  • Easing — Die Geschwindigkeit, mit der eine Animation schneller oder langsamer wird.
  • Ease-out — Startet schnell, endet langsam. Die Voreinstellung für die meisten UI-Elemente und alles, was auf den Benutzer reagiert.
  • Ease-in — Startet langsam, endet schnell. Wird normalerweise vermieden; kann sich träge anfühlen.
  • Ease-in-out — Langsam, schnell, langsam. Gut für Elemente, die sich bereits auf dem Bildschirm von A nach B bewegen.
  • Linear — Konstante Geschwindigkeit. Für die UI vermeiden; nur für Spinner oder Laufbänder reservieren.
  • Cubic-bezier — Eine benutzerdefinierte Easing-Kurve für präzise Kontrolle.
  • Asymmetric easing — Eine Kurve, die mit unterschiedlichen Raten beschleunigt und verzögert. Fühlt sich lebendiger an als eine symmetrische.

Federanimationen — physikbasierte Bewegung als Alternative zum festen Easing

  • Spring — Bewegung angetrieben durch Physik (Spannung, Masse, Dämpfung) anstelle einer festen Dauer.
  • Stiffness / Tension — Wie stark die Feder in Richtung ihres Ziels zieht. Höher wirkt schneller.
  • Damping — Wie schnell eine Feder zur Ruhe kommt. Niedrigere Dämpfung bedeutet mehr Hüpfen und Schwingen.
  • Mass — Wie schwer sich das animierte Element anfühlt. Mehr Masse macht es langsamer und träger.
  • Bounce — Eine Feder, die überschwingt und dann zur Ruhe kommt, was Verspieltheit hinzufügt.
  • Perceptual duration — Wie lange sich eine Feder beendet anfühlt, auch wenn sie darunter noch mikroschwingt.
  • Momentum — Bewegung, die Geschwindigkeit beibehält, besonders nach einem Ziehen oder einer Unterbrechung.
  • Velocity — Wie schnell und in welche Richtung sich ein Element bewegt. Eine Feder trägt die Geschwindigkeit in die nächste Animation, wenn sie unterbrochen wird, sodass ein geschwungenes Element seine Geschwindigkeit behält.
  • Interruptible animation — Eine Animation, die mitten im Lauf sanft umgelenkt werden kann, anstatt zuerst zu enden.

Schleifen & Umgebungsbewegung — Animationen, die von selbst laufen

  • Marquee — Text oder Inhalt, der kontinuierlich in einer Schleife läuft.
  • Loop — Eine Animation, die sich wiederholt, eine bestimmte Anzahl von Malen oder unendlich.
  • Alternate (yoyo) — Eine Schleife, die vorwärts und dann rückwärts abläuft, anstatt zum Anfang zurückzuspringen.
  • Orbit — Ein Element, das ein anderes auf einem kontinuierlichen Pfad umkreist.
  • Pulse — Eine sanfte, sich wiederholende Skalierungs- oder Opazitätsänderung, um Aufmerksamkeit zu erregen.
  • Float — Ein sanftes, kontinuierliches Auf- und Abschweben, das ein statisches Element lebendig und schwerelos wirken lässt.
  • Idle animation — Subtile Bewegung, die abgespielt wird, während ein Element nur dasitzt und darauf wartet, interagiert zu werden.

Feinschliff & Effekte — die kleinen Details, die gut von großartig unterscheiden

  • Blur — Ein Weichzeichnungsfilter, um ein Element weicher zu machen oder winzige Unvollkommenheiten zu kaschieren.
  • Clip-path — Beschneiden eines Elements auf eine Form, verwendet für Enthüllungen, Masken und Vorher/Nachher-Schieberegler.
  • Mask — Ausblenden oder Anzeigen von Teilen eines Elements mithilfe einer Form oder eines Farbverlaufs – wie Clip-Pfad, aber mit weichen, ausblendbaren Kanten.
  • Before / after slider — Ein ziehbarer Trennbalken, der zwischen zwei überlagerten Bildern wischt, um sie zu vergleichen.
  • Line drawing — Ein SVG-Pfad, der sich selbst zeichnet, wie eine unsichtbare Feder, die ihn nachfährt.
  • Text morph — Text, der beim Ändern Zeichen für Zeichen animiert und die Aufmerksamkeit auf den neuen Wert lenkt.
  • Skeleton / Shimmer — Ein Platzhalter mit einem wandernden Glanz, der angezeigt wird, während Inhalt geladen wird.
  • Number ticker — Ziffern, die auf einen Wert rollen oder hochzählen.
  • Tabular numbers — Ziffern mit fester Breite, sodass Zahlen beim Ändern nicht hin und her springen. Unverzichtbar für Ticker, Timer und Zähler.
  • Typewriter — Text, der Zeichen für Zeichen erscheint, als würde gerade getippt.

Performance — was Bewegung flüssig statt ruckelig macht

  • Frame rate (FPS) — Bilder pro Sekunde. 60fps ist die Grundlinie für flüssige Bewegung; 120fps auf neueren Displays.
  • Jank — Sichtbares Ruckeln, wenn der Browser Bilder auslässt, weil er mit der Animation nicht Schritt halten kann.
  • Dropped frame — Ein Bild, das der Browser nicht rechtzeitig zeichnen konnte, was einen winzigen Ruckler in der Bewegung verursacht.
  • Compositing — Der GPU erlauben, ein Element auf einer eigenen Ebene zu bewegen oder auszublenden, ohne Layout oder Zeichnung neu zu berechnen.
  • will-change — Ein CSS-Hinweis, dass ein Element gleich animiert wird, damit der Browser es vorab auf eine eigene Ebene befördern kann.
  • Layout thrashing — Animieren von Eigenschaften wie width, height, top oder left, die den Browser zwingen, jedes Bild das Layout neu zu berechnen, was zu Jank führt.

Wissenswerte Prinzipien — Konzepte, die leiten, wann und wie animiert wird

  • Purposeful animation — Bewegung sollte eine Funktion erfüllen – orientieren, Feedback geben, Beziehungen zeigen – und nicht nur dekorieren.
  • Anticipation — Ein kleiner Rückschwung in die entgegengesetzte Richtung vor einer Bewegung, der andeutet, was gleich passiert.
  • Follow-through — Teile eines Elements bewegen sich weiter und beruhigen sich leicht, nachdem die Hauptbewegung aufhört, was Gewicht verleiht.
  • Squash & stretch — Verformen eines Elements während der Bewegung, um Gewicht, Geschwindigkeit und Flexibilität zu vermitteln.
  • Perceived performance — Die richtige Animation lässt eine Schnittstelle schneller wirken, auch wenn sie es nicht ist.
  • Frequency of use — Je öfter ein Benutzer eine Animation sieht, desto kürzer und dezenter sollte sie sein.
  • Spatial consistency — Animieren, sodass ein Element seine Identität und Position über Zustände hinweg behält, damit Benutzer nie den Überblick verlieren, wohin Dinge gegangen sind.
  • Hardware acceleration — Animieren von Transform und Opazität lässt die GPU die Bewegung flüssig halten.
  • Reduced motion — Respektieren der prefers-reduced-motion-Einstellung des Benutzers durch Verringern oder Entfernen von Bewegung.

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.

Verwandte Skills