Communitygithub.com

reanimate

Zeigt einem Agenten, wie man Animationen plant, erstellt oder nachbearbeitt, sodass das konkrete Ergebnis ein fertiger Videoschnitt ist. Der Ablauf erfolgt über die Definition von „fertig“, den Workflow und den Umfang. Verwende es, wenn ein neuer Auftrag dieses Handwerk erfordert.

Was ist reanimate?

Der Skill "reanimate" befähigt einen KI-Agenten, Animationen pixel- oder bewegungsgetreu nachzubauen. Er definiert einen strengen Workflow: Zuerst wird der Ziel-Fidelity-Level (bewegungstreu, pixeltreu oder gemischt) festgelegt, dann wird die Referenz mittels Playwright, ffmpeg und optional WebGL aufgezeichnet. Anschließend erstellt der Agent ein detailliertes Bewegungs-Spezifikationsdokument (`spec.md`), implementiert die Animation im Technologie-Stack des Benutzers und vergleicht die Ausgabe Frame für Frame mit der Referenz. Der Skill unterstützt Webseiten, Videos, GIFs, Canvas, WebGL, WebGPU, Lottie/Rive und andere Quellen. Er ist für Entwickler-Umgebungen wie Claude Code, Cursor und Codex gedacht und stellt sicher, dass die Ausgabe nicht nur "ungefähr richtig aussieht", sondern durch numerische Metriken und Side-by-Side-Bewertungen belegt wird. Der Skill enthält Skripte zur automatischen Einrichtung und zum Vergleich, die auf Bun und Playwright basieren. Der Anwender erhält am Ende einen detaillierten Bericht über Übereinstimmungen, Fehler und verbleibende Abweichungen.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/PedroColbert/ai-skills-collection/tree/HEAD/reanimate

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht reanimate?

Baue das, worauf der Benutzer zeigt, so nach, dass es sich so bewegt wie die Referenz, beweise es mit einem Frame-für-Frame-Vergleich und wiederhole dies, bis der Vergleich bestanden ist. Das Ergebnis ist Code im Projekt des Benutzers plus Nachweise (Zahlen und Side-by-Side-Vergleiche), niemals „es sieht ungefähr richtig aus".

Was „fertig“ bedeutet

Wähle den Genauigkeitsgrad aus den Worten des Benutzers und gib ihn in der ersten Nachricht an; er bestimmt, was du überprüfst.

LevelWannMuss übereinstimmenDarf abweichen
bewegungstreu (Standard)„Diese Animation klonen", „Unsere soll sich wie ihre anfühlen", „Gleicher Held wie bei X, aber unsere Kopie"Auslöser, Sequenz und Reihenfolge, Staffelung, Timing jedes Schritts (±80 ms), Easing-Familie, Richtung und Distanz der Bewegung relativ zur Elementgröße, Layout-ProportionenKopie, Farben, Schriftarten, Bilder, Markendetails
pixeltreu„Genau übereinstimmen", „Pixelgenau", „Details sollen übereinstimmen", „1:1"Alles oben plus Schriftarten, Größen, Farben, Abstände, Radien, Schatten, Assets; mittlere Frame-Abweichung ≤ 2 %Nichts, was der Benutzer nicht geändert haben wollte
gemischt„X klonen und Y hinzufügen", „Wie ihre, aber mit unseren Preistabellen"Die geklonten Teile auf einem der obigen LevelDie Ergänzungen, die du beschreibst und zeigst, aber nur darauf überprüfst, dass sie die geklonte Bewegung nicht beeinträchtigen

Der Benutzer kann das Ziel auf einen Abschnitt, ein Widget, eine Seite oder einen Zeitbereich eines Videos eingrenzen („die ersten 3 Sekunden", „0:12 bis 0:15"). Klone genau das; beziehe den Rest der Seite nicht mit ein.

Workflow

Alles unten lebt in .reanimate/<name>/ innerhalb des Benutzerprojekts (füge es zu .gitignore hinzu, es sei denn, der Benutzer möchte die Nachweise committed haben). Behalte die Artefakte jeder Runde; sie sind der Beweis.

0. Umfang

Schreibe drei Zeilen an den Anfang von .reanimate/<name>/spec.md vor jeder Aufnahme:

  • Ziel: Was zu klonen ist, so genau, wie der Benutzer es gesagt hat (URL + Selektor / Zeitbereich / „der Schalter im GIF").
  • Zielort: Wohin der Code geht und in welchem Stack (lies package.json, vorhandene Komponenten und die bereits verwendete Animationsbibliothek; passe dich an, anstatt eine neue einzuführen).
  • Genauigkeit: bewegungstreu, pixeltreu oder gemischt, plus die Liste der Ergänzungen für gemischt.

Leite ab, was du aus der Anfrage und dem Repository ableiten kannst. Frage nur nach, wenn zwei Lesarten zu unterschiedlicher Arbeit führen (z. B. „der Held" auf einer Seite mit zwei Kandidatenabschnitten). Wenn eine Referenz eine Seite mit Login-Wall oder ein YouTube-/Loom-Link ist, den du hier nicht herunterladen kannst, bitte den Benutzer um eine Bildschirmaufnahme und fahre in der Zwischenzeit mit allem anderen fort.

1. Einrichtung

<skill> unten ist das Verzeichnis, in dem diese SKILL.md lebt. Skripte benötigen Bun; der erste Lauf lädt Playwrights Chromium und ein statisches ffmpeg herunter (ca. 250 MB).

bash <skill>/scripts/setup.sh      # installiert playwright, ffmpeg, pixelmatch einmal; gibt "bereit" aus

Alle Skripte werden mit bun <skill>/scripts/<name>.ts --help ausgeführt. Sie sind deterministisch und teilen eine Regel: Nimm die Referenz und den Klon mit dem gleichen Viewport, Selektorzuschnitt, Auslöser, Dauer und fps auf, sonst misst der Vergleich deine Einrichtung statt deiner Arbeit.

2. Referenz aufnehmen

Lies references/capture.md für das Rezept für deinen Quelltyp. Kurzgefasst:

  • Website: capture.ts --url … --out ref --selector <section> --trigger load|scroll|hover|click|none --duration … --track "<bewegte Elemente>". Du erhältst video.webm, frames/, inspect.json (deklarierte Animationen, Keyframes, berechnete Stile, Schriftarten, erkannte Bibliotheken) und track.json (pro Animationsframe Position, Größe, Opazität, Transform jedes verfolgten Elements). Bei CSS/WAAPI-Bewegung enthält inspect.json oft die genauen Dauern, Verzögerungen und Easings: verwende sie, das ist besser als Schätzen.
  • Video oder GIF: frames.ts --in file --out ref/frames --fps 10..30 --start … --end … --crop …. Untersuche zuerst mit --probe, dann betrachte ein paar Frames, um den Zuschnitt des Widgets zu finden, das du klonst.
  • Canvas, WebGL, WebGPU, 3D (inspect.json › canvases zeigt eines, oder die Seite verwendet three.js, Pixi, Babylon, Spline…): füge --clock virtual --gl --assets zur Aufnahme hinzu und lies gl/summary.md (gl.ts summary <out>). Du erhältst die Shaderquellen, jede konstante Uniform, den Szenengraphen, die Renderdurchgänge, die Texturen und Modelle und jede animierte Uniform oder Objekteigenschaft als Kanal in gl-track.json. Die virtuelle Uhr macht jeden Frame exakt und jede Aufnahme identisch, einschließlich zufälliger Partikel. Lies references/webgl.md.
  • Lottie / Rive / Prototyp-Export: die Datei ist die Spezifikation; lies sie, leite sie nicht von Pixeln ab.

Erstelle dann beschriftete Blätter und sieh sie dir an: sheet.ts filmstrip --frames ref/frames --out ref/sheets. Lies jedes Blatt mit dem Bildbetrachter. Das ist die Frame-für-Frame-Inspektion, die der Benutzer verlangt hat; überspringe sie nicht oder mustere nur das erste Blatt.

3. Die Bewegungsspezifikation schreiben

Fülle spec.md mit der Vorlage in references/analysis.md. Eine Zeile pro Element pro Eigenschaft: Auslöser, Startzeit, Dauer, Verzögerung oder Staffelung, von → nach, Easing, Notizen. Hole die Zahlen in dieser Reihenfolge: Animationen und Keyframes aus inspect.json → easing.ts auf track.json oder auf gl-track.json --channel für Canvas → Frames lesen (erster Frame, an dem es sich ändert, letzter Frame, an dem es sich ändert, Überschwingen oder nicht). Notiere auch die statischen Fakten, von denen die Bewegung abhängt: Elementgrößen und -positionen, Z-Reihenfolge, Überlaufbeschneidung, Transform-Ursprünge und für pixeltreue Arbeit Schriftarten, Farben, Abstände und Assets.

Die Spezifikation ist der Vertrag zwischen Referenz und Klon. Jede Zeile wird zu einer Prüfung in Schritt 5. Wenn eine Zeile ein „?" enthält, hast du das Lesen der Frames noch nicht abgeschlossen.

4. Bauen

Implementiere im Stack des Benutzers gemäß references/implementation.md (Easing-Tabellen, Staffelungsmathematik, Scroll- und Hover-Auslöser, reduzierte Bewegung). Halte die DOM-Struktur nah an der Rollenstruktur der Referenz, sodass die verfolgten Selektoren Äquivalente haben. Füge bei gemischter Arbeit Ergänzungen in klar getrennte Komponenten oder Blöcke ein und erwähne sie in spec.md unter „Ergänzungen".

Gib dem Klon eine Möglichkeit, auf die gleiche Weise wie die Referenz aufgenommen zu werden: eine Route oder eine statische Seite, die die Komponente im Referenz-Viewport mit dem gleichen Auslöser rendert. Ein Entwicklungsserver ist in Ordnung (capture.ts --url http://localhost:5173/…); eine eigenständige HTML-Datei funktioniert auch.

5. Überprüfen, korrigieren, wiederholen

Nimm den Klon mit dem exakt gleichen Befehl wie für die Referenz auf, ändere nur --url und --out clone-N, dann:

bun <skill>/scripts/compare.ts --ref ref/frames --clone clone-N/frames --out compare-N
bun <skill>/scripts/sheet.ts compare --ref ref/frames --clone clone-N/frames --diff compare-N/diff --out compare-N/sheets --every 2
bun <skill>/scripts/easing.ts --track clone-N/track.json --selector "<el>" --prop <translateY|opacity|…> --compare-track ref/track.json

Für Canvas-Arbeit führe auch gl.ts compare --ref ref --clone clone-N aus, das Canvas-Einstellungen, Zeichenstruktur und jeden animierten Kanal überprüft.

Lies references/verify.md, um zu erfahren, wie der Bericht zu lesen ist, die Bestehenskriterien für jeden Genauigkeitsgrad und welche Korrekturen jede Art von Fehler normalerweise benötigt. Sieh dir die Vergleichsblätter selbst an, jede Runde; die Zahlen sagen dir, dass etwas nicht stimmt, die Blätter sagen dir, was.

Wiederhole die Schleife, bis jede Spezifikationszeile bestanden ist. Jede Runde: Ändere das kleinste Ding, auf das die Beweise hinweisen, nimm erneut auf, vergleiche erneut. Erwarte 2 bis 5 Runden. Wenn nach 5 Runden eine Zeile immer noch fehlschlägt, stoppe und melde sie mit ihren Zahlen und dem Grund (fehlende Schriftart, ein Shader oder Modell, das der Benutzer möglicherweise nicht kopieren darf, eine physikalische Feder, die du angenähert hast), senke nicht stillschweigend die Schwelle oder lasse die Zeile weg.

6. Bericht

Die endgültige Nachricht muss für sich allein stehen:

  • Genauigkeitsgrad und was geklont wurde, was hinzugefügt wurde.
  • Wo der Code ist (Dateien) und wie die Bewegung ausgelöst wird.
  • Eine kurze Tabelle der letzten Vergleichsrunde: Timing-Fehler, mittlere Abweichung, Easing-Übereinstimmung pro Schlüsselelement, bestanden/fehlgeschlagen.
  • Pfade zu den endgültigen Vergleichsblättern, eingebettet als Bilder, wenn die Umgebung sie anzeigt.
  • Verbleibende Abweichungen, jede mit einer Zahl und einem Grund.

Fallstricke, die Runden verschwenden

  • Unterschiedlicher Viewport oder Zuschnitt zwischen Referenz und Klon: Korrigiere die Aufnahme, bevor du Code anfasst.
  • Nur nach dem ersten und letzten Frame urteilen: Das Easing lebt in den mittleren Frames; lies die Blätter.
  • Schriftarten: Eine andere Fallback-Schriftart ändert jeden Frame-Pixel. Lade bei pixeltreuer Arbeit die gleiche Schriftart (aus inspect.json fonts), bevor du die Abweichung beurteilst; ignoriere bei bewegungstreuer Arbeit Textpixel und lies die Timing-Spalten.
  • Referenz auf einer geladenen Seite aufgezeichnet vs. Klon kalt aufgenommen: Verwende --wait-before oder --trigger none mit einem --pre-js, das die Animation neu startet, sodass beide aus dem Ruhezustand starten.
  • Scrollgesteuerte Bewegung: Sie ist eine Funktion der Bildlaufposition, nicht der Zeit. Nimm beide mit den gleichen --scroll-steps und --scroll-ms auf und vergleiche pro Bildlaufposition (das scrollY der Spur), nicht pro Sekunde.
  • JS-Bibliotheken (GSAP, Framer Motion Federn): --playback-rate verlangsamt sie nicht. Verwende track.json und easing.ts (es meldet Überschwingen und „federartig") und passe Federparameter durch Überschwingen und Einschwingzeit an.
  • Videos von fremden Bildschirmen haben einen Cursor, eine Browserchrom und Kompressionsrauschen: Schneide sie aus und erhöhe --pixel-threshold leicht (0.15), anstatt Rauschen nachzujagen.
  • Canvas und WebGL, aufgenommen mit der echten Uhr: Frames fallen in Software-GL aus und zufällige Inhalte unterscheiden sich bei jedem Laden, also misst der Vergleich die Maschine. Nimm beide Seiten mit --clock virtual und dem gleichen --seed auf.
  • Einen Shader aus Screenshots nachbauen: Der Trace hat bereits seine Quelle und jede Konstante. Lies gl/shaders/ und die festen Uniforms, bevor du GLSL schreibst.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills