Communitygithub.com

Asymmetric-al/core

Erstelle eine Animation von Grund auf, indem du die Entscheidungen in der Reihenfolge triffst, die bestimmt, ob sie sich richtig anfühlt – soll sie überhaupt animieren, welcher Zweck, welches Werkzeug, welche Eigenschaften, welche Kurve und Dauer, wie sie unterbricht, wie sie endet. Schreibt die Implementierung. Verwende dies, wenn du aufgefordert 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 Prüfung einer gesamten Codebasis verwende `improve-animations`. Wird nur ausgeführt, wenn explizit aufgerufen; es löst nicht von selbst aus.

Was ist core?

Diese Fähigkeit (Skill) ist eine spezialisierte Motion-Engineering-Fähigkeit, die Entwickler durch einen strengen, schrittweisen Prozess zum Erstellen von Web-Animationsimplementierungen führt. Sie ist darauf ausgelegt, nach Abschluss der Design-Engineering- und operativen Motion-Verträge von Core ausgeführt zu werden und durchzusetzen, dass die Implementierung eine strenge Überprüfung bestehen würde. Der Skill zwingt eine Entscheidungsreihenfolge durch: Zuerst bewertet er, ob eine Animation überhaupt notwendig ist (basierend auf der Nutzungshäufigkeit), dann identifiziert er ihren genauen Zweck (wie Feedback oder räumliche Konsistenz), wählt das günstigste Werkzeug aus (von CSS-Übergängen über WAAPI bis hin zur Motion-Bibliothek) und gibt Eigenschaften, Kurven, Dauern und Bedingungen für reduzierte Bewegung an – alles aus vordefinierten Tabellen ohne Näherungswerte. Er unterstützt Plattformen wie Web (CSS/JS/Motion) und durchsetzt eine Philosophie, die `transform/opacity` bevorzugt, `scale(0)` und `ease-in` bei UI-Elementen vermeidet, Tastatur-/Häufigkeits-Aktionen von Animationen ausschließt und `prefers-reduced-motion` als Teil der Implementierung und nicht als nachträglichen Gedanken vorsieht. Er enthält auch einen Abschnitt „Nie ausliefern“ (Never Ship), der Echtzeit-Checks gegen häufige Fehler bereitstellt, und eine Rezepte-Datei (RECIPES.md) für gängige Komponenten wie Schaltflächen, Dropdowns und Modals.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/animate

In Ihrer bevorzugten KI fragen

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

Dokumentation

Animationen erstellen

Dieses Repository (Asymmetric-al/core)

Verwende diesen Skill, um Web-Bewegungen nach den Design-Engineering- und operativen Motion-Verträgen von Core zu implementieren. Gleiche diesen Overlay nach Upstream-Aktualisierungen ab, bevor du bun run skills:sync ausführst.

Auslöser

  • Erstellen oder Umschreiben einer Web-Animation, eines Übergangs oder einer Mikro-Interaktion.
  • Nicht verwenden für Expo/React Native (animate-expo), ein Codebase-Audit (improve-animations) oder eine reine Motion-Überprüfung (review-animations).

Arbeitsablauf

  1. Lade zuerst docs/ai/skills/emil-design-engineering/SKILL.md und docs/ai/skills/anim/SKILL.md.
  2. Verwende vorhandene Core-Motion-Tokens und Base-UI-Primitive wieder. Forke keine Dauern, Easings oder führe Radix-APIs ein.
  3. Behalte „reduced-motion“ auf der globalen Basislinie in packages/ui/styles/globals.css.
  4. Wenn die Aufgabe einen Toast, Drawer, ein Menü oder Dropdown benötigt, verwende @asym/ui / Base UI wieder. Rufe pick-ui-library nicht auf, es sei denn, der Benutzer hat explizit gefragt, welche Bibliothek verwendet werden soll.

Checkliste

  • Die Animation hat einen Zweck und bleibt wo möglich bei transform/opacity.
  • Core-Tokens, Base UI und anim haben Vorrang vor veranschaulichenden Upstream-Werten.
  • Gemeinsame Dienstprogramme und @asym/lib/motion-presets werden neuen Zeitliteralen vorgezogen.

Ein Konstruktions-Skill. Er tut EINES: eine Anfrage nach Bewegung in eine Implementierung verwandeln, die eine strenge Überprüfung überstehen würde. Er auditieret keine Codebasis (das ist improve-animations), kritisiert keinen Diff (das ist review-animations), sucht nicht nach Stellen, die animieren könnten (das ist find-animation-opportunities), und erstellt nichts für React Native (das ist animate-expo).

Betriebshaltung

Du bist ein erfahrener Design-Ingenieur, der die Animation selbst erstellt. Die Messlatte ist Emil Kowalskis Animationsphilosophie – dieselbe Messlatte, die review-animations durchsetzt. Schreibe sie so, dass sie diese Überprüfung beim ersten Mal besteht.

Zwei Fehlermodi, und der erste ist schlimmer:

  1. Etwas animieren, das nicht animiert werden sollte. Die folgende Hürde 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 Eintritt, 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, gib die Begründung in einem Satz an und schreibe den Code.

Harte Regeln

  1. Führe die Sequenz der Reihe nach aus. Schritte 1 und 2 sind die Hürde für alles. Greife nicht nach einer Kurve, bevor du weißt, ob es überhaupt animiert.
  2. Keine Näherungswerte. Jede Kurve, Dauer und Federkonfiguration stammt aus den folgenden Tabellen. Erfinde niemals cubic-bezier(0.4, 0, 0.2, 1), weil es vertraut aussieht.
  3. Erweitere die Tokens der Codebasis, forke sie nicht. Wenn --ease-out-soft oder ein Dauer-Token bereits in packages/ui/styles/globals.css existiert, verwende es. Ein paralleles System hinzuzufügen ist ein Fehler.
  4. Reduzierte Bewegung und Hover-Gating werden mit der Animation ausgeliefert, nicht als Nachbesserung.
  5. Das günstigste Werkzeug, das funktioniert. Installiere keine Motion-Bibliothek für ein Einblenden.

Die Erstellungssequenz

1. Soll das überhaupt animieren?

HäufigkeitEntscheidung
100+ Mal/Tag (Tastaturkürzel, Befehlspalette umschalten)Niemals animieren. Hier aufhören.
Dutzende Male/Tag (Hover-Effekte, Listennavigation)Nur nahezu unmerklich – schnell und subtil, oder gar nicht
Gelegentlich (Modals, Drawer, Toasts)Standardanimation
Selten / zum ersten Mal (Onboarding, Erfolg, Feier)Das Vergnügungsbudget lebt hier

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

Wenn die Anfrage diese Hürde nicht besteht, sage dies klar und schreibe die Animation nicht. Biete stattdessen die Alternative ohne Bewegung an (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
  • Verhindern einer ruckartigen Änderung – Überbrücken von Inhalten, die sonst teleportieren würden
  • Erklärung – Demonstrieren, wie etwas funktioniert (nur Marketing/Onboarding)
  • Vergnügen – Nur auf der seltenen/zum-ersten-Mal-Stufe erlaubt

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

Überprü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 in einer Banking-App.

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

Gehe die Liste durch; stoppe beim ersten, das passt.

BedarfWerkzeug
Hover, Drücken, Farbe, ein Zustandsumschalter, den du mit einer Klasse oder einem Attribut steuerstCSS-Übergang
Eintrittsanimation beim Mounten, 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, Layout-Animationen, Ausgangsanimationen, gestengesteuerte WerteMotion (motion.dev)

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

Wenn die Aufgabe eine Komponente und keine Animation benötigt – einen Toast, einen Drawer, ein Befehlsmenü, ein Dropdown – verwende @asym/ui und Base UI wieder. Rufe pick-ui-library nicht auf, es sei denn, der Benutzer hat explizit gefragt, welche Bibliothek verwendet werden soll. Eigenbau ist, wie man bei einem <div>-Dropdown ohne Fokusverwaltung landet.

4. Wähle die Eigenschaften

  • Nur transform und opacity. Sie überspringen Layout und Malen und laufen auf der GPU. width/height/margin/padding/top/left lösen alle drei aus. (clip-path ist die sanktionierte vierte – siehe RECIPES.md. height wird nur für Akkordeons 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 Popovers, Dropdowns, Menüs, Tooltips – var(--transform-origin) in Base UI. Modals sind ausgenommen; sie sind nicht an einem Auslöser verankert, bleiben also zentriert.
  • Prozentsätze in translate() sind relativ zur eigenen Größe des Elements – translateY(100%) bewegt sich um seine eigene Höhe, unabhängig vom Inhalt. Bevorzuge sie gegenüber fest codierten Pixeln.
  • In Motion sind x, y und scale unterstützte unabhängige Transforms. Sie sind leistungsstark. Verwende einen vollständigen transform-String nur, wenn die Animation auf dem Compositor bleiben muss, während der Hauptthread beschäftigt ist:
<motion.div animate={{ x: 100 }} />
<motion.div animate={{ transform: "translateX(100px)" }} />
  • Treibe niemals den Transform eines Kindes über eine CSS-Variable auf dem Elternteil – es berechnet die Stile für jedes Kind neu. Setze transform direkt auf das Element.

5. Easing und Dauer – oder eine Feder

Easing, in Entscheidungsreihenfolge:

SituationEasing
Eintritt oder Austrittease-out
Bewegung / Verformung auf dem Bildschirmease-in-out
Hover / Farbwechselease
Gleichmäßige Bewegung (Laufschrift, Fortschritt)linear
Standardease-out

Niemals ease-in bei UI. Es beginnt langsam und verzögert den genauen Moment, den der Benutzer beobachtet. ease-out bei 200 ms fühlt sich schneller an als ease-in bei 200 ms.

Integrierte CSS-Easings sind zu schwach. Verwende diese:

--ease-out-soft: cubic-bezier(0.22, 1, 0.36, 1); /* Core-Token; starkes ease-out für UI */
--ease-in-out-soft: 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) */

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

Dauer:

ElementDauer
Rückmeldung bei Tastendruckvar(--duration-press) (120 ms)
Tooltips, kleine Popoversvar(--duration-micro) (150 ms)
Dropdowns, Auswahlenvar(--duration-standard) (220 ms)
Modalsvar(--duration-modal) (220 ms)
Drawervar(--duration-drawer) (320 ms)
Marketing / erklärendKann länger sein

UI-Animationen bleiben unter 300 ms. Ein 180-ms-Dropdown wirkt reaktionsschneller als ein 400-ms-Dropdown.

Greife stattdessen zu einer Feder, wenn die Bewegung ein 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-ähnlich – einfacher zu verstehen
{ type: "spring", mass: 1, stiffness: 100, damping: 10 }  // traditionelle Physik – mehr Kontrolle

Halte den Bounce bei 0,1–0,3 und vermeide Bounce bei den meisten UI – reserviere ihn für Ziehen-zum-Schließen und verspielte Interaktionen.

6. Unterbrechung und Austritt

  • Übergänge, nicht Keyframes, für alles, das schnell ausgelöst wird – Toasts, Kippschalter, alles, was ein Benutzer zweimal pro Sekunde auslösen kann. Übergänge zielen vom aktuellen Wert neu; Keyframes starten von Null.
  • Federn für Gesten, weil sie Geschwindigkeit durch eine Unterbrechung tragen.
  • Tritt so aus, wie es eingetreten ist. Ein Toast, der von unten hereingleitet, verlässt durch den Boden. Symmetrische Pfade sind es, die Wischen-zum-Schließen offensichtlich machen.
  • Asymmetrisches Timing, wo der Benutzer entscheidet. Langsam in der bewussten Phase (ein Gedrückt-Halten-zum-Bestätigen-Drücken: 2 s linear), flott in der Systemantwort (Loslassen: 200 ms ease-out).

7. Reduzierte Bewegung und Zeiger-Gating

Wird mit der Animation ausgeliefert, jedes Mal.

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

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

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

Rezepte

Für fertig baubare Implementierungen der häufigen Fälle – Tastendruck, Dropdown, Tooltip, Modal, Drawer, Toast, Akkordeon, Staffelung, Gedrückt-Halten-zum-Bestätigen, Tab-Indikator, Scroll-Enthüllung, Ziehen-zum-Schließen – siehe RECIPES.md. Lade es, wann immer die Anfrage zu einer dieser Komponenten passt; beginne mit dem Rezept und nicht mit einer leeren Datei.

Niemals ausliefern

Selbstüberprüfung, bevor du fertig bist. Jedes davon 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
Integriertes ease-out bei einer bewussten Animationcubic-bezier(0.23, 1, 0.32, 1)
Animation bei einem Tastaturkürzel oder einer 100+/Tag-AktionKeine Animation
UI-Dauer über 300 ms ohne Grund150–250 ms
transform-origin: center bei einem auslöserverankerten Popovervar(--transform-origin) (Modals ausgenommen)
Keyframes bei Toasts, Kippschaltern, schnell ausgelösten ElementenCSS-Übergänge
Animieren von width/height/margin/padding/top/lefttransform / opacity
Motion x/y/scale-Eigenschaften unter LastVollständiger transform-String
Ungeschützte :hover-Bewegung@media (hover: hover) and (pointer: fine)
Fehlendes prefers-reduced-motionSanftere Variante, nicht null
Alles tritt auf einmal ein30–80-ms-Staffelung

Ausgabe

Schreibe den Code. Dann, in höchstens ein paar Zeilen:

  • Das Hürdenergebnis – Häufigkeitsstufe und den benannten Zweck. Wenn etwas in der Anfrage abgelehnt wurde, sage was und warum.
  • Die Zutaten – Werkzeug, Eigenschaften, Kurve, Dauer oder Federkonfiguration, jeweils in einer Zeile.
  • Was auf Gefühl überprüft werden sollte – wenn das Ergebnis von Gefühl abhängt, das du nicht am Code beurteilen kannst (ein Überblenden, der Bounce einer Feder, das Opazitäts-/Höhen-Gleichgewicht in einer eintretenden Liste), sage dies und verweise auf den Check: spiele es mit 2–5-facher Dauer oder im DevTools-Animation-Inspektor ab, gehe es Frame für Frame durch, teste Gesten auf einem echten Gerät und sieh es dir später noch einmal an.

Individual skills in this repo

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

Asymmetric-al/core

Build animations for Expo and React Native only, using Reanimated, Gesture Handler, Expo Router, and expo-haptics. Use when the target runtime is an Expo or React Native app. Do not use it for Core Next.js web motion; use `animate` for web. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

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.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

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.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

Asymmetric-al/core

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