Communitygithub.com

ayangabryl/seenry-skills

Entwickle, überprüfe oder recherchiere Interface-Bewegungen: Tastendruck-Feedback, Menüs, Tooltips, Dialoge, Sheets, Toasts, Akkordeons, Tabs, Seiten- und Shared-Element-Übergänge, Scrolleffekte, Drag & Gesten, Zahlen- und Symboländerungen. Entscheidet, ob etwas überhaupt animieren soll, und wählt dann das Werkzeug, die Eigenschaften, die Kurve, die Dauer oder den Spring, das Unterbrechungs- und Reduced-Motion-Verhalten – mit getesteten modernen CSS-Rezepten und ausführbaren Assets. Analysiert außerdem aufgezeichnete Bewegungen aus Seenry-Referenzen.

Was ist seenry-skills?

Das Skill 'Seenry Motion' ist ein umfassender Leitfaden und eine Entscheidungshilfe für die Erstellung von Interface-Animationen auf professionellem Niveau, vergleichbar mit Apple oder Linear. Es zwingt Entwickler dazu, in einer festgelegten Reihenfolge zu arbeiten: Zuerst wird anhand der Nutzungshäufigkeit entschieden, ob überhaupt animiert wird (Schritte 1-2), dann das günstigste Werkzeug gewählt (Schritt 3: von CSS-Transitions über die View Transitions API bis hin zu Motion-Bibliotheken), die richtigen Eigenschaften (translate, scale, rotate, opacity, clip-path, filter) und die passende Kurve/Dauer oder ein Spring (Schritt 4-5) sowie die Behandlung von Unterbrechungen und Exits (Schritt 6). Das Skill legt großen Wert auf Barrierefreiheit (prefers-reduced-motion) und liefert konkrete, getestete CSS-Rezepte, ausführbare Assets und eine 'Motion Judge'-Metrik, um die Qualität der Animationen von einer 7 ('korrekt, aber generisch') auf eine 9 ('herausragend') zu heben. Es unterstützt alle gängigen UI-Komponenten und plattformübergreifende Ansätze (Web Animations API, CSS, Motion-Bibliothek) und ist in den Referenzdokumenten der 'seenry-skills' umfangreich dokumentiert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ayangabryl/seenry-skills/tree/HEAD/skills/seenry-motion

In Ihrer bevorzugten KI fragen

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

Dokumentation

Seenry Motion

Bewegung existiert, um eine Veränderung zu erklären: wo etwas herkam, was die Eingabe bewirkt hat, in welchem Zustand sich die Benutzeroberfläche jetzt befindet. Baue jede Animation in der untenstehenden Reihenfolge; die Schritte 1 und 2 entscheiden, ob überhaupt Code geschrieben wird.

Triff die Entscheidung und formuliere sie in einem Satz; biete kein Menü von Bewegungsoptionen an. Erweitere die vorhandenen Bewegungs-Tokens und -Komponenten des Projekts, anstatt ein paralleles Set hinzuzufügen.

Die Bau-Sequenz

1. Soll es überhaupt animieren? Entscheide anhand der Häufigkeit.

Wie oft Leute es sehenEntscheidung
100+ mal am Tag (Befehlsmenü, Tastaturkürzel, Listennavigation mit Pfeilen)Keine Animation. Sofort.
Dutzende male am Tag (Hover, Tabs, Toggles)≤150ms nur auf Opazität und Farbe, oder nichts
Gelegentlich (Menüs, Dialoge, Sheets, Toasts)Standard-Bewegung aus der Tabelle unten
Selten (Onboarding, erster Erfolg, Leer-zu-Voll-Momente)Raum für Charakter

Tastaturgesteuerte Aktionen warten niemals auf eine Animation. Wenn die Wächter-Instanz Nein sagt, sag es und liefere die sofortige Zustandsänderung aus.

2. Benenne den Zweck in einem Wort: Feedback, Orientierung (wo es herkam oder hinging), Zustand, Kontinuität (einen ruckartigen Sprung vermeiden), Erklärung (nur für Marketing und Onboarding) oder Freude (nur seltene Momente). Kein Zweck, keine Animation. Daten, die Leute lesen, bewegen sich niemals aus Stilgründen.

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

