Communitygithub.com

Motion Craft – GPU-beschleunigte Web-Animationen

Erstelle GPU-beschleunigte Animationen mit der Web Animations API (WAAPI), scrollgesteuerten Animationen (ScrollTimeline/ViewTimeline), der FLIP-Technik, Easing-Systemen und Barrierefreiheit (prefers-reduced-motion). Verwende dies, wenn der Benutzer Animationen, Übergänge, Scrolleffekte, Seitenübergänge oder interaktive Bewegungen für Web-Oberflächen erstellen möchte. Nicht verwenden für Canvas-basierte Animationen (Three.js, PixiJS), Videobearbeitung oder plattformfremdes Motion Design.

Was ist Motion Craft – GPU-beschleunigte Web-Animationen?

Motion Craft ist eine umfassende Skill-Richtlinie für die Entwicklung von Web-Animationen, die auf Leistung, Barrierefreiheit und Benutzerfreundlichkeit ausgelegt ist. Der Skill besteht aus einem Entscheidungsrahmen, der Entwickler durch vier Kernfragen führt: ob eine Animation überhaupt benötigt wird, welchen Zweck sie erfüllt, welche Easing-Funktion und Dauer angemessen sind. Er umfasst detaillierte Tabellen für Easing-Kurven (ease-out, ease-in, ease-in-out und benutzerdefinierte starke Varianten) sowie empfohlene Animationsdauern für verschiedene UI-Elemente (Tasten, Tooltips, Dropdowns, Modale, Toasts, Seitenübergänge). Der Skill erklärt die 60fps-Goldene Regel und betont, dass nur die Eigenschaften transform und opacity hardwarebeschleunigt sind und andere Eigenschaften Layout-Neuberechnungen auslösen. Er enthält ein zwingendes Review-Format mit einer Markdown-Tabelle (Before | After | Why), um Animationen systematisch zu verbessern. Behandelt werden CSS-Transitions (unterbrechbar, bevorzugt für UI), CSS-Keyframes, Spring-Animationen, die Web Animations API (WAAPI), scrollgesteuerte Animationen (ViewTimeline/ScrollTimeline), die FLIP-Technik für Layout-Animationen, Clip-Path-Animationen und wahrgenommene Leistung. Der Skill unterstützt Barrierefreiheit über prefers-reduced-motion und enthält Codebeispiele für alle Techniken. Unterstützte Plattformen: Web (Chrome/Edge für scrollgesteuerte Animationen, mit JS-Fallbacks für Firefox/Safari); nicht geeignet für Canvas-, Video- oder native mobile Anwendungen. Der Skill verwendet benutzerdefinierte CSS-Variablen für Easing und empfiehlt die Verwendung von Tools wie easing.dev und easings.co.

Funktioniert mit~Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/EliasOulkadi/shokunin/tree/HEAD/.pack/skills/motion-craft

In Ihrer bevorzugten KI fragen

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

Dokumentation

Motion Craft

Animationen, die kommunizieren, nicht dekorieren. Jeder Frame muss sich seinen Platz verdienen.

Inspiriert von Emil Kowalski (Linear, Sonner, Vaul), Paul Lewis (Google Chrome) und der CSS Animation Working Group.

Arbeitsablauf

Der Animations-Entscheidungsrahmen

Bevor du Animationscode schreibst, beantworte diese vier Fragen in der Reihenfolge.

1. Sollte das überhaupt animieren?

HäufigkeitEntscheidungGrund
100+ Mal/Tag (Tastenkombinationen, Befehlspalette, Suchumschalter)Keine Animation. Niemals.Animation lässt häufige Aktionen verzögert wirken. Raycast hat keine Öffnungs-/Schließanimation. Optimal.
Dutzende Male/Tag (Hover-Effekte, Listennavigation)Entfernen oder drastisch reduzierenBenutzer bemerken Animationslatenz bei wiederholten Interaktionen
Gelegentlich (Modale, Schubladen, Toasts)Standard-AnimationDer richtige Ort für Bewegung
Selten / zum ersten Mal (Onboarding, Bestätigung, Feier)Freude hinzufügenDiese Momente verdienen längere, reichhaltigere Animationen

Animieren Sie niemals tastaturinitiierte Aktionen. Diese wiederholen sich hunderte Male täglich.

2. Was ist der Zweck?

Jede Animation muss eine klare Antwort auf "warum animiert das?" haben.

ZweckBeispielGültig?
Räumliche KonsistenzToast kommt und geht aus derselben Richtung?
ZustandsanzeigeButton morphiert, um "gesendet" anzuzeigen?
FeedbackButton skaliert beim Drücken herunter und bestätigt, dass die Schnittstelle den Benutzer gehört hat?
Verhindern von ruckartigen ÄnderungenElemente blenden ein, anstatt abrupt zu erscheinen?
ErklärungMarketing-Animation, die zeigt, wie eine Funktion funktioniert?
"Es sieht cool aus" UND der Benutzer sieht es oftÜberflüssige Bewegung?

3. Welches Easing sollte verwendet werden?

SzenarioEasingCSS
Element tritt einease-out (startet schnell, fühlt sich reaktionsschnell an)cubic-bezier(0, 0, 0.2, 1)
Element tritt ausease-in (startet langsam, erregt kurz Aufmerksamkeit, beschleunigt dann weg)cubic-bezier(0.4, 0, 1, 1)
Bewegung / Morphing auf dem Bildschirmease-in-outcubic-bezier(0.4, 0, 0.2, 1)
Hover / Farbwechseleasecubic-bezier(0.25, 0.1, 0.25, 1)
Gleichmäßige Bewegung (Laufband, Fortschrittsbalken)linearcubic-bezier(0, 0, 1, 1)
UI-Interaktionen (Buttons, Tooltips, Dropdowns)starkes ease-outcubic-bezier(0.23, 1, 0.32, 1)

Kritisch: Verwende niemals ease-in für eingehende UI-Animationen. Ein Dropdown mit ease-in bei 300ms fühlt sich langsamer an als ease-out bei denselben 300ms, weil ease-in die anfängliche Bewegung verzögert – genau den Moment, den der Benutzer am genauesten beobachtet.

4. Wie schnell sollte es sein?

ElementDauerEasing
Tastendruck-Feedback (Skalierung)100-160mscubic-bezier(0.23, 1, 0.32, 1)
Tooltip ein / aus125-200mscubic-bezier(0.23, 1, 0.32, 1)
Dropdown / Select / Popover150-250mscubic-bezier(0.23, 1, 0.32, 1)
Hover-Transform (Skalierung, Anheben)200mscubic-bezier(0.23, 1, 0.32, 1)
Modal / Dialog ein200-300mscubic-bezier(0, 0, 0.2, 1)
Modal / Dialog aus150-200mscubic-bezier(0.4, 0, 1, 1)
Drawer / Sheet ein200-400mscubic-bezier(0.32, 0.72, 0, 1) (iOS-ähnlich)
Toast ein300-400mscubic-bezier(0.23, 1, 0.32, 1)
Toast aus200-300mscubic-bezier(0.4, 0, 1, 1)
Seitenübergang300-400mscubic-bezier(0.4, 0, 0.2, 1)
Scroll-Enthüllung (Einblenden + nach oben schieben)400-800mscubic-bezier(0.16, 1, 0.3, 1)
Lade-Shimmer1000-1500ms (unendlich)linear
Halten zum Löschen (drücken)2000mslinear (absichtlich)
Halten zum Löschen (loslassen)200mscubic-bezier(0.23, 1, 0.32, 1) (schnell)
Marketing / erklärend800-3000msvariabel, abhängig von der Erzählung

Regel: UI-Animationen sollten unter 300ms bleiben. Ein 180ms Dropdown fühlt sich merklich reaktionsschneller an als eines mit 400ms.

Benutzerdefinierte Easing-Kurven

Die integrierten CSS-ease / ease-in / ease-out sind zu schwach. Verwende diese stärkeren benutzerdefinierten Varianten:

:root {
  --ease-out-strong: cubic-bezier(0.23, 1, 0.32, 1);     /* UI-Interaktionen, Emil's Signatur */
  --ease-in-out-strong: cubic-bezier(0.77, 0, 0.175, 1);  /* Bewegung auf dem Bildschirm */
  --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1);          /* iOS-ähnlicher Drawer */
  --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);         /* Langsame Enthüllungen, dramatisch */
  --ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1);       /* Alternative starke ease-out */
  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);       /* Leichtes Überschwingen, sparsam */
}

Quellen: easing.dev, easings.co


Die 60fps-Goldene Regel

16,67ms pro Frame. Mit dem Chrome DevTools Performance Tab überprüfen. Nur transform und opacity animieren.

EigenschaftGPU-Composite?Auslöser
transform (translate, scale, rotate)? JaNur Composite
opacity? JaNur Composite
filter?? ManchmalPaint + Composite
clip-path?? ManchmalPaint + Composite
width, height, top, left, margin, padding, border-width? NeinLayout + Paint + Composite
box-shadow? NeinPaint + Composite
color, background-color? NeinNur Paint

Überprüfungsformat (Erforderlich)

Wenn UI-Animationscode überprüft wird, MUSS eine Markdown-Tabelle mit den Spalten Before | After | Why verwendet werden. Verwende KEINE Liste mit "Before:" und "After:" in separaten Zeilen.

Korrektes Format:

BeforeAfterWhy
transition: all 300mstransition: transform 200ms ease-outGebe genaue Eigenschaften an; vermeide all, das Layout-Neuberechnungen auslöst
transform: scale(0)transform: scale(0.95); opacity: 0Nichts in der realen Welt erscheint aus dem Nichts
ease-in bei Dropdowncubic-bezier(0.23, 1, 0.32, 1)ease-in startet langsam – fühlt sich träge an. Starkes ease-out gibt sofortiges Feedback
Kein :active-Status bei Buttontransform: scale(0.97) bei :activeButtons müssen sich beim Drücken reaktionsschnell anfühlen
transform-origin: center bei Popovertransform-origin: var(--radix-popover-content-transform-origin)Popovers sollten von ihrem Auslöser skalieren. Modale bleiben zentriert.
transition: 300ms ohne prefers-reduced-motion@media (prefers-reduced-motion: reduce) { transition-duration: 0.01ms }WCAG 2.1 erfordert Reduced-Motion-Unterstützung
animate={{ x: 100 }} in Framer Motionanimate={{ transform: "translateX(100px)" }}Framer Motion x/y sind NICHT hardwarebeschleunigt. Verwende transform-String für GPU.

Falsches Format (niemals so machen):

Before: transition: all 300ms
After: transition: transform 200ms ease-out

CSS-Transitions (bevorzugt für UI)

CSS-Transitions sind unterbrechbar – sie können mitten in der Animation neu ausgerichtet werden. Keyframes starten von Null. Für jede Interaktion, die schnell ausgelöst werden kann (Toasts, Toggles, Dropdowns), liefern Transitions glattere Ergebnisse.

.button {
  transition: transform 160ms ease-out;
}
.button:active {
  transform: scale(0.97);
}

.tooltip {
  transition: transform 125ms ease-out, opacity 125ms ease-out;
  transform-origin: var(--transform-origin);
}

Asymmetrisches Ein-/Aus-Timing

Eintreten kann langsamer sein (Benutzer entscheidet), Austreten muss schnell sein (System reagiert):

.overlay {
  transition: clip-path 200ms ease-out;  /* loslassen: schnell */
}
.button:active .overlay {
  transition: clip-path 2s linear;       /* drücken: langsam und bewusst */
}

Tooltips: Verzögerung bei nachfolgenden Hover-Vorgängen überspringen

.tooltip {
  transition: transform 125ms ease-out, opacity 125ms ease-out;
  transform-origin: var(--transform-origin);
}
.tooltip[data-instant] {
  transition-duration: 0ms;
}

Eintrittszustände mit @starting-style (nur Chrome, Stand 2026, noch nicht Baseline)

.toast {
  opacity: 1;
  transform: translateY(0);
  transition: opacity 400ms ease-out, transform 400ms ease-out;

  @starting-style {
    opacity: 0;
    transform: translateY(100%);
  }
}

Hinweis: @starting-style und scrollgesteuerte Animationen (animation-timeline: view(), animation-timeline: scroll()) sind Stand 2026 nur in Chrome verfügbar. Verwende JavaScript-Fallbacks für browserübergreifende Unterstützung.

Halten-zum-Löschen-Muster

.overlay {
  clip-path: inset(0 100% 0 0);
  transition: clip-path 200ms ease-out;   /* loslassen: schnell */
}
.button:active .overlay {
  clip-path: inset(0 0 0 0);
  transition: clip-path 2s linear;        /* drücken: langsam und bewusst */
}

BUTTONS - Taktiles Feedback

Jedes drückbare Element braucht eine physische Reaktion.

.button {
  transition: transform 160ms cubic-bezier(0.23, 1, 0.32, 1);
}
.button:active {
  transform: scale(0.97);
}

Die Skalierung muss dezent sein (0,95-0,98). Angewendet auf alle drückbaren Elemente – Buttons, Karten, Listenelemente, Tabs.


POPOVERS - Ursprungsbewusst

Popovers skalieren von ihrem Auslöser, nicht von der Mitte. Modale bleiben zentriert.

/* Radix UI */
.popover {
  transform-origin: var(--radix-popover-content-transform-origin);
}
/* Base UI */
.popover {
  transform-origin: var(--transform-origin);
}
/* Modale (immer zentriert) */
.modal {
  transform-origin: center;
}

Ob der Benutzer es einzeln bemerkt, spielt keine Rolle. In der Summe potenzieren sich unsichtbare Details.


Gestaffelte Animationen

Wenn mehrere Elemente gleichzeitig eintreten, staffele ihr Erscheinen.

.item {
  opacity: 0;
  transform: translateY(8px);
  animation: fadeIn 300ms ease-out forwards;
}
.item:nth-child(1) { animation-delay: 0ms; }
.item:nth-child(2) { animation-delay: 50ms; }
.item:nth-child(3) { animation-delay: 100ms; }
.item:nth-child(4) { animation-delay: 150ms; }

@keyframes fadeIn {
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

Halte die Staffelungsverzögerungen kurz (30-80ms zwischen den Elementen). Blockiere niemals Interaktionen, während die Staffelung läuft.


CSS-Animationen (Keyframes)

Verwende für vorbestimmte, nicht-dynamische Animationen. Keyframes starten bei Unterbrechung von Null – vermeide für UI.

@keyframes enter-right {
  from { opacity: 0; transform: translateX(16px); }
  to   { opacity: 1; transform: translateX(0); }
}
.enter {
  animation: enter-right 300ms ease-out forwards;
}

Spring-Animationen

Springs fühlen sich natürlicher an als dauerbasierte Animationen, da sie reale Physik simulieren. Sie behalten die Geschwindigkeit bei Unterbrechung bei.

Wann Springs verwendet werden sollten

  • Drag-Interaktionen mit Schwung
  • Elemente, die sich "lebendig" anfühlen (Apple Dynamic Island-Stil)
  • Gesten, die mitten in der Animation unterbrochen werden können
  • Dekorative Mausverfolgungs-Interaktionen

Apple-Ansatz (empfohlen – einfacher zu durchdenken)

{ type: "spring", duration: 0.5, bounce: 0.2 }

Traditionelle Physik (mehr Kontrolle)

{ type: "spring", stiffness: 100, damping: 10, mass: 1 }

Halte das Überschwingen dezent (0,1-0,3). Vermeide Überschwingen in den meisten UI-Elementen. Verwende nur für Ziehen-zum-Schließen und verspielte Interaktionen.

Federbasierte Mausinteraktionen

import { useSpring } from 'framer-motion'

const springX = useSpring(mouseX * 0.1, { stiffness: 100, damping: 10 })

Ohne Spring: fühlt sich künstlich an, sofortig. Mit Spring: fühlt sich natürlich an, hat Schwung.


WEB ANIMATIONS API (WAAPI)

Programmatische CSS-Animationen. Hardwarebeschleunigt, unterbrechbar, keine Bibliothek erforderlich.

const element = document.querySelector('.card')

const animation = element.animate([
  { transform: 'scale(1)', opacity: 1 },
  { transform: 'scale(0.95)', opacity: 0.7 },
], {
  duration: 200,
  easing: 'cubic-bezier(0.23, 1, 0.32, 1)',
  fill: 'both',
})

animation.pause()
animation.play()
animation.reverse()
animation.finish()
animation.finished.then(() => console.log('fertig'))

WAAPI schlägt Framer Motion unter starker Last – es läuft außerhalb des Hauptthreads. Verwende für dynamische, unterbrechbare Animationen, bei denen CSS-Keyframes an ihre Grenzen stoßen.


SCROLLGESTEUERTE ANIMATIONEN

Hinweis zur Browserunterstützung: Scrollgesteuerte Animationen (animation-timeline: view() und scroll()) sind Stand 2026 nur in Chrome/Edge verfügbar, noch nicht Baseline. Stelle JS-Fallbacks über IntersectionObserver für Firefox/Safari bereit.

ViewTimeline (Element tritt in Viewport ein / verlässt ihn)

@keyframes fade-up {
  from { opacity: 0; transform: translateY(20px); }
  to   { opacity: 1; transform: translateY(0); }
}
.reveal {
  animation: fade-up 600ms linear both;
  animation-timeline: view();
  animation-range: entry 0% entry 100%;
}

ScrollTimeline (Bildlaufposition der Seite)

@keyframes shrink {
  from { height: 80px; }
  to   { height: 50px; }
}
.site-header {
  animation: shrink 300ms linear both;
  animation-timeline: scroll();
  animation-range: 0 200px;
}

Scroll-verknüpfter Parallax-Effekt (Vanilla JS)

const layers = document.querySelectorAll('[data-parallax]')
window.addEventListener('scroll', () => {
  const scrollY = window.scrollY
  layers.forEach(layer => {
    const speed = parseFloat(layer.dataset.parallax) || 0.3
    layer.style.transform = `translateY(${scrollY * speed}px)`
  })
})

FLIP-Technik

Für Layout-Animationen – animieren von Elementen, die Position/Größe ändern.

function animateLayout(element, callback) {
  const first = element.getBoundingClientRect()
  callback()
  const last = element.getBoundingClientRect()

  const dx = first.left - last.left
  const dy = first.top - last.top
  const dw = first.width / last.width
  const dh = first.height / last.height

  element.animate([
    { transform: `translate(${dx}px, ${dy}px) scale(${dw}, ${dh})` },
    { transform: 'translate(0, 0) scale(1, 1)' },
  ], {
    duration: 300,
    easing: 'cubic-bezier(0.4, 0, 0.2, 1)',
  })
}

CLIP-PATH für Animationen

Eines der leistungsstärksten Animationswerkzeuge in CSS. Hardwarebeschleunigt.

.overlay {
  clip-path: inset(0 100% 0 0);
  transition: clip-path 200ms ease-out;
}
.visible {
  clip-path: inset(0 0 0 0);
}

Verwende für: Halten-zum-Löschen, Bildenthüllungen beim Scrollen, Vergleichsregler, nahtlose Farbübergänge bei Tabs.


WAHRGENOMMENE LEISTUNG

Geschwindigkeit in der Animation wirkt sich direkt darauf aus, wie …

Individual skills in this repo

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

Verwandte Skills