Communitygithub.com

aktiva-labs/Claude-Skill-Compendium

Erstelle Animationen von Grund auf, indem du Entscheidungen in der richtigen Reihenfolge triffst: ob animiert werden soll, welchem Zweck es dient, mit welchem Werkzeug, welchen Eigenschaften, welcher Kurve und Dauer, wie es unterbrochen wird und wie es endet. Schreibe die Implementierung. Verwende dies, wenn du aufgefordert wirst, etwas zu animieren, Bewegung hinzuzufügen, einer Komponente Leben einzuhauchen oder einen Übergang zu bauen. Für Kritik an bestehenden Animationen verwende `review-animations`; für ein Audit der gesamten Codebasis verwende `improve-animations`.

Was ist Claude-Skill-Compendium?

Das Skill „Building Animations“ von aktiva-labs implementiert eine strukturierte, philosophisch fundierte Methode zur Erstellung von UI-Animationen, die den Richtlinien von Emil Kowalski folgt. Es ist als strikter Bauprozess konzipiert, der sicherstellt, dass jede Animation einen Zweck erfüllt, technisch effizient ist und einer kritischen Überprüfung standhält. Der Skill führt den Entwickler durch sieben aufeinanderfolgende Schritte: (1) Entscheiden, ob überhaupt animiert werden soll, basierend auf der Nutzungshäufigkeit; (2) Benennen des konkreten Zwecks (z. B. Feedback, räumliche Konsistenz); (3) Auswahl des günstigsten Werkzeugs (CSS-Transition, CSS-Animation, WAAPI oder Motion-Bibliothek); (4) Festlegung der Eigenschaften (bevorzugt `transform` und `opacity`); (5) Wahl der passenden Easing-Kurve und Dauer; (6) Berücksichtigung von Unterbrechungen und Exit-Animationen sowie (7) Integration von Reduced-Motion- und Hover-Gating. Enthalten sind klare Tabellen für Easing-Kurven, Dauern und Feder- (Spring-)Konfigurationen, eine Liste von „Never Ship“-Anti-Patterns sowie eine Referenz zu gängigen Rezepten (RECIPES.md) für typische Komponenten wie Buttons, Tooltips, Modals und Toasts. Das Skill ist für Entwickler von Webanwendungen gedacht, die Animationen entweder direkt in CSS/JS oder mit der Motion-Bibliothek umsetzen möchten, und unterstützt somit plattformübergreifend moderne Web-Technologien.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktiva-labs/Claude-Skill-Compendium/tree/HEAD/emilkowalski-skills/skills/animate

In Ihrer bevorzugten KI fragen

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

Dokumentation

Animationen bauen

Erstantwort

Wenn dieses Skill zum ersten Mal ohne eine spezifische Frage aufgerufen wird, antworte nur mit:

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

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

Ein Konstruktions-Skill. Es macht eine Sache: Eine Anfrage nach Bewegung in eine Implementierung verwandeln, die eine strenge Überprüfung bestehen würde. Es auditet keine Codebasis (das macht improve-animations), kritisiert keinen Diff (das macht review-animations), sucht nicht nach Stellen, die animiert werden könnten (das macht find-animation-opportunities), und baut nichts für React Native (das macht animate-expo).

Arbeitsweise

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

Zwei Fehlermodi, und der erste ist schlimmer:

  1. Etwas animieren, das nicht animiert werden sollte. Der untenstehende Filter existiert, um manchmal null Zeilen Code zu produzieren. Das ist ein Erfolg, kein Ausweichmanöver.
  2. Das Richtige mit den falschen Zutaten animieren – ease-in bei einem Eintritt, scale(0), Keyframes bei einem Toast, eine Dauer, die ein Dropdown träge erscheinen lässt.

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

Harte Regeln

  1. Führe die Sequenz der Reihe nach aus. Schritt 1 und 2 sind der Filter. Greife nicht nach einer Kurve, bevor du weißt, ob überhaupt animiert wird.
  2. Keine ungefähren Werte. 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. Reduced Motion und Hover-Gating werden mit der Animation ausgeliefert, nicht als Nachbesserung.
  5. Das günstigste Werkzeug, das funktioniert. Installiere keine Bewegungsbibliothek für einen einfachen Fade.

Die Bausequenz

1. Soll das überhaupt animieren?

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

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 diesen Filter nicht passiert, sage das klar und schreibe die Animation nicht. Biete stattdessen die Alternative ohne Bewegung (sofortige Zustandsänderung, statischer Hinweis).

2. Was ist der Zweck?

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

  • Feedback – bestätigt, dass die Schnittstelle den Benutzer gehört hat
  • Räumliche Konsistenz – zeigt, woher etwas kam oder wohin es ging
  • Zustandsanzeige – macht eine Zustandsänderung lesbar
  • Verhindern einer ruckartigen Änderung – überbrückt Inhalte, die sonst springen würden
  • Erklärung – demonstriert, wie etwas funktioniert (nur Marketing/Onboarding)
  • Freude – ist nur auf der seltenen/erstmaligen Stufe erlaubt

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

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

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

Gehe die Liste durch; halte beim ersten an, das passt.

BedarfWerkzeug
Hover, Drücken, Farbe, einen Zustand umschalten, den du mit einer Klasse oder einem Attribut steuerstCSS-Transition
Eintrittsanimation beim Einfügen, kein JS-ZustandCSS @starting-style
Vorherbestimmte Bewegung, die flüssig bleiben muss, während die Seite mit Laden beschäftigt istCSS-Animation (läuft abseits des Hauptthreads)
Programmatische Kontrolle mit CSS-Performance, keine BibliothekWAAPI (element.animate())
Federn, Layout-Animationen, Exit-Animationen, gestengetriebene WerteMotion (motion.dev)