BedarfWerkzeug
Hover, Druck, Farbe, Klassen- oder AttributumschaltungCSS-Transition
Eingang beim Mounten, Ausgang vor display: none, natives <dialog> und popoverCSS-Transition + @starting-style + allow-discrete
Höhe auf autointerpolate-size: allow-keywords, oder die Grid-0fr → 1fr-Spur
Routenänderungen, Liste → Detail, morphierende IndikatorenView Transitions API
Scroll-gebundene Effekteanimation-timeline: view() / scroll()
Programmatisch, abbrechbar, keine BibliothekWeb Animations (element.animate)
Springs mit Geschwindigkeit, Layout-Animation, Gesten, Präsenz in ReactMotion (motion.dev)
Eine ganze Komponente (Toast, Drawer, Befehlsmenü, Select)Eine gepflegte Bibliothek, siehe Bibliotheken

4. Wähle die Eigenschaften. Nur translate, scale, rotate, opacity, clip-path, filter. Nie von scale(0) starten: beginne bei 0.95–0.97 mit Opazität 0. Popovers skalieren von ihrem Auslöser (transform-origin auf der Auslöserseite); Dialoge skalieren von der Mitte. Prozentuale Translates (translate: 0 100%) bewegen sich um die eigene Größe des Elements.

5. Wähle die Kurve und Dauer oder einen Spring.

BewegungDauerEasing
Druck-Feedback100–160ms--ease-out
Tooltip, kleines Popover120–200ms--ease-out
Menü, Dropdown, Select150–250ms--ease-out
Dialog200–250ms--ease-out
Sheet, Drawer350–500ms--ease-drawer
Element, das sich über den Bildschirm bewegt, Morphs250–400ms--ease-in-out
Farbe, Hintergrund, Rahmen bei Hover150msease
Fortschritt, Laufschrift, Bestätigungs-füllung durch Haltenso lange wie die Arbeitlinear

--ease-out: cubic-bezier(0.23, 1, 0.32, 1), --ease-in-out: cubic-bezier(0.77, 0, 0.175, 1), --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1). Niemals ease-in bei Interface-Bewegungen: es verzögert genau den Moment, den die Leute beobachten. Bevorzuge Produkt-UI unter 300ms; längere Sheet-Reisen brauchen einen Grund. Ausgänge sind oft ~20–30% schneller als Eingänge, es sei denn, eine direkte Manipulation oder räumliche Beziehung rechtfertigt die gleiche Taktrate. Verwende einen Spring für alles, was der Benutzer zieht, schnippt oder auf halbem Weg umkehren kann: Motion {type: "spring", duration: 0.5, bounce: 0.2} (bounce 0 für Produkt-UI, ≤0.3 für spielerisch), oder die CSS linear()-Springs in Rezepten.

6. Plane Unterbrechung und Ausgang. Bevorzuge CSS-Transitions für umkehrbare Eigenschaftsänderungen, weil sie vom aktuellen Wert aus neu zielen. Wenn Geometrie oder Choreografie WAAPI benötigt, erfasse den aktuellen gerenderten Zustand, breche eigene Animationen ab oder ziele sie neu und schütze vor veralteten Abschlüssen. Eine zweite Eingabe kehrt die alte Anfrage um oder ersetzt sie, anstatt sich dahinter in die Warteschlange zu stellen. Veröffentliche den neuen logischen Zustand sofort; ein separater Präsentationszustand kann einen Ausgang gemalt lassen.

