Communitygithub.com

UI-Clone

Verwendet für Frontend-Arbeiten, wenn ein Benutzer eine UI, einen Abschnitt, eine Komponente, einen Effekt oder eine Animation aus einer Referenz klonen, kopieren, neu erstellen oder nachbilden möchte: eine Live-URL, den lokalen Dev-Server, ein Video, GIF oder Bildschirmaufnahme (Web oder Mobile App) oder ein Figma-Design. Deckt pixelgenaues UI (Layout, Schriften, Abstände, Farben), Animationen und Interaktionen (Load, Hover, Klick, Scroll, Seitenübergänge, Lader, Laufschriften, Federn) und Effekte (Farbverläufe, Unschärfen, Shader, Canvas/WebGL-Hintergründe) ab, die im Stack des Benutzers neu erstellt werden (HTML/CSS, React, Next.js, Vue, Svelte, Tailwind, Framer Motion, GSAP, Web Animations, three.js, React Native, SwiftUI) und dann anhand der Referenz mit Screenshot-Diffs und Einzelbild-Zeitsteuerung überprüft werden. Nicht für die Dokumentationskanal-Videos des Benutzers (Dokumentations-Animation) oder reine Video-Bewegungsstudien (Motion-Match).

Was ist UI-Clone?

Dieses Skill unterstützt Entwickler dabei, UI-Elemente, Animationen und Effekte pixelgenau oder bewegungstreu aus verschiedenen Referenzquellen (Live-URLs, Videos, Figma-Designs usw.) in ihrem eigenen Tech-Stack nachzubauen. Es bietet einen strukturierten, wiederholbaren Arbeitsablauf: Erfassen der Referenz, präzises Messen (z. B. über Playwright für Webseiten oder ein Python-Skript für Videos), Erstellen einer Spezifikation, Umsetzen im Projekt des Benutzers und anschließendes automatisiertes Vergleichen mittels Screenshot-Diffs und Bewegungsanalyse. Das Skill liefert stets messbare Belege (Zahlen, Diff-Bilder, Side-by-Side-Blätter) statt subjektiver Einschätzungen. Es eignet sich für Claude Code, Cursor, Codex und ähnliche KI-Agenten und stellt sicher, dass die Nachbauten zuverlässig und nachvollziehbar mit der Referenz übereinstimmen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stazdev/ui-clone/tree/HEAD/skills/ui-clone

In Ihrer bevorzugten KI fragen

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

Dokumentation

UI-Klon: Referenz vermessen, neu aufbauen, Übereinstimmung nachweisen

Jeder Auftrag folgt einem Kreislauf: Referenz erfassen → vermessen (wo möglich exakte Werte auslesen, wo nicht in Pixeln messen) → Spezifikation schreiben → im Stack des Benutzers bauen → unsere Aufnahme auf die gleiche Weise erstellen → vergleichen → korrigieren, bis die Spezifikation bestanden ist. Das Ergebnis ist Code im Projekt des Benutzers plus Belege (Zahlen, Diff-Bilder, Side-by-Side-Blätter), niemals „sieht ungefähr richtig aus". Methoden angepasst von NiazMorshed2007/reanimate und rossark0/rossark-motion-skill (beide MIT); jedes Skript hier ist unser Eigenes.

<skill> = der Ordner dieses Skills. Die Arbeit erfolgt in ./ui-clone/<name>/ im Projekt: ref/, ours/, figma/, compare-N/, diff-N/, spec.md. Fügen Sie ui-clone/ zur .gitignore hinzu, es sei denn, der Benutzer möchte die Belege festhalten.

Einrichtung (einmal pro Maschine)

  • Python (numpy + Pillow): ~/.ui-clone/venv/bin/python (erstellen mit python3 -m venv ~/.ui-clone/venv && ~/.ui-clone/venv/bin/pip install numpy pillow, falls nicht vorhanden). Skripte mit -I ausführen.
  • Browser-Erfassung (Playwright + Chromium, ~250 MB, nur für URL-/Dev-Server-Eingaben): Runner in ~/.ui-clone/runner (npm i [email protected] && npx [email protected] install chromium dort). Führen Sie die .mjs-Skripte aus mit node <skill>/scripts/<script>.mjs (sie laden Playwright aus ~/.ui-clone/runner oder UICLONE_RUNNER; falls Playwrights eigenes Chromium nicht installiert ist, verwenden sie jedes Chromium im Playwright-Cache oder UICLONE_CHROMIUM).
  • ffmpeg/ffprobe im PATH. Nur Figma: FIGMA_TOKEN=... in der Umgebung, in keys.env des Projekts oder in ~/.ui-clone/keys.env (nur-Lese Personal Access Token). Tokens niemals ausgeben oder committen. Fragen Sie, bevor Sie etwas installieren, das nicht vorhanden ist.

