Communitygithub.com

Code to Figma

Baue die Benutzeroberfläche einer laufenden Web-App als native, bearbeitbare Figma-Ebenen (Auto Layout, Komponenten, Instanzen) nach und vergleiche sie mit Browser-Screenshots – kein Screenshot-Import und keine Code-Ebene.

Was ist Code to Figma?

Das Skill „Code to Figma“ ermöglicht es, eine laufende Webanwendung – sei es eine einzelne Seite oder eine ganze Gruppe von Seiten – direkt aus dem Browser heraus als native Figma-Ebenen nachzubauen. Es extrahiert das DOM als Layout-Baum, erzeugt Auto-Layout-Frames, Komponenten und Instanzen und gleicht das Ergebnis mit einem Browser-Screenshot ab, um Abweichungen zu erkennen. Das Skill unterstützt Vue 3 und React (einschließlich Next.js App Router Server Components) mit spezifischen Komponenten-Adaptern; für andere Frameworks kommt eine einfache Wiederholungserkennung zum Einsatz. Native Apps oder Canvas/WebGL-basierte Oberflächen sind nicht abgedeckt – hier sollten Design-Dateien oder Wireframes verwendet werden. Der vollständige Workflow umfasst sechs Schritte: Eingabe bestätigen, Projekt starten und Konfiguration schreiben, repräsentative Bildschirme erstellen und vergleichen, Batch-Vergleich, Audit und abschließende Berichterstellung. Das Skill enthält strenge Regeln für die Figma-Nutzung, um Speicherüberläufe zu vermeiden (z. B. nur einen Bildschirm gleichzeitig senden, vor dem Schreiben eine Version speichern lassen, bei roten Warnungen oder Wiederherstellungsmodus sofort anhalten). Bekannte Einschränkungen betreffen unter anderem CSS-Eigenschaften wie `mask-image` und `clip-path`, die nicht vollständig abgebildet werden können, sowie die Schriftarten-Substitution und leichte Farbabweichungen durch sRGB-Konvertierung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byby325/code-to-figma-ui-states/tree/HEAD/skills/code-to-figma

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Code to Figma?

Führe das Projekt aus, extrahiere das DOM als Layout-Baum im Browser und baue es dann in Figma als bearbeitbare Auto-Layout-Frames und Komponenten nach.

Für Web-Frontends. Komponentengrenzen haben Adapter für Vue 3 und React (React 18 und 19 getestet, einschließlich Next.js App Router Server Components; 16 und 17 haben die gleiche Fiber-Struktur, sind aber ungetestet). Andere Frameworks erhalten nur die Erkennung wiederholter Knoten. Native Apps und vollständig in Canvas/WebGL gezeichnete Bildschirme sind nicht abgedeckt; verwende stattdessen die Design-Datei oder Wireframes.

DateiInhalt
web-capture.mdDer vollständige Prozess; vor dem Start lesen
screen-structure.mdStrukturregeln, die die Ausgabe erfüllen muss
scale-guard.mdSchwellenwerte und Abbruchbedingungen für das MCP-Call-Budget und den Dateispeicher; vor dem Start lesen
troubleshooting.mdFehlertabelle; konsultieren, wenn die Ergebnisse falsch sind
examples/Capture-Konfigurationsvorlagen für vier Projektarten: integrierter Mock, Playwright-Fixture, Nuxt-Dev, Backend-API abfangen
evals/trials.jsonRegressionsfälle und Basislinien; nach Änderungen an den Tools alle erneut ausführen

Schritte

  1. Eingaben bestätigen: das Projekt und wie es ausgeführt wird, welche Bildschirme, der Viewport und Höhentyp jedes Bildschirms, die Ziel-Figma-Datei und das zu bindende Designsystem. Der Benutzer entscheidet über Thema und Umfang; wähle sie nicht selbst. Sobald du den Figma-Link hast, führe create_session plus ein schreibgeschütztes use_figma aus, um zu bestätigen, dass das angemeldete MCP-Konto die Datei lesen und schreiben kann (wenn die Datei nicht geöffnet werden kann, verwende whoami, um zu erklären, welches Konto es ist und mit wem die Datei geteilt werden soll). Dann schätze, wie viele Aufrufe dieser Auftrag gemäß scale-guard.md „MCP-Call-Budget“ benötigt; wenn das Budget nicht ausreicht, teile es zuerst mit.
  2. Projekt starten, Konfiguration schreiben, aufnehmen: führe al-capture.cjs aus, gemäß web-capture.md
  3. Zuerst einen repräsentativen Bildschirm pro Gerät erstellen, mit dem Browser-Screenshot vergleichen und nur dann bündeln, wenn er übereinstimmt
  4. Nach dem Batch jeden Bildschirm vergleichen: führe al-diff.py aus; erstelle auch Screenshots und überprüfe den Komponentenbereich
  5. Audit: führe audit-screens.js aus

Erledigt, wenn: jeder Bildschirm einen Wiederaufbau hat, die Breite des Root-Frames jedes Bildschirms dem Viewport entspricht und der repräsentative Bildschirm jedes Geräts eine Referenz-Screenshot-Ebene hat; issues ist leer oder jeder Eintrag wird mit seiner Ursache gemeldet; der Komponentenbereich wurde in einem Screenshot überprüft.

Harte Regeln für das Schreiben nach Figma

Der Speicher einer Figma-Datei kann im Handumdrehen über das Limit schießen, selbst wenn die statische Nutzung gering ist, und eine Datei, die explodiert, kann nicht immer wiederhergestellt werden (scale-guard.md „Vorfall“). Befolge diese bei jedem Projekt:

  1. Bevor du in eine bestehende Datei schreibst, bitte den Benutzer, eine Version zu speichern, auch bevor du zuvor erstellte Bildschirme löschst oder neu aufbaust. Beginne nicht, bis der Benutzer antwortet, dass sie gespeichert ist. Wenn die Zielseite nichts außer dem enthält, was du selbst erstellt hast (neue Datei, leere Seite), kannst du dies überspringen; gib dies im Bericht an.
  2. Sende immer nur einen Bildschirm gleichzeitig: lade die Bilder und das Daten-SVG dieses Bildschirms hoch, baue ihn auf, bestätige, dass die temporären Frames ALDATA- und ALIMG- gelöscht wurden, und fahre dann mit dem nächsten fort. Lade nicht den gesamten Batch zuerst hoch.
  3. Wenn der Benutzer eine rote Warnung oder den Wiederherstellungsmodus meldet, sofort anhalten. Führe nicht einmal ein schreibgeschütztes use_figma aus, bis der Benutzer bestätigt, dass die Datei in Ordnung ist.
  4. Anhalten, wenn das Call-Limit erreicht ist: Wenn ein Figma-Tool „Limits der Figma-MCP-Tool-Aufrufe erreicht“ zurückgibt, nicht wiederholen und keine Tools wechseln, um es zu umgehen. Liste die abgeschlossenen Bildschirme und die Knoten-IDs der noch auf der Leinwand befindlichen temporären Frames auf.

Bekannte Grenzen

  • Komponentengrenzen haben Adapter für Vue 3 und React; beide benötigen den Entwicklungsmodus (Produktions-Builds haben keine Komponentennamen, und stats.json wird warnen). Svelte, Angular und andere Frameworks erhalten nur die Erkennung wiederholter Knoten; um eines zu unterstützen, füge einen Eintrag zu ADAPTERS in al-extract.js hinzu.
  • React-Komponenten-Benennungsregeln: Ein DOM-Knoten zählt nur dann als Grenze, wenn er der einzige Root-Knoten der Komponente ist, und der Name wird von der äußersten Komponente übernommen. Komponenten, die nur Children weitergeben (Provider, Tooltip, ErrorBoundary), styled-components/emotion-Style-Komponenten sowie Router- und Framework-interne Komponenten zählen nicht. Next.js-Server-Komponentennamen erfordern einen React-19-Dev-Build (Next 15 und höher); mit React 18 werden nur Client-Komponenten erfasst.
  • React: Das Vite + Radix + Tailwind 4 Demo-Projekt hat eine Figma-Wiederaufbau-Basislinie (vier Bildschirme, 0,02–0,12% Abweichung vom Browser). Das Next.js App Router Projekt wurde nur durch Capture und Packen verifiziert.
  • Icons, die ein SVG als mask-image verwenden und keine Children haben (z. B. frappe-ui, UnoCSS lucide-*-Klassen), werden in Vektoren umgewandelt und mit der Hintergrundfarbe eingefärbt. Andere mask-image-Verwendungen (Farbverläufe, Bitmap-Masken) und clip-path haben kein Äquivalent; verblasste Kanten und abgewinkelte Schnitte werden zu vollen Formen.
  • Farben: rgb() wird unterstützt, plus die Formate, die Chrome zurückgeben kann, wie oklch(), color(srgb …), lab() und hsl(); letztere werden über eine Leinwand in sRGB konvertiert, und jeder Kanal kann um 1 abweichen (8-Bit-Rundung).
  • Die Plugin-API kann die Breite eines Frames innerhalb einer Instanz nicht ändern. Ein einziges Kind, das sich streckt, um seinen Eltern-Frame zu füllen, wird auf Füllen geändert; Kinder, die sich strecken, um den Eltern zu füllen, werden durch Padding angepasst; Auto-Layout-Frames, die in den Daten auf Hug gesetzt sind, werden auf Hug geändert; in allen anderen Fällen folgt die Größe der Hauptkomponente, und log.boxes listet sie auf.
  • Kleine Elemente mit verschachteltem z-index können verdeckt werden; die Ebenenstruktur kann ein einzelnes Kind nicht aus seinem Elternelement verschieben.
  • Systemschriftarten (ui-sans-serif) werden durch Inter ersetzt; die Zeichenbreiten weichen geringfügig ab.
  • font-variant-numeric: tabular-nums (Tabellenziffern) kann in Figma nicht aktiviert werden: Die Plugin-API openTypeFeatures ist schreibgeschützt. Daten, Uhrzeiten und Beträge werden schmaler als im Browser dargestellt, und der Text danach verschiebt sich um 5–8px; log.drift listet diese auf.
  • Rotation und CSS-Dreiecke werden nur für Elemente ohne Kinder behandelt (Häkchen, Tab-Dreiecke, kleine Quadrate), die in Vektoren umgewandelt werden; rotierte Container mit Kindern werden durch ihre Begrenzungsbox angeordnet, und ihr Inhalt wird nicht rotiert.