Verfeinere die unterbrochene Änderung. Verwende diese Prüfungen, wo sie in die Komponente passen. Sie sind Design-Heuristiken, kein garantierter Bewertungsmaßstab. Teste wiederholte Eingaben während des Ein- und Ausgangs, auch 50–150ms auseinander; zeichne tatsächliche Zeitmessungen auf, wenn du Zeitangaben machst.

  • Kontinuität und Semantik bewahren. Verwandte Tabs, Filter oder Statuszustände können sich eine einzelne Grid-Zelle teilen (display:grid, grid-area:1/1) und Opazität oder eine kleine Verschiebung übergehen. Halte inaktive Inhalte aus dem Fokus-Ordnung und Accessibility-Baum heraus; gemountet bedeutet nicht interaktiv. Eine schnelle Ausgangsphase (etwa 65–90ms) und eine eingehende 120–160ms können ein Ausgangspunkt sein, kein erforderliches Rezept. Hebe die Montierung auf oder verstecke sie nur, wenn der aktuelle Übergang es erlaubt; ein veralteter Abschluss darf niemals einen neueren Zustand verstecken. Explizit abbrechbare WAAPI und bewachte native Dialog-Ausgänge sind gültige Alternativen.
  • Das Ergebnis verständlich halten. Vermeide versehentliche leere Intervalle oder unlesbaren, konkurrierenden Text. Wähle Überlappung, eine kurze Überblendung oder einen sofortigen Austausch basierend auf dem Inhalt; eine Überblendung des gesamten Labels am Endpunkt kann sicherer sein, als Text durch Kunstwerke zu bewegen. Bewahre einen angemessenen statischen Hinweis, während Bewegung nicht verfügbar oder reduziert ist. Überprüfe die tatsächliche Lesbarkeit, anstatt eine Opazitätsschwelle als Beweis zu verwenden.
  • Eine Kopie eines reisenden Dings. Wenn sich ein Titel, Avatar oder Cover an einen neuen Ort bewegt, vermeide sichtbare doppelte Darstellung. Verstecke das Ziel, bis der Reisende landet, und entferne dann die temporäre Kopie. Verfolge den Text durch das Kunstwerk und die bewegliche Hülle; ein unbeschnittener Endpunkt beweist keinen lesbaren Pfad.
  • Das Label stimmt mit seinem Ergebnis überein. Ein Label wie "Als bezahlt markieren", das zu "Bezahlt" wird, folgt dem gleichen akzeptierten Anwendungszustand wie sein Ergebnis. Reserviere seinen Platz, wenn nützlich, und verhindere veralteten Text oder fokussierbare doppelte Labels. Verzögere keinen echten Erfolgszustand, nur um eine Dekoration zu beenden.
  • Sequenzen können abgebrochen werden. Tipp-Demos, gestaffelte Enthüllungen und Wiederholungen teilen sich einen Besitzer für anstehende Schritte. Pause, Umkehrung und neue Eingabe brechen veraltete Arbeit ab und zielen die sichtbare Bewegung von ihrem aktuellen Zustand aus neu. Ein veralteter Timeout darf keine pausierte Sequenz fortsetzen oder neuere Inhalte überschreiben.
  • Abgeschlossene Animationen freigeben. Stelle den endgültigen Zustand durch CSS oder festgelegte Stile her und gib dann endliche eigene WAAPI-Animationen frei, wenn angemessen. fill:forwards darf nicht weiterhin spätere Zustandsänderungen überschreiben. Überprüfe auf unerwartete Animationen, nachdem sich die Interaktion beruhigt hat, während du einen absichtlichen, ongoingen Ladeindikator bis zum Ende seiner Arbeit erlaubst.
  • Jede Bewegung erklärt eine Beziehung. Menüs wachsen von ihrem Auslöser, Panels von ihrem Rand, und verwandte Inhalte bewegen sich konsistent mit der Navigation. Verwende die Dauerbereiche oben als Ausgangspunkte; halte die wahrgenommene Reaktion sofortig und rechtfertige längere Reisen. Teste Unterbrechung und reduzierte Bewegung, anstatt eine feste Dauer als Qualitätsbeweis zu behandeln.

Eine 9 erreichen. Beim Motion Judge ist 7 korrekt, aber generisch, 8 ist klar erstklassig und 9 ist unverwechselbar auf dem Niveau von Apple oder Linear. Runden bleiben aus denselben wenigen Gründen bei 7–8 stecken. Behandele alle, bevor du einen Durchlauf ausgibst:

  • Eine Komponente nach der anderen. Beurteile jede Komponente einzeln mit --labels "<Row>", bis sie 9 erreicht, und behalte die beste Version jeder Komponente. Der Gesamtwert eines Katalogs folgt seinen schwächsten Zeilen, daher bewegt das Flicken vieler Zeilen auf einmal ihn nie, und eine Änderung, die eine Zeile senkt, wird rückgängig gemacht, selbst wenn der Richter sie vorgeschlagen hat.
  • Jede Korrektur anwenden, nicht nur die Hauptkorrektur. Kleine Punkte, die wiederkehren (Hover, Druck- und Schließsteuerungs-Feedback), halten states Runde für Runde auf 7. --prev <last motion.json> listet die Kriterien auf, die nicht gestiegen sind, und die Interaktionen, die erneut zu korrigieren gebeten wurden; check.mjs übergibt es automatisch.
  • Ein Problem, das nach seiner Korrektur zurückkehrt, ist strukturell. Eine Neubemessung kann keinen Pfad reparieren, der sich kreuzt. Gemeinsame Elemente behalten ihre relative Anordnung zwischen den Zuständen bei: Ein Titel unter seinem Cover bleibt im Detail-View darunter, so dass keiner durch den anderen geht.
  • Keine leeren Frames. In jedem gefilmten Moment (30–320ms) zeigt der geänderte Bereich echten Inhalt. Eine Hülle trägt ihren Inhalt, während sie wächst; eine Streaming-Antwort wächst aus ihren ersten Wörtern. Zeige niemals eine leere Antwortbox oder ein Skelett, das wartet und sich dann auflöst.
  • Eine ausgearbeitete Idee pro Komponente. Was bleibt, reist, und was neu ist, wird aus seiner Ursache geboren. Eine Überblendung, eine 4px-Verschiebung und ein Label-Tausch ergeben 7.
  • Schließe dort, wo es geöffnet wurde. Eine Fläche, die sich von einem Bedienelement aus öffnet, schließt an derselben Stelle: Das Bedienelement wird (oder wird an Ort und Stelle durch) seinen Schließer ersetzt, so dass die Hand niemals reist. Es muss nicht die gleiche Farbe behalten; es behält den Ort und die Größe.
  • Ein einzelner Durchlauf ist keine Bewertung. Ein einzelner Judge-Durchlauf (selbst ein Median von drei) bewegt sich um einen Punkt bei unverändertem Code. Akzeptiere eine 9 nur, wenn zwei separate Durchläufe beide sie erreichen, und vergleiche Versionen bei der gleichen Anzahl von Durchläufen.