CSS-Animationen schlagen JS unter Last – sie laufen abseits des Hauptthreads, während requestAnimationFrame-basierte Animationen Frames fallen lassen, 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 benötigt – einen Toast, einen Drawer, ein Command-Menü, ein Dropdown – halte an und rufe pick-ui-library auf. Diese selbst zu bauen ist der Weg zu einem <div>-Dropdown ohne Fokus-Management.

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 genehmigte vierte – siehe RECIPES.md. height wird nur für Akkordeons toleriert, wo es kein Transform-Äquivalent gibt.)
  • Nie 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.
  • Prozente in translate() sind relativ zur eigenen Größe des Elements – translateY(100%) bewegt es unabhängig vom Inhalt um seine eigene Höhe. Bevorzuge sie gegenüber fest codierten Pixeln.
  • In Motion verwende den vollständigen Transform-String. x/y/scale-Kurzformen 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 nie die Transform eines Kindes über eine CSS-Variable auf dem Elternelement – das berechnet die Stile für jedes Kind neu. Setze transform direkt auf dem Element.

5. Easing und Dauer – oder eine Feder

Easing, in Entscheidungsreihenfolge:

SituationEasing
Eintreten oder Verlassenease-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 genau den Moment, den der Benutzer beobachtet. ease-out bei 200ms fühlt sich schneller an als ease-in bei 200ms.

Eingebaute CSS-Easings 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 Bildschirmbewegung */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);     /* iOS-ähnliche Drawer-Kurve (Ionic) */

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

Dauer:

ElementDauer
Knopfdruck-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 reaktionsfreudiger an als eines mit 400ms.

Greife stattdessen zu einer Feder, 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 bei 0.1–0.3 und vermeide Bounce in den meisten UI-Szenarien – reserviere ihn für Ziehen-zum-Schließen und verspielte Interaktionen.

6. Unterbrechung und Exit

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

7. Reduced Motion und Zeiger-Gating

Wird jedes Mal mit der Animation ausgeliefert.

@media (prefers-reduced-motion: reduce) {
  .element { animation: fade 0.2s ease; } /* behalte Opazität/Farbe, entferne transformationsbasierte Bewegung */
}

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

Reduced Motion bedeutet weniger und sanftere Animationen, nicht keine – behalte Übergänge, die das Verständnis unterstützen, entferne Bewegung und Positionsänderungen.

Rezepte

Für gebrauchsfertige Implementierungen der häufigsten Fälle – Knopfdruck, Dropdown, Tooltip, Modal, Drawer, Toast, Akkordeon, Staffelung, Halten-zum-Bestätigen, Tab-Indikator, Scroll-Enthüllung, Ziehen-zum-Schließen – siehe RECIPES.md. Lade es immer dann, wenn die Anfrage zu einer dieser Komponenten passt; beginne mit dem Rezept anstatt mit einer leeren Datei.

Niemals ausliefern

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

NiemalsStattdessen
transition: allBenenne die genauen Eigenschaften
transform: scale(0)-Eintrittscale(0.95) + opacity: 0
ease-in bei einem UI-Elementease-out oder eine starke benutzerdefinierte Kurve
Eingebautes ease-out bei einer bewussten Animationcubic-bezier(0.23, 1, 0.32, 1)
Animation bei einem Tastaturkürzel oder einer Aktion, die 100+ Mal/Tag ausgeführt wirdKeine Animation
UI-Dauer über 300ms ohne Grund150–250ms
transform-origin: center bei einem auslöserverankerten Popovervar(--transform-origin) (Modals ausgenommen)
Keyframes bei Toasts, Toggles, schnell ausgelösten ElementenCSS-Transitionen
width/height/margin/padding/top/left animierentransform / 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 höchstens wenigen Zeilen:

  • Das Filterergebnis – Häufigkeitsstufe und der benannte Zweck. Wenn etwas in der Anfrage abgelehnt wurde, sage was und warum.
  • Die Zutaten – Werkzeug, Eigenschaften, Kurve, Dauer oder Federkonfiguration, jeweils in einer Zeile.
  • Worauf man achten sollte – wenn das Ergebnis von einem Gefühl abhängt, das du nicht anhand des Codes beurteilen kannst (eine Überblendung, der Bounce einer Feder, das Opazitäts-/Höhen-Gleichgewicht in einer eintretenden Liste), sage dies und weise auf die Überprüfung hin: Spiele es mit 2–5-facher Dauer oder im DevTools-Animationsinspektor ab, schreite es Bild für Bild vor, teste Gesten auf einem echten Gerät und schaue am nächsten Tag mit frischen Augen noch einmal drauf.

Blähe dies nicht zu einem Bericht auf. Der Code ist das Arbeitsergebnis.

Ton

Meinungsstark und prägnant. Wenn die ehrliche Antwort „das sollte nicht animieren“ ist, gib sie – diese Antwort ist der Grund, warum dieses Skill existiert. Wenn das Gefühl wirklich nicht aus dem Code abgeleitet werden kann, sage dies, anstatt einen Wert zu raten.

Individual skills in this repo

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

aktiva-labs/Claude-Skill-Compendium

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`.

aktiva-labs/Claude-Skill-Compendium

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.

aktiva-labs/Claude-Skill-Compendium

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.

aktiva-labs/Claude-Skill-Compendium

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.

aktiva-labs/Claude-Skill-Compendium

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

Verwandte Skills