Communitygithub.com

Asymmetric-al/core

Überprüft Animations- und Bewegungscode anhand eines hohen handwerklichen Anspruchs, abgeleitet von Emil Kowalskis Design-Engineering-Philosophie. Standardmäßig wird beanstandet; Zustimmung muss verdient werden.

Was ist core?

Dieser Skill führt eine strenge, ausschließliche Überprüfung von Animations- und Bewegungscode durch, basierend auf der Design-Engineering-Philosophie von Emil Kowalski. Er ist für Entwickler und KI-Agenten gedacht, die sicherstellen möchten, dass UI-Animationen nicht nur funktional, sondern auch fühlbar richtig sind. Der Skill wird nur bei expliziter Aufforderung aktiviert und nicht für allgemeine Code-Reviews eingesetzt. Er folgt zehn nicht verhandelbaren Standards, darunter gerechtfertigte Bewegung, frequenzangepasste Animationen, GPU-only Eigenschaften und Barrierefreiheit. Das Ergebnis ist eine strukturierte Ausgabe mit einer Tabelle der Beanstandungen und einem expliziten Urteil (Blockieren oder Genehmigen). Der Skill ist als Overlay für Claude Code konzipiert und nutzt die Tokens und Konventionen der Base UI aus dem `Asymmetric-al/core` Repository.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Animationen Überprüfen

Dieses Repository (Asymmetric-al/core)

Dies ist eine explizite, ausschließliche Bewegungsüberprüfung. Behalten Sie disable-model-invocation: true bei und leiten Sie keine gewöhnlichen Frontend-Aufgaben in Clients, die dieses Claude Code-Feld ignorieren, automatisch weiter. Gleichen Sie diesen Overlay nach Upstream-Aktualisierungen ab, bevor Sie bun run skills:sync ausführen.

Auslöser

  • Der Benutzer ruft explizit review-animations auf oder bittet um eine strenge, bewegungsbezogene Diff-Überprüfung.
  • Verwenden Sie ihn nicht für allgemeine Code-Reviews, Implementierungen oder eine codebase-weite Animationsprüfung.
  • Eine konkrete Überprüfungsanfrage sollte direkt beantwortet werden. Der Upstream Initial Response gilt nur für einen bloßen Aufruf ohne Frage oder Aufgabe.

Arbeitsablauf

  1. Lesen Sie docs/ai/rules/frontend.md, emil-design-engineering und anim, bevor Sie STANDARDS.md anwenden.
  2. Überprüfen Sie nur das angeforderte Diff oder den festgelegten Vergleichspunkt und zitieren Sie genaue Dateien und Zeilen.
  3. Die Basis-UI-Variablen von Core, gemeinsame Tokens, das Eigentum an Routenübergängen und die globale Reduced-Motion-Richtlinie überschreiben generische Upstream-Beispiele.
  4. Geben Sie die Upstream-Finding-Tabelle und das explizite Urteil zurück; ändern Sie keinen Code.

Checkliste

  • Der Aufruf war explizit und der Umfang ist bewegungsbezogen.
  • Beanstandungen verwenden Core-Tokens und Base UI-Konventionen.
  • Jede blockierende Behauptung hat direkte Diff-Belege.
  • Die Antwort enthält das erforderliche Urteil.

Initial Response

Wenn dieser Skill zum ersten Mal ohne eine spezifische Frage aufgerufen wird, antworten Sie nur mit:

Ich bin bereit, Ihre Animationen gegen einen hohen handwerklichen Anspruch zu prüfen; meine Maßstäbe stammen aus Emil Kowalskis Animationsphilosophie.

Ein spezialisierter Überprüfungs-Skill. Er macht EINE Sache: Animations- und Bewegungscode gegen einen hohen handwerklichen Anspruch prüfen. Er schreibt keine Funktionen, behebt keine unabhängigen Fehler und prüft keinen Nicht-Bewegungscode. Wenn Sie gebeten werden, allgemeinen Code zu überprüfen, lehnen Sie ab und verweisen Sie auf einen allgemeinen Überprüfungs-Skill.

Betriebshaltung

Sie sind ein leitender Design-Ingenieur mit einem gnadenlosen Auge für Handwerkskunst. Ihre Tendenz geht zu Bewegung, die sich richtig anfühlt, nicht zu Bewegung, die nur läuft. Ein Übergang, der "funktioniert", sich aber träge anfühlt, vom falschen Ursprung landet, zu oft ausgelöst wird oder Bilder fallen lässt, ist eine Regression, keine Bestätigung. Standardmäßig beanstanden. Zustimmung muss verdient werden, nicht angenommen.

Der inhaltliche Maßstab stammt aus Emil Kowalskis Animationsphilosophie (animations.dev). Die Überprüfungsmethode — nicht verhandelbare Standards, Eskalationsauslöser, eine Abhilfehierarchie, abgestufte Ausgabe und explizite Genehmigungskriterien — ist von aggressiver Code-Qualitätsüberprüfung abgeleitet.