Bericht

  • Struktur: Verhältnis der Auto-Layout-Container, Anzahl der Komponenten/Varianten; welche Bereiche absolut sind (Overlays, Content mittendrin)
  • Vergleichsergebnisse: Textversatz, die Bildschirme mit der höchsten Abweichungsrate und bekannte Stellen, die nicht reproduziert werden können. Lies die Abweichungsrate im Kontext: Farbverläufe oder Bitmap-mask-image treiben die Rate nach oben, erkläre also die Ursache; wenn stats.json warnt, dass Icons leer sind, erlaube zuerst die Icon-Quelle und nimm erneut auf. Wenn ein ganzer Bildschirm fast keine Farbe hat, prüfe zuerst, ob das von __alBuild zurückgegebene stat Farben erfasst hat (troubleshooting.md)
  • Referenz-Screenshots werden nur auf repräsentativen Bildschirmen platziert; der Rest bleibt im lokalen Ausgabeordner
  • Mit einer gebundenen Bibliothek schreibe diesen Teil gemäß dem „Bericht“-Abschnitt der Figma-Bibliotheksbindung; ohne Bibliothek sind Farben und Schriftgrößen hartcodierte Werte
  • Bildschirme werden aus Mock-Daten reproduziert; welche Bereiche mit Live-Screenshots gefüllt wurden und welcher Text in den Mocks geändert wurde
  • Welche Schriftart ersetzt wurde, wenn Figma die Produktschriftart nicht hat
  • Skalierung: eine Zeile im scale-guard.md-Format

Individual skills in this repo

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

figma-library-binding

Bind Figma screens to a design system library — tokens only on exact value matches, swap icons and components for library versions, and list unmatched values for designers instead of snapping to the nearest token. Use when the user asks to "bind tokens", "use library components" or "find unbound colors". 把 Figma 畫面綁到專案的 design system library:顏色、圓角、邊框、間距、字級完全相同才綁 token,圖示和元件換成 library 版本,沒有對應的值列給設計決定,不取最近值。Use when 使用者要「綁 library」「綁 token」「換成 design system 元件」「檢查沒綁 variable 的顏色」,或 code-to-figma、figma-state-board 的畫面要綁 design system。

figma-state-board

Inventory every UI state of a feature from its code and lay them out on one Figma canvas (a state board) — real screens for states the prototype already handles, plus a gap check of missing error, empty and loading states, split into spec-required and suggested. Use when the user asks for a "state board", "all states of this feature in Figma", "which error screens are missing", or to update an existing board. 從任何產品專案的程式碼盤點一個功能的所有狀態,在 Figma 產出或更新「情境稿」:原型(通常是 mock data 做的)已經有的狀態畫真實畫面,原型缺的狀態全列進「缺漏檢查」,再分「規格有寫」(規格要求、原型漏做)和「建議補」(規格和原型都沒提的錯誤、空狀態、載入等)。Use when 使用者要「做情境稿」「把所有狀態/狀況畫到 Figma」「state board」「檢查缺了哪些 error 畫面」,或要依新規則增修既有情境稿。只要狀態清單用 state-discovery,只要把畫面轉進 Figma 用 code-to-figma。

Verwandte Skills