7. Versende reduzierte Bewegung und Eingabesperre zusammen damit. Unter prefers-reduced-motion: reduce, entferne Bewegung, Parallaxe, Unschärfe und Schleifen; behalte kurze Opazitätsänderungen, die das Verständnis fördern. Sperre Hover-Bewegung mit @media (hover: hover) and (pointer: fine). Jede animierte Zustandsänderung hinterlässt auch einen statischen Hinweis (Label, Icon, Farbe) für den Fall, dass die Bewegung nicht ausgeführt wird.

Rezepte

Beginne mit Rezepten für Druck-Feedback, Menüs und Popovers, Tooltips, Dialoge, Sheets, Toasts, Akkordeons, gestaffelte Eingänge, Tab-Indikatoren, Seiten- und Shared-Element-Übergänge, Scroll-Enthüllungen, Icon-Wechsel, Zahlenänderungen, Halten-zum-Bestätigen, Ziehen-zum-Schließen (mit Geschwindigkeitsprojektion und Gummiband-Effekt), Überblendungsmaskierung, Themenwechsel und Unterdrückung des ersten Renderings. Die nativen CSS-Rezepte werden in Chromium von den Paket-Tests geübt.

Ausführbare Assets

Gewünschte ÄnderungFokussierte Route
Aktionsmenü oder kurzes Status-LabelOriginal Aktionsmenü, Status-Schalter und Produktübergänge. Wenn das Menü gebeten wird, offen und geschlossen zu animieren, bewahre seine Fläche während der Schließphase; bedingtes Unmounten beim Schließen überspringt diese Phase. Für einen Status-Übergang bewege den Text in einem reservierten Slot; ein einfacher Textersatz oder eine Punktfarbenänderung allein ist unvollständig. Die Anwendung besitzt die eigentliche Aktion.
In-Flow-Offenlegung oder sich ändernde GeometrieOriginal Erweiterungskarte, Geometrie-Helfer und Flächenmuster. Bewahre den Fokus und ziele von der aktuellen Geometrie aus neu.
Fokussierte modale AufgabeOriginal Modale Fläche und Flächenmuster. Verwende einen natives Dialog für Top-Layer- und Fokus-Verhalten; erlaube dem Ausgang, vor dem Schließen zu enden, und mache eine Umkehrung zum Abbruch des anstehenden Schließens.
Sich ändernde Zahl oder SymbolZahlenübergänge und Adapter. Für eine kleine ganzzahlige Anzahl bevorzuge den originalen Count-Pop-Helfer gegenüber dem Neuaufbau von Ziffern-Semantik. Behalte einen echten zugänglichen Wert; verstecke nicht jede Ziffer und setze aria-label auf ein einfaches <strong>. Ein Ziffernübergang braucht eine Bewegung pro Stelle; halte Einheiten verankert.
Live-Spracheingabe oder -ausgabeOriginal Sprachpräsenz akzeptiert anwendungseigenen Zustand und einen normalisierten Audiopegel. Halte Bedienelemente und Ansagen im DOM; ein generiertes Demosignal ist keine Mikrofonaktivität.
Lade- oder ProzesspräsenzOriginal Signalfeld, Grenzspur und Lademuster. Animationszeit ist kein Fortschritt.
Dekodiertes Bild oder ausdrucksstarkes MaterialOriginal Bildenthüllung, Reflektierende feste und Randflächen, Zeigerneigung, Flächeneffekte und Ausdrucksstarke Effekte. Halte nützlichen Inhalt, während ein Ersatz geladen wird; verwende Reflexion und Neigung nur dort, wo das Material einen Zweck hat.
Entwerfen einer neuen interaktiven Komponente (Kurzbeschreibung, Zustandsgraph, Bewegungsbewertung, Eingabevertrag, Checkliste)Interaktions-Handwerk
Toast- oder Banner-StapelFeedback-Muster und originaler Benachrichtigungs-Reduzierer. Entferne Overflow aus dem aktiven Zustand vor seinem Ausgang; teste das vierte Ereignis in einem Drei-Artikel-Stapel.
Gelegentlich abgeschlossener MeilensteinOriginal Bestätigungsstoß. Zeichne den Erfolg zuerst im Anwendungszustand auf, spiele dann die endliche Dekoration ab; das endgültige Ergebnis muss sichtbar bleiben, nachdem es gelöscht ist.
Ausgewählte Tabs oder geordnete SeitenänderungOriginal Auswahlfläche für eine gemeinsame Hervorhebung und Richtungsbühne für verwandte Ansichten; die Anwendung besitzt Auswahl, Panels, Route und Verlauf. Verwende Navigationsmuster für andere Strukturen.
Scroll oder ein koordiniertes SystemScroll-Choreografie, Erarbeitete Bewertungen, System-Choreografie und der Bewegungsindex.