0. Umfang (oben in der spec.md, vor jeder Erfassung)

  • Ziel: genau das, was geklont werden soll (URL + Selektor, Datei + Zeitbereich + Zuschnitt, Figma-Knoten) und nichts weiter.
  • Treue (in der ersten Antwort angeben; sie bestimmt, was überprüft wird):
    Stufewannmuss übereinstimmendarf abweichen
    bewegungstreu (Standard für fremde Arbeiten)„lass unsere sich anfühlen/bewegen wie ihre"Struktur und Proportionen, Reihenfolge, Timing ±0,08 s, Easing-Familie, Überschwingen, relative Bewegung zur Größe, StaffelungKopie, Farben, Schriften, Bilder, Marke
    pixeltreueigenes Design des Benutzers (Figma → Code), eigene Website, Kundenarbeit mit Rechten oder private Übungalles oben + Schriften, Größen, Abstände, Farben, Radien, Schatten, Assets; Screenshot-Abweichung ≤ 2% (≤ 0,5% im Ruhezustand), keine gemessenen Verschiebungennichts, was sie nicht zu ändern baten
    gemischt„Klon X und füge Y hinzu"der geklonte Teil mit einer der obigen Stufendie Ergänzungen (getrennt gehalten, gezeigt, geprüft, dass sie den Klon nicht beeinträchtigen)
  • Rechte: Pixeltreue Kopien von UIs, Logos, Illustrationen, Schriften und Texten anderer Unternehmen gehören diesen; verwenden Sie sie nur zum Lernen oder mit Genehmigung und veröffentlichen Sie sie niemals als eigene Arbeit des Benutzers. Wenn die Referenz ein Produkt eines Dritten ist und der Benutzer es ausliefern möchte, standardmäßig auf bewegungstreu mit eigenem Design umschalten und begründen.
  • Ziel: wohin der Code geht und in welchem Stack. Lesen Sie package.json, vorhandene Komponenten, das Styling-System (Tailwind-Konfiguration, CSS-Variablen, Design-Tokens) und die bereits verwendete Animationsbibliothek; passen Sie sich an, anstatt eine neue Bibliothek hinzuzufügen.

1. Eingabemethode wählen (die präziseste verfügbare; angeben, welche verwendet wird)

EingabeErfassungErgebnis
Live-URLinspect_web.mjs + capture_web.mjsexakte CSS-Werte, Schriften, deklarierte Dauern/Verzögerungen/Easings, Keyframes; bildgenaue Aufnahme mit virtueller Uhr
Lokaler Dev-Server (unsere)gleiche Skripte auf http://localhost:…die „unsere"-Seite jedes Vergleichs, genau wie die Referenz erfasst
Video / GIF / Bildschirmaufnahme (Web oder App)ref_frames.pyjedes Bild mit Quell-FPS + Timing/Pose-Blätter; aus Pixeln gemessene Werte
Figmafigma_fetch.py (Token) oder exportierte PNG-Bilderexakte Größen, Abstände, Auto-Layout, Typografie, Farben, Effekte, Prototyp-Übergänge + ein Referenz-PNG
Mobile AppBildschirmaufnahme (Referenz); für unsere: xcrun simctl io booted recordVideo ours.mp4 (iOS Simulator) oder adb shell screenrecord (Android)als Video; unsere auf die gleiche Weise erfasst
Kombinieren Sie sie: URL-Werte + eine Aufnahme für schwer auslösbare Interaktionen (eingeloggte Abläufe, Drags); Figma-Werte + der Dev-Server zum Prüfen „stimmt mein Build mit dem Design überein"; Video-Referenz + Dev-Server-Erfassung für unsere. Seiten mit Login-Wall: nach einer Bildschirmaufnahme fragen oder dass der Benutzer sich einloggt; niemals deren Passwörter verarbeiten.

2. Referenz erfassen und vermessen