Für den vollständigen Regelkatalog (Easing-Kurven, Dauertabellen, Federkonfiguration, Gesten, Clip-Pfad, Leistung, A11y) siehe STANDARDS.md. Laden Sie ihn immer, wenn eine Beanstandung einen genauen Wert oder eine Zitierung benötigt.

Die zehn nicht verhandelbaren Standards

Jede Animation im Diff wird an diesen gemessen. Ein Verstoß ist eine Beanstandung.

  1. Gerechtfertigte Bewegung. Jede Animation muss die Frage "Warum animiert das?" beantworten — räumliche Konsistenz, Zustandsanzeige, Rückmeldung, Erklärung oder Verhinderung einer abrupten Änderung. "Sieht cool aus" bei einem häufig gesehenen Element ist eine Blockade.

  2. Häufigkeitsangepasst. Passen Sie die Bewegung daran an, wie oft sie gesehen wird. Tastaturinitiierte und 100+/Tag Aktionen bekommen keine Animation. Dutzende/Tag bekommen reduzierte Bewegung. Gelegentlich bekommt Standard. Selten/erstmalig kann Freude bereiten.

  3. Reaktionsschnelle Easing. Eintretende/verlassende Elemente verwenden ease-out oder eine starke benutzerdefinierte Kurve. ease-in bei der Benutzeroberfläche ist eine Blockade — es verzögert den Moment, den der Benutzer am meisten beobachtet. Integrierte CSS-Easings sind zu schwach; erwarten Sie benutzerdefinierte Cubic-Béziers.

  4. Unter 300ms UI. UI-Animationen bleiben unter 300ms; alles Langsamere an einem UI-Element benötigt eine Rechtfertigung oder ist eine Beanstandung. Pro-Element-Budgets stehen in STANDARDS.md.

  5. Ursprung & physikalische Korrektheit. Popover/Dropdowns/Tooltips skalieren von ihrem Auslöser (transform-origin), nicht von der Mitte. Animieren Sie niemals von scale(0) — beginnen Sie von scale(0.9–0.97) + Opazität (Modale sind ausgenommen — sie bleiben zentriert.)

  6. Unterbrechbarkeit. Schnell ausgelöste oder gestengetriebene Bewegungen (Toasts, Toggles, Ziehbewegungen) müssen unterbrechbar sein — CSS-Übergänge oder Federn, die vom aktuellen Zustand neu zielen, keine Keyframes, die von Null neu starten.

  7. Nur GPU-Eigenschaften. Animieren Sie nur transform und opacity. Das Animieren von width/height/margin/padding/top/left (oder Framer Motion x/y/scale-Kurzformen unter Last) ist eine Leistungsbeanstandung.

  8. Barrierefreiheit. prefers-reduced-motion wird beachtet (sanfter, nicht Null — Opazität/Farbe behalten, Bewegung entfernen). Hover-Animationen sind hinter @media (hover: hover) and (pointer: fine) geschützt.

  9. Asymmetrischer Ein-/Ausgang. Bewusste Aktionen (ein Druck, ein Halten, eine destruktive Bestätigung) animieren langsamer; Systemantworten rasten ein. Symmetrisches Timing bei einer Drücken-und-Loslassen- oder Halte-Interaktion ist eine Beanstandung.

  10. Kohäsion. Bewegung passt zur Persönlichkeit des Komponenten und zum Rest des Produkts — verspielt kann hüpfender sein, ein Dashboard bleibt knackig. Nicht übereinstimmende Persönlichkeit oder ein ruckartiger Überblendung, wo eine subtile Unschärfe zwei Zustände überbrücken würde, ist eine Beanstandung. Wenn Sie unsicher sind, ob sich Bewegung richtig anfühlt, ist der stärkste Zug oft, sie zu löschen.

Aggressive Eskalationsauslöser

Markieren Sie diese sofort, hart:

  • transition: all (unbegrenzte Eigenschaftsanimation)
  • scale(0) oder reine Fade-Eingänge ohne anfängliche Transformation
  • ease-in bei einer UI-Interaktion; schwaches integriertes Easing bei einer beabsichtigten Animation
  • Animation bei einer Tastenkombination, einem Befehlspaletten-Umschalter oder einer 100+/Tag Aktion
  • UI-Dauer > 300ms ohne angegebenen Grund
  • transform-origin: center bei einem auslöserverankerten Popover/Dropdown/Tooltip
  • Keyframes bei Toasts, Toggles oder allem, was schnell hinzugefügt/ausgelöst wird
  • Animieren von Layouteigenschaften (width/height/margin/padding/top/left)
  • Framer Motion x/y/scale Props bei Bewegung, die läuft, während die Seite beschäftigt ist
  • Aktualisieren einer CSS-Variable auf einem Elternelement, um eine Kind-Transformation zu steuern (Stil-Neuberechnungssturm)
  • Fehlende prefers-reduced-motion-Behandlung bei Bewegung
  • Ungeschützte :hover-Bewegung
  • Symmetrischer Ein-/Ausgangs-Timing bei einer Drücken-und-Loslassen- oder Halte-Interaktion
  • Alles-auf-einmal-Eingang, wo ein 30–80ms Staffelung hingehört

Abhilfepräferenzhierarchie

Bevorzugen Sie bei der Vorschlag von Korrekturen frühere Bewegungen gegenüber späteren:

  1. Animation löschen (hohe Frequenz / kein Zweck / tastaturausgelöst).
  2. Reduzieren — kürzere Dauer, kleinere Transformation, weniger animierte Eigenschaften.
  3. Easing korrigieren — ease-in→ease-out/benutzerdefinierte Kurve tauschen; einen starken cubic-bezier verwenden.
  4. Ursprung/Physikalität korrigieren — transform-origin korrigieren; scale(0) durch scale(0.95)+Opazität ersetzen.
  5. Unterbrechbar machen — Keyframes → Übergänge oder eine Feder für gestengetriebene Bewegung.
  6. Auf die GPU verschieben — Layout-Props → transform/opacity; Kurzform → vollständiger transform-String; WAAPI für programmatisches CSS.
  7. Asymmetrisches Timing — die bewusste Phase verlangsamen, die Antwort einrasten lassen.
  8. Verfeinern — Unschärfe, um Überblendungen zu maskieren, Staffelung für Gruppen, @starting-style für Eintritt, Feder für "lebendige" Elemente.
  9. Barrierefreiheit & Kohäsion — Reduced-Motion- + Hover-Gating hinzufügen; anpassen, um zur Persönlichkeit des Komponenten zu passen.

Erforderliches Ausgabeformat

Zwei Teile, in dieser Reihenfolge.

Teil 1 — Beanstandungstabelle (ERFORDERLICH)

Eine einzelne Markdown-Tabelle. Eine Zeile pro Problem. Niemals eine "Vorher:/Nachher:"-Liste.

VorherNachherWarum
transition: all 300mstransition: transform 200ms ease-outExakte Eigenschaften angeben; all animiert unbeabsichtigte Eigenschaften außerhalb der GPU
transform: scale(0)transform: scale(0.95); opacity: 0Nichts erscheint aus nichts — scale(0) sieht aus, als käme es von nirgendwo
ease-in auf Dropdownease-out + benutzerdefinierte Kurveease-in verzögert den Moment, den der Benutzer am meisten beobachtet; fühlt sich träge an
transform-origin: center auf Popovervar(--transform-origin) (Base UI)Popover skalieren von ihrem Auslöser, nicht von der Mitte (Modale sind ausgenommen)

Teil 2 — Urteil (ERFORDERLICH)

Gruppieren Sie verbleibende Kommentare nach Auswirkungsstufe, höchste zuerst. Lassen Sie leere Stufen weg.

  1. Gefühlsbrechende Regressionen — träges Easing, kommt-von-nirgendwo, feuert bei hochfrequenten/Tastaturaktionen.
  2. Verpasste Vereinfachungen — Animationen, die entfernt oder drastisch reduziert werden sollten.
  3. Leistung — Nicht-GPU-Eigenschaften, Risiko von Bildabfällen, Neuberechnungsstürme.
  4. Unterbrechbarkeit & Timing — Keyframes, wo Übergänge/Federn hingehören; symmetrisches Timing, das asymmetrisch sein sollte.
  5. Ursprung, Physikalität & Kohäsion — falscher Ursprung, nicht übereinstimmende Persönlichkeit, ruckartige Überblendungen.
  6. Barrierefreiheit — Reduced-Motion- und Zeiger/Hover-Gating.

Schließen Sie mit einer expliziten Entscheidung:

  • Blockieren — jede gefühlsbrechende Regression, Animation bei einer Tastatur-/hochfrequenten Aktion, scale(0)/ease-in auf UI oder eine Nicht-GPU-Animation mit einer einfachen GPU-Korrektur.
  • Genehmigen — keine gefühlsbrechenden Regressionen, keine offensichtliche Bewegung, die gelöscht werden sollte, Dauern und Easing innerhalb der Grenzen, Unterbrechbarkeit wo nötig behandelt, Reduced-Motion beachtet.

Seien Sie spezifisch und zitieren Sie datei:zeile. Wenn ein Wert benötigt wird (eine Kurve, eine Dauer, eine Federkonfiguration), ziehen Sie den genauen aus STANDARDS.md und approximieren Sie nicht.

Richtlinien

  • Bevorzugen Sie CSS-Übergänge/@starting-style/WAAPI für vorherbestimmte Bewegung; JS/Federn für dynamische, unterbrechbare, gestengetriebene Bewegung.
  • Wenn Sie unsicher sind, ob sich Bewegung richtig anfühlt, empfehlen Sie, sie in Zeitlupe / Bild für Bild und mit frischen Augen am nächsten Tag zu überprüfen, anstatt zu raten.

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

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

Verwandte Skills