Wähle nur den Leitfaden und Helfer aus, der für diese Änderung benötigt wird. Die gebündelten Original-Assets sind wiederverwendbare Ausgangspunkte, keine automatischen Ersatz für eine benannte Quellkomponente oder ein Nachweis der Genauigkeit gegenüber ihr. Behalte Lizenzen bei kopierter Drittanbieter-Laufzeit; die originalen Seenry-Assets verwenden die MIT-Lizenz des Repositories.

Niemals ausliefern

NiemalsStattdessen
Animation bei einer 100+/Tag oder tastaturgesteuerten AktionSofortige Änderung
transition: allBenenne die animierten Eigenschaften einzeln
Einen View-Ausgang allein auf opacity 0 zu setzen, oder ihn im Ausgang auf display: none zu setzen, bevor die Staatstransition abgeschlossen istAnimieren mit @starting-style und allow-discrete
Ein Shared-Element horizontal und vertikal zu verschieben, wenn die neue Position eine einzelne CSS-Eigenschaft sein kann (object-position, object-view-box im Detail-View)Verwende die View Transitions API mit view-transition-class und ::view-transition-old/new(*), oder eine benutzerdefinierte Animation in JavaScript mit Motion oder WAAPI
Benutzerdefinierte prefers-reduced-motion auf einer @starting-style-Regel, die bei reduce ausblendetVerwende eine @media (prefers-reduced-motion: reduce)-Regel, die die Animation auf eine einfache Opazität oder Farbe reduziert, anstatt sie zu entfernen
Zahlen oder Text mit transform bei Änderung des Inhalts zu animierenVerwende einen reservierten Slot für den Text und animiere die Position des Slots, oder verwende einen Zahlenübergang-Helfer, der die Ziffern einzeln behandelt
Eine WAAPI-Animation auf ein Element zu setzen, das sich bereits in transition: all befindetBeende die CSS-Transition und dann die WAAPI-Animation; stelle eine saubere Trennung sicher
popover mit false zu setzen, während eine Transition läuftErlaube dem Ausgang, zu Ende zu gehen; wenn ein alternativer Zustand die Transition stört, überprüfe mit einem Event-Listener oder einem Timeout
Eine Animation für einen Fortschrittsindikator zu verwenden, der keine echte Arbeit widerspiegeltVerwende eine CSS-Animation oder einen Laufschrift-Effekt, der die Präsenz anzeigt, aber nicht die Dauer der Arbeit vorgibt
Eine Animation auf einer :focus-visible-Regel mit einem outline- oder box-shadow-Übergang zu verwenden, wenn das Element keine echte Fokusänderung hatVerwende outline nur für echte Fokusänderungen; animiere Farbe oder Opazität für subtiles Feedback

Verwandte Skills