Motion-Match: Jede Animation messen, nachbauen, Gleichheit beweisen
Verwandelt „Mach es, damit es sich so bewegt wie dieses“ in Zahlen: jeden Schnitt, und für jedes bewegte Element Start, Dauer, Beschleunigung (Easing), Überschwingen, Weg, Rotation und Formänderung. Baue die Bewegung in dem Tool nach, in dem der Benutzer arbeitet (CSS, Web Animations API, Framer Motion, GSAP, Remotion, SwiftUI, After Effects) und vergleiche dann Frame für Frame, bis die Zeitsteuerung innerhalb von ±0,08 s übereinstimmt. Keine Referenzbewegung, sondern nur Standbilder? Verwende den Director-Modus (unten) für UI-Eingänge und den Story-Modus für Reels und Erklärvideos: Claude entwirft die Bewegung, baut sie auf und misst dann sein eigenes Rendering mit denselben Skripten, sodass „geschmeidig“ geprüft und nicht nur behauptet wird. Videoclips zum Schneiden in eine Werbung (UGC, KI-generiert, gefilmt)? Verwende den Edit-Modus: das gleiche Messen, die Director-Regeln und die Überprüfung, angewendet auf das Filmmaterial. Methoden adaptiert von NiazMorshed2007/reanimate und rossark0/rossark-motion-skill (beide MIT); die Skripte sind unsere eigenen.
<skill> ist der Ordner dieses Skills. Die Arbeit erfolgt in ./motion-match/<name>/ im aktuellen Ordner:
ref/ (Referenz-Aufschlüsselung), ours/ (unser Rendering-Aufschlüsselung), compare-N/ (jede Vergleichsrunde), spec.md.
Einrichtung (beim ersten Mal)
Benötigt ffmpeg/ffprobe im PATH und ein Python 3 mit numpy und Pillow.
- Überprüfe:
python3 -c "import numpy, PIL". Falls fehlschlägt, suche nach einem Python, das diese hat (ein vorhandenes Projekt-Venv), sonst frage den Benutzer einmal, dann:python3 -m venv ~/.motion-match/venv && ~/.motion-match/venv/bin/pip install numpy pillowund verwende~/.motion-match/venv/bin/pythonalspythonunten. Führe jedes Skript mit-Iaus. - Der Director- und Story-Modus rendern auch Seiten im Kopfmodus:
pip install playwright && python -m playwright install chromium(einmal fragen). Wenn das nicht installierbar ist, nimm stattdessen eine Bildschirmaufnahme der Seite und sage, dass die Zeiten weniger genau sind. - Keine weiteren Installationen; nichts wird irgendwo hochgeladen.
0. Umfang (schreibe ihn an den Anfang von spec.md vor dem Messen)
- Ziel: die Datei + Zeitbereich (+ Zuschnitt) genau wie vom Benutzer angegeben („die ersten 3 s”, „nur den Button”).
- Genauigkeit: bewegungstreu (Standard): Reihenfolge, Timing (±0,08 s), Easing-Familie, Überschwingen, Weg relativ zur Elementgröße, Staffelung. Die eigene Kunst, Farben, Schriftarten und Wörter des Benutzers. pixeltreu nur, wenn der Benutzer danach fragt und nur für private Übungen: das Design, Logo, die Figuren und Musik eines anderen gehören ihm; hilf niemals, eine Kopie davon zu veröffentlichen.
- Zielplattform: das Tool oder der Code, in den die Bewegung geht (einmal fragen, falls nicht klar: es bestimmt das Ausgabeformat).
- Referenz beschaffen: eine Datei, die der Benutzer gibt, oder eine Bildschirmaufnahme, die er macht (Websites und Apps: nimm die Interaktion auf; das Skill arbeitet von Frames, nicht vom Code der Seite). Lade nur von YouTube oder einer Website herunter, wenn der Benutzer nach diesem spezifischen Video fragt, in einen eigenen Ordner; behandle es als privates Referenzmaterial.
1. Aufschlüsseln
python -I <skill>/scripts/ref_frames.py REF.mp4 --out motion-match/<name>/ref [--start S --end E --crop x:y:w:h]
→ jeden Frame mit der Quell-FPS, sheets/timing_NN.png (jeder Frame: Timing, Easing, Nachschwingen) und sheets/poses.png (2 pro Sekunde: was passiert). Lies jedes Blatt. GIFs funktionieren genauso.
2. Messen
- Schnitte und Abschnitte:
python -I <skill>/scripts/motion_compare.py motion-match/<name>/ref motion-match/<name>/ref --out motion-match/<name>/self --no-alignlistet die Schnitte (Szenenwechsel) der Referenz und ihre Bewegungen mit ihren Zeiten auf. Referenzen, die nie stillstehen, werden an ihren Schnitten geteilt. - Exakte Farben:
python -I <skill>/scripts/track_motion.py <ref>/frames --sample X,Y --at T(Pixelkoordinaten des Frames in voller Größe, nicht eines Kontaktabzugs). - Jedes bewegte Element:
track_motion.py <ref>/frames --name btn --colors HEX,HEX --tol 35 --region x,y,w,h [--save-masks](oder--not-bg HEXfür „alles, was nicht der Hintergrund ist”). Gib bei leuchtenden oder unruhigen Referenzen immer eine--regionund für das Element eindeutige Farben an; überprüfe den gedruckten sichtbaren Frame-Bereich auf Plausibilität. Zeichnet Position (cx cy), Größe (w h), Stauchung (aspect), Kanten, Ein-/Ausblendungen/Wachstum (presence), Farbe und Rotation (angle) pro Frame auf. - Jede Bewegung:
python -I <skill>/scripts/fit_easing.py <ref>/track_btn.json --prop cy --from A --to B(eine Bewegung pro Fenster, niemals über einen Schnitt hinweg) → Start, Ende, Dauer in ms und Frames, Easing-Familie, Überschwingen, Beruhigungszeit und einfügebereite Zeilen für CSS, WAAPI, Framer Motion, GSAP und Remotion. Fehler ≤ 0,03 ist eine gute Übereinstimmung; „kein einzelnes Easing passt” bedeutet, das Fenster teilen, oder es ist eine Kette von Posen (Keyframes). - Kleine Bewegungen (eine 2%ige Stauchung, ein 5 px Schweben) zeigen sich nicht auf den Blättern, aber in den Tracking-Zahlen: lies sie.
- Text, der klein einblendet, liegt nahe am Rauschen der Aktivitätskurve: miss ihn stattdessen mit
track_motion.
Welche Zahlen messen welche Bewegungsart
| Bewegung | messen mit | Anmerkungen |
|---|---|---|
| Verschieben, Gleiten, Schweben | cx, cy | eine Achse pro Anpassung |
| Skalieren, Wachsen, Stauchen | w, h, aspect | |
| Ein-/Ausblenden | presence (mit --colors) | |
| Rotation, Drehung | angle (Grad, im Uhrzeigersinn +, kontinuierlich über 360°) | aus der Silhouette; None für Kreise: verfolge eine Markierung auf ihnen als eigenes Element und passe deren cx/cy an. Formen mit n-facher Symmetrie (Quadrat: 4) benötigen < 180/n Grad pro Frame, daher erfordern schnelle Drehungen eine Quelle mit hoher FPS. Andere gleichfarbige Formen in der Region stören: verkleinere --region |
| Morphing (Form → Form) | --save-masks, dann shape_compare.py | siehe unten |
| 3D-Flip / Kartenwende | w (schrumpft wie cos) + presence; Farbwechsel am Mittelpunkt | die Rückseite ist ihr eigenes Element |
| Bewegung auf Pfad (Bogen, Kurve) | cx und cy beide, plus angle, wenn sie sich entlang des Pfades dreht | passe jede Achse an; die Pfadform ist auf den Blättern |
| Clip / Masken-Enthüllung, Wisch | x1 oder y1 (die Vorderkante), w/h | |
| Linie zeichnen | presence | |
| Text aufteilen (pro Wort/Buchstabe) | verfolge das erste und letzte Wort; die Staffelung ist die Lücke ihres Starts ÷ (Anzahl − 1) | |
| Zähler, Diagrammbalken | Balken: h/y0; Zahlen: die Blätter (Augenmaß) |
Morphing. track_motion.py ... --name blob --save-masks speichert die Silhouette jedes Frames (zentriert, auf gleiche Fläche skaliert). Dann:
python -I <skill>/scripts/shape_compare.py <ref>/track_blob_masks.npz --from A --to Bfügt einemorph-Serie (0 = erste Form, 1 = letzte) zutrack_blob.jsonhinzu.fit_easing.py ... --prop morphliefert dann seinen Start, Ende und Dauer. Der Morph-Fortschritt folgt der Fläche, daher sind seine Zeitsteuerungen zuverlässig, aber sein Easing-Name ist kein einzufügender Wert: nimm die Beschleunigung aus der Spezifikation oder von einem Parameter, den du verfolgen kannst (w,aspect,angle).- Unser vs. Referenz:
shape_compare.py REF_masks.npz --vs OURS_masks.npz --from A --to B [--rotate]→ Formpfad: ist jede Zwischenform der Referenz auch in unserer, unabhängig von ihrer Zeit (BESTANDEN: Mittel ≤ 10%, Maximum ≤ 25% des gesamten Morphs). Dann prüftfit_easing.py REF_TRACK --prop morph --vs OUR_TRACKdie Zeitsteuerung.--rotateignoriert Drehung, wenn der Morph sich auch dreht (überprüfe das mitangle).
3. Schreiben der Bewegungsspezifikation (spec.md; jede Zeile wird zu einer Prüfung)
| # | Element | Eigenschaft | von → nach | Start s | Dauer s (Frames) | Easing | Überschwingen | Staffelung / Anmerkungen | Quelle |
| 1 | Karte | translateY | 40 → 0 px | 0.20 | 0.60 (18) | easeOutCubic / cubic-bezier(.33,1,.68,1) | 0% | +0.08 s pro Karte | track + fit_easing |
| 2 | Symbol | rotate | 0 → 180 deg | 0.40 | 0.30 (9) | easeOutCubic | 0% | — | track angle + fit_easing |
| 3 | Blob | morph | Quadrat → Kreis | 0.50 | 0.40 (12) | easeInOutCubic | — | Formpfad BESTANDEN | shape_compare |
| c | — | Schnitte | — | 1.77, 2.33 | — | — | — | — | motion_compare self |
Ein „?” in einer Zeile bedeutet, dass die Frames noch nicht gelesen wurden. Notiere auch, was sich nicht bewegt. Zeige die Spezifikation dem Benutzer vor dem Bauen, wenn der Auftrag groß ist.
4. Bauen
Im Tool des Benutzers, mit seinem Design. Kopiere Zeitsteuerungen aus der Spezifikation und Easing aus der Ausgabe des Fitters für dieses Tool. Ordne Entfernungen relativ zum Element oder zum Frame zu, wenn das Layout abweicht. Ketten von Posen: Keyframes mit glatter, nicht überschwingender Interpolation; Federn, wo die Referenz überschwingt und zur Ruhe kommt.
- Rotation: setze
transform-originexplizit (messe den Drehpunkt: den Punkt, dessencx, cystill bleibt). - Morphing: SVG-Pfade benötigen dieselbe Anzahl und Art von Befehlen an beiden Enden (oder verwende flubber / GSAP MorphSVG); UI-Layout-Morphs (Button → Karte, Thumbnail → Seite) verwenden FLIP oder Shared-Element-Übergänge (Framer
layoutId, die View Transitions API); Eckenradius-/Größen-Morphs sind einfaches CSS. - 3D:
perspective800–1200 px auf dem Elternelement,backface-visibility: hidden, beide Seiten als separate Ebenen.
5. Vergleichen und korrigieren (2-5 Runden)
- Rendere oder nimm unser Bild im selben Fenster mit derselben FPS auf (nimm eine Webseite auf dieselbe Weise wie die Referenz auf).
ref_frames.py OURS.mp4 --out motion-match/<name>/ours --like motion-match/<name>/ref/frames.json(gleiches Fenster, Zuschnitt, FPS und Framegröße).motion_compare.py motion-match/<name>/ref motion-match/<name>/ours --out motion-match/<name>/compare-N→ Versatz, jeden Schnitt und jede Bewegung mit Start-/End-/Dauer-/Spitzenfehlern, BESTANDEN innerhalb von ±0,08 s,activity.png(beide Kurven) undsheets/compare_NN.png(Referenz | Unser | Differenz). Lies die Blätter in jeder Runde.- Pro Spezifikationszeile: verfolge unsere auf dieselbe Weise, dann
fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK→ Timing BESTANDEN/FEHLGESCHLAGEN pro Bewegung, Übereinstimmung von Weg und Easing-Familie. Morph-Zeilen: auchshape_compare.py --vs. - Korrigiere die kleinste Sache, auf die die Beweise hindeuten, rendere erneut, wiederhole. Nach 5 Runden melde alles, was immer noch fehlschlägt, mit seinen Zahlen und dem Grund. Locke niemals die Toleranz stillschweigend.
| Symptom | Übliche Ursache | Korrektur |
|---|---|---|
| alles um einen Versatz verschoben | Startverzögerung oder Trigger-Latenz | passe die erste Verzögerung an |
| unseres kürzer und vornlastig | Easing zu stark (Expo vs. Cubic) | verwende die angepasste Bezier-Kurve |
| Referenz überschwingt, unseres nicht | Feder/Back vs. einfaches Easing | back.out / eine Feder, abgestimmt auf das gemessene Überschwingen |
| eine Bewegung in unserem stoppt früh | eine sekundäre Bewegung fehlt (ein Drift, ein Einzoomen) | schau dir die Blätter in diesem Fenster an |
| eine zusätzliche Bewegung oder ein Schnitt in unserem | etwas animiert, das in der Referenz still ist | entferne es oder verzögere es |
| Elementnummern springen herum | Tracking hat ein anderes Element erwischt | verkleinere --region, verwende für das Element eindeutige Farben |
Rotationsweg richtig, aber unseres wackelt in cx/cy | falscher transform-origin | verschiebe den Drehpunkt zum gemessenen Stillpunkt |
| Morph-Timing BESTANDEN, Formpfad FEHLGESCHLAGEN | Pfade interpolieren unterschiedlich (Punktreihenfolge, Startpunkt) | ordne Pfadpunkte neu / gleiche Befehle an; verwende eine Morph-Bibliothek |
6. Bericht
Genauigkeit; was angeglichen wurde und was das Eigene des Benutzers ist; die letzte Vergleichstabelle (Schnitte und Bewegungen mit Fehlern, BESTANDEN/FEHLGESCHLAGEN); Zeilen pro Element; Pfade zu activity.png und den Vergleichsblättern; jede verbleibende Differenz mit ihrer Zahl und dem Grund; und welche Prüfungen gemessen (ein Skript hat sie erstellt) vs. nach Augenmaß (auf ein Blatt geschaut) wurden.
Director-Modus: ein Standbild hinein, dafür entworfene Bewegung
Verwende, wenn der Benutzer ein Bild gibt (UI-Screenshot, Mockup, Poster, Produktfoto) ohne Referenzbewegung, oder wenn Claude die Bewegung wählen soll. Die Arbeit erfolgt wie üblich in ./motion-match/<name>/ (ours/, spec.md, check-N/).
Für ein Videostück anstelle eines UI-Eingangs folge diesen Schritten innerhalb des Story-Modus (unten).
- Lies das Bild. Liste jedes Element (Hintergrund, Navigation, Überschrift, Textkörper, Bild, CTA, Karten, Symbole) mit seiner Box in px, seiner Rolle und seinem Rang auf: ein Fokuspunkt, dann unterstützend, dann Chrome. Notiere die Lesereihenfolge, die Gruppen (eine Kartenreihe, eine Liste), die Stimmung (ruhig/premium, neutral/produkt, verspielt) und alles, was auf eine spezielle Bewegung hindeutet (ein Umschaltsymbol, ein Diagramm, ein Logo-Zeichen, ein kurviger Pfad, eine umdrehbare Karte).
- Wähle eine Persönlichkeit aus der Stimmung, sofern der Benutzer keine genannt hat. Wenn sie nach Optionen fragen, baue alle drei.
| Persönlichkeit | Eingang | Dauer | Easing | Weg | Staffelung | Überschwingen |
|---|---|---|---|---|---|---|
| ruhig | Einblenden + Anheben | 400-600 ms | easeOutQuart / cubic-bezier(.25,1,.5,1) | 8-16 px | 60-80 ms | keins |
| neutral | Einblenden + Anheben, oder .97→1 skalieren | 250-400 ms | easeOutCubic / cubic-bezier(.33,1,.68,1) | 12-24 px | 40-60 ms | keins |
| verspielt | Anheben + .9→1 skalieren | Feder | Feder (Steifigkeit 300–400, Dämpfung 20–26) | 16-32 px | 50-70 ms | 3-8% |
- Wähle spezielle Bewegung nach Rolle (das Vokabular; Werte sind Ausgangspunkte, skaliert nach Persönlichkeit):
| Bewegung | Verwende sie für | Standardwerte |
|---|---|---|
| Morph | Symbol-Umschalter (Menü ↔ Schließen, Abspielen ↔ Pause), ein Button, der zu einer Karte oder einem Blatt expandiert, ein Form-Logo | 300-500 ms easeInOutCubic; Layout-Morphs via FLIP/Shared-Element |
| Rotation | Umschalt-/Chevron-Symbole, Aktualisieren, ein geneigter Eingang | Symbol 90–180° in 200–300 ms easeOutCubic; Eingang −6…−10° → 0 mit dem Easing der Persönlichkeit; Lader 360° linear 0.8–1.2 s Schleife |
| 3D-Flip / Neigung | Karten mit zwei Seiten, Preis-Umschalter, Hover-Tiefe | Flip rotateY 180° in 500-700 ms easeInOutCubic; Hover-Neigung ≤ 8° |
| Bewegung auf Pfad | etwas, das sich bewegt (ein Flugzeug, ein Punkt entlang einer Route, ein Cursor) | easeInOutSine, Drehung entlang des Pfades, 0.8-1.6 s |
| Clip / Masken-Enthüllung | Heldenbilder, große Überschriften | Inset- oder Kreis-Clip, 500-800 ms easeOutQuart |
| Text aufteilen | nur die Hauptüberschrift | Wörter 40-60 ms auseinander, Buchstaben 15-30 ms; gesamte Zeile ≤ 1 s |
| Linie zeichnen | Symbole, Unterschriften, Diagramme, Unterstreichungen | stroke-dashoffset, 600-1000 ms easeInOutCubic |
| Zähler / Diagrammwachstum | Zahlen, Balken, Ringe | Zahlen 800-1200 ms easeOutExpo; Balken von der Grundlinie, gestaffelt 40-60 ms |
| Parallaxe / Tiefe | geschichtete Helden, Scroll-Szenen | Schichtgeschwindigkeiten 0.2-0.6 des Scrolls; Scroll-Timelines, wo unterstützt |
- Choreografiere nach diesen Regeln:
- Reihenfolge: Hintergrund/Container → Fokuspunkt → Überschrift → unterstützend → CTA. Chrome (Navigation) zuletzt oder zuerst als schnelles 150-ms-Einblenden, wenn es die Seite einrahmt.
- Größe bestimmt Dauer (Symbole am unteren Ende …