URL:

  • inspect_web.mjs --url URL --selector "<section>" --out ui-clone/<name>/ref [--state hover --target "<btn>"] → inspect.md: pro Element Box + berechnete Stile, deklarierte Übergänge, laufende Animationen mit Keyframes, @keyframes, Schriften, erkannte Bibliotheken (GSAP, Framer Motion, Lottie, three.js, Lenis...), Canvases (2d/WebGL), Hover/Fokus-Diff. Deklarierte Werte schlagen gemessene: diese kopieren.
  • capture_web.mjs --url URL --selector "<section>" --trigger load|hover|click|scroll|none --duration 2 --fps 30 --out ui-clone/<name>/ref → frames/, video.mp4, frames.json, animations.json. Standard --mode seek (virtuelle Uhr: JS-Timer und requestAnimationFrame auf Playwrights Uhr, CSS/Web-Animationen pausiert und bildweise weitergeschaltet: identische Erfassungen). --mode realtime für Seiten, die die virtuelle Uhr zerstört (Videoelemente, manche WebGL/Canvas-Bibliotheken), und dies angeben. --still gibt einen einzelnen Endzustands-Screenshot für Pixelarbeit; --dpr 2 für retina-scharfe Vergleiche (--dpr 3 für kleine Elemente: ein 12 px Hover-Wachstum hat zu wenige Pixel, um ein Easing bei 1x zu fitten); --pad 12 fügt einen Rand um --selector hinzu, damit Hover/Skaliereffekte, die über die Ruhebox hinauswachsen, im Bild bleiben; --viewport 390x844 für Handys. Der Seek-Modus ist über mehrere Läufe hinweg bildidentisch verifiziert. --mode realtime macht echte Screenshots so schnell wie die Maschine erlaubt (~19/s auf einem typischen Laptop) und resampelt; es gibt die erreichte Rate aus: das Timing ist nur so genau wie diese. Video / GIF / Aufnahme: ref_frames.py REF.mp4 --out ui-clone/<name>/ref [--start --end --crop x:y:w:h]. Figma: figma_fetch.py --url "<figma link with node-id>" --out ui-clone/<name>/figma --scale 2 → design.md/json + frame.png. Dann Bewegung vermessen (jede Eingabe mit Bildern):
  • Schnitte und Abschnitte: motion_compare.py <ref> <ref> --out <ref>/self --no-align.
  • Farben: track_motion.py <ref>/frames --sample X,Y --at T.
  • Jedes bewegte Element: track_motion.py <ref>/frames --name el --colors HEX,HEX --tol 35 --region x,y,w,h (bei belebten Referenzen immer eine Region).
  • Jede Bewegung: fit_easing.py <ref>/track_el.json --prop cx|cy|w|h|aspect|presence --from A --to B → Timing, Easing, Überschwingen und einfügebereite CSS-/WAAPI-/Framer-Motion-/GSAP-/Remotion-Zeilen. Fehler ≤ 0,03 = gute Übereinstimmung; „kein einzelnes Easing passt" = das Fenster aufteilen oder es ist eine Keyframe-Kette. Wenn der Fehler des Zweitplatzierten innerhalb von ~0,003 des Besten liegt, als Gleichstand behandeln (z.B. easeOutQuad 0,58 s vs easeOutCubic 0,80 s passen zu denselben Bildern): dies angeben und deklarierte Werte aus inspect.md, dem Quellcode oder den Blättern bevorzugen, um die Entscheidung zu treffen. Das Tracking sieht ein Element nur durch seine Farbe, daher erscheint ein Element, das während der Bewegung einblendet, als würde es spät starten: bei Web-Eingaben stattdessen die deklarierten Werte verwenden. Jedes Blatt (sheets/poses.png, sheets/timing_NN.png) selbst lesen: Zahlen sagen das, Blätter sagen was.

3. Spezifikation schreiben (ui-clone/<name>/spec.md; jede Zeile wird zu einer Prüfung)

  • Struktur & statischer Stil (pixeltreu): Element → Box, Schrift (Familie/Größe/Gewicht/Zeilenabstand/Buchstabenabstand), Farben, Radius, Schatten, Abstände; Quelle (inspect.json / design.json / gemessen).
  • Zeitachse (Bewegung): | # | Element | Eigenschaft | von → nach | Start ms | Dauer ms | Easing | Staffelung / Wiederholung | Auslöser | Quelle |.
  • Notieren, was sich nicht bewegt. Ein „?" bedeutet, dass die Referenz noch nicht gelesen wurde. Die Spezifikation vor einem großen Build zeigen.

4. Bauen

Im Stack des Benutzers und im Designsystem. Deklarierte Werte exakt kopieren (pixeltreu) oder relative Proportionen (bewegungstreu). Easings aus inspect.json oder aus der Zeile von fit_easing.py für deren Bibliothek; Federn, wenn die Referenz überschwingt und zur Ruhe kommt; Staffelungen als Basis + Index × Schritt. prefers-reduced-motion respektieren (Endzustand anzeigen). Ergänzungen in separaten Komponenten halten. Unserer Komponente eine Route/Seite geben, die sie im Referenz-Viewport mit demselben Auslöser rendert, damit sie identisch erfasst werden kann. WebGL-Effekte: den Shader aus dem nachbauen, was die Referenz zeigt (oder aus deren lesbarem Quellcode, wenn der Benutzer ihn verwenden darf); feste Zeitschritte aus der Zeit, gesäter Zufall.

5. Überprüfen, korrigieren, wiederholen (2-5 Runden; jeden Rundenordner behalten)

  1. Unsere mit dem gleichen Befehl wie die Referenz erfassen (nur --url/Eingabe und --out ändern), oder ref_frames.py OURS.mp4 --out ui-clone/<name>/ours --like <ref>/frames.json für Video-Eingaben.
  2. Pixel: screenshot_diff.py <ref>/still.png <ours>/still.png --out ui-clone/<name>/diff-N [--strict] [--max 0.02] [--mask x,y,w,h] (pixeltreu: immer --strict: Pixel-Schwellwert 0,03, Maximum 0,5 %, und jede Region, deren Farbe um mehr als 3 RGB-Stufen abweicht, gilt als Fehler; der Standard ist nachsichtig und lässt kleine Padding- und Farbänderungen durch) → Abweichung %, schlechteste Regionen, ganze-Bild- oder elementweise Verschiebungen („etwas in Region … verschoben um +0 px x, +6 px y"), Farbdrift, side_by_side.png. Zuerst Verschiebungen korrigieren (sie lassen alles falsch aussehen), dann Größen, dann Farben. Pixeltreu FAIL bei jeder gemessenen Verschiebung; bewegungstreu verwendet --allow-shift und ein lockereres --max.
  3. Bewegung: motion_compare.py <ref> <ours> --out ui-clone/<name>/compare-N (Schnitte, Bewegungen, Offset; BESTANDEN ±0,08 s; activity.png, sheets/compare_NN.png) und, pro Spezifikationszeile, fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK.
  4. Die Blätter jede Runde lesen. Die kleinste Sache ändern, auf die die Belege hinweisen; neu erfassen; neu vergleichen.
  5. Nach 5 Runden jede noch nicht bestandene Zeile mit ihrer Zahl und dem Grund melden (Schriftlizenz, ein approximierter WebGL-Effekt, eine nach Gefühl eingestellte Feder). Niemals einen Schwellwert stillschweigend lockern.
SymptomÜbliche UrsacheLösung
ganzes Bild um N Pixel verschobenanderer Scroll/Offset/Zuschnitt oder fehlender Wrapper-RandViewport, dpr, Zuschnitt angleichen; den äußeren Abstand korrigieren
ein Element verschobenunterschiedlicher Rand/Padding/Zeilenabstand/Lückedessen Box mit inspect.json / design.json vergleichen
Text überall leicht falschFallback-Schrift, andere Stärke oder Buchstabenabstanddieselbe Schrift laden (oder die lizenzierte Entsprechung des Benutzers), Größe/Stärke/Laufweite anpassen
Farben überall leicht falschFarbraum, Opazitäts-Stapelung, Verlaufsstoppsberechnete Farben/Verläufe kopieren; Opazität der Eltern prüfen
Bewegung um einen Offset verschobenAuslöser-Latenz oder fehlende Verzögerungdie erste Verzögerung korrigieren
unsere zu schnell / zu schwungvollstärkeres Easing (Expo vs Cubic)den gefitteten Bezier oder das deklarierte Easing verwenden
Referenz überschwingt, unsere nichtFeder/Back vs BezierFeder/Back auf das gemessene Überschwingen und Einpendeln abgestimmt
Scroll-Animation startet zu früh/spätAuslöser-Schwellwert/-Offsetdie Scroll-Position anpassen, bei der die Bewegung beginnt
eine zusätzliche Bewegung bei unsein versehentlicher Übergang (z.B. transition: all)Übergänge auf die Eigenschaften beschränken, die animieren sollen

6. Bericht (muss für sich allein stehen)

Treuestufe und was geklont / hinzugefügt wurde; geänderte Dateien und wie die Bewegung ausgelöst wird; die Tabellen der letzten Runde (Pixel-Abweichung und -Verschiebungen; Schnitte/Bewegungs-Timing; elementweises Easing), Pfade zu side_by_side.png, activity.png und Vergleichsblättern; jede verbleibende Abweichung mit Zahl und Grund; welche Prüfungen gemessen (von einem Skript erstellt) vs. überflogen wurden (ein Blatt angesehen).

Grenzen

  • Die virtuelle Uhr-Erfassung kann <video>-Wiedergabe oder manche GPU/Physik-Bibliotheken nicht steuern: --mode realtime verwenden und mit ±1-2 Bildern Rauschen rechnen; dies angeben.
  • CORS-Stylesheets und -Schriften können @keyframes/@font-face-Regeln vor der Inspektion verbergen; berechnete Stile und laufende Animationen werden dennoch gelesen.
  • Bei Videos wird 3D als Kamera-/Objektbewegung abgeglichen, nicht als Modelle oder Materialien; belebte Realfilm-Aufnahmen liefern Rhythmus, nicht exakte Elementwerte.
  • Mobil: Werte stammen aus Aufnahmen (keine Quelle); Simulator-Erfassungen unserer Seite werden auf die gleiche Weise verglichen.

Verwandte Skills