Communitygithub.com

tmnhutwork/Landingpage-Photo-Retouch

Übersetzt Figma-Designs pixelgenau in produktionsreifen Anwendungscode. Verwenden Sie dies bei der Implementierung von UI-Code aus Figma-Dateien, wenn der Benutzer „Design implementieren“, „Code generieren“, „Komponente implementieren“ erwähnt, Figma-URLs bereitstellt oder darum bittet, Komponenten gemäß den Figma-Spezifikationen zu erstellen.

Was ist Landingpage-Photo-Retouch?

Diese Fähigkeit bietet einen strukturierten Arbeitsablauf, um Figma-Designs mit pixelgenauer Präzision in produktionsreifen Code zu übersetzen. Dadurch wird eine konsistente Integration mit dem Figma MCP-Server, eine ordnungsgemäße Verwendung von Design-Tokens und eine 1:1-Rückmeldungstreue zu den Designs sichergestellt. Sie wird vom Benutzer durch explizite Aufforderungen zur UI-Implementierung ausgelöst oder wenn er Figma-URLs bereitstellt. Die Fähigkeit gliedert sich in sieben wesentliche Schritte: Extrahieren der Knoten-ID aus der Figma-URL oder der Desktop-Auswahl, Abrufen des Designkontexts über `get_design_context`, Erfassen einer visuellen Referenz mit `get_screenshot`, Herunterladen erforderlicher Assets, Übersetzen in die Projektkonventionen, Erreichen einer 1:1-Rückmeldungstreue und Validierung anhand der Figma-Screenshots. Sie behandelt Randfälle, wie das Kürzen von Antworten, Asset-Ladeprobleme und Unterschiede bei Design-Tokens. Die Fähigkeit gewährleistet außerdem, dass die Implementierung die Projektstruktur, das Designsystem und die Codequalitätsstandards respektiert, und validiert systematisch Layout, Typografie, Farben, interaktive Zustände und Reaktionsfähigkeit.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/skills/figma-implement-design

In Ihrer bevorzugten KI fragen

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

Dokumentation

Design implementieren

Überblick

Diese Fähigkeit bietet einen strukturierten Arbeitsablauf, um Figma-Designs mit pixelgenauer Präzision in produktionsreifen Code zu übersetzen. Sie gewährleistet eine konsistente Integration mit dem Figma MCP-Server, die ordnungsgemäße Verwendung von Design-Tokens und eine 1:1-Rückmeldungstreue zu den Designs.

Fähigkeitsgrenzen

  • Verwenden Sie diese Fähigkeit, wenn das Ergebnis Code im Repository des Benutzers ist.
  • Wenn der Benutzer darum bittet, Knoten innerhalb von Figma zu erstellen/bearbeiten/löschen, wechseln Sie zu figma-use.
  • Wenn der Benutzer darum bittet, einen vollständigen Bildschirm in Figma aus Code oder einer Beschreibung zu erstellen oder zu aktualisieren, wechseln Sie zu figma-generate-design.
  • Wenn der Benutzer nur nach Code Connect-Zuordnungen fragt, wechseln Sie zu figma-code-connect-components.
  • Wenn der Benutzer darum bittet, wiederverwendbare Agentenregeln (CLAUDE.md/AGENTS.md) zu verfassen, wechseln Sie zu figma-create-design-system-rules.

Voraussetzungen

  • Der Figma MCP-Server muss verbunden und zugänglich sein.
  • Der Benutzer muss eine Figma-URL im folgenden Format bereitstellen: https://figma.com/design/:fileKey/:fileName?node-id=1-2
    • :fileKey ist der Dateischlüssel
    • 1-2 ist die Knoten-ID (die spezifische Komponente oder der Frame, die/der implementiert werden soll)
  • ODER bei Verwendung von figma-desktop MCP: Der Benutzer kann einen Knoten direkt in der Figma-Desktop-App auswählen (keine URL erforderlich).
  • Das Projekt sollte über ein etabliertes Designsystem oder eine Komponentenbibliothek verfügen (bevorzugt).

Erforderlicher Arbeitsablauf

Führen Sie die folgenden Schritte der Reihe nach aus. Überspringen Sie keine Schritte.

Schritt 1: Knoten-ID abrufen

Option A: Aus Figma-URL parsen

Wenn der Benutzer eine Figma-URL bereitstellt, extrahieren Sie den Dateischlüssel und die Knoten-ID, um sie als Argumente an die MCP-Tools zu übergeben.

URL-Format: https://figma.com/design/:fileKey/:fileName?node-id=1-2

Extrahieren:

  • Dateischlüssel: :fileKey (das Segment nach /design/)
  • Knoten-ID: 1-2 (der Wert des Abfrageparameters node-id)

Hinweis: Bei Verwendung des lokalen Desktop-MCP (figma-desktop) wird fileKey nicht als Parameter an Toolaufrufe übergeben. Der Server verwendet automatisch die aktuell geöffnete Datei, daher wird nur nodeId benötigt.

Beispiel:

  • URL: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15
  • Dateischlüssel: kL9xQn2VwM8pYrTb4ZcHjF
  • Knoten-ID: 42-15

Option B: Aktuelle Auswahl aus der Figma-Desktop-App verwenden (nur figma-desktop MCP)

Bei Verwendung des figma-desktop MCP und wenn der Benutzer KEINE URL bereitgestellt hat, verwenden die Tools automatisch den aktuell ausgewählten Knoten aus der geöffneten Figma-Datei in der Desktop-App.

Hinweis: Die auswahlbasierte Abfrage funktioniert nur mit dem figma-desktop MCP-Server. Der entfernte Server benötigt einen Link zu einem Frame oder einer Ebene, um Kontext zu extrahieren. Der Benutzer muss die Figma-Desktop-App geöffnet haben und ein Knoten muss ausgewählt sein.

Schritt 2: Designkontext abrufen

Führen Sie get_design_context mit dem extrahierten Dateischlüssel und der Knoten-ID aus.

get_design_context(fileKey=":fileKey", nodeId="1-2")

Dies liefert die strukturierten Daten, einschließlich:

  • Layout-Eigenschaften (Auto-Layout, Constraints, Größenanpassung)
  • Typografie-Spezifikationen
  • Farbwerte und Design-Tokens
  • Komponentenstruktur und Varianten
  • Abstände und Padding-Werte

Wenn die Antwort zu groß oder abgeschnitten ist:

  1. Führen Sie get_metadata(fileKey=":fileKey", nodeId="1-2") aus, um die allgemeine Knotenübersicht zu erhalten.
  2. Identifizieren Sie die spezifischen untergeordneten Knoten, die aus den Metadaten benötigt werden.
  3. Rufen Sie einzelne untergeordnete Knoten mit get_design_context(fileKey=":fileKey", nodeId=":childNodeId") ab.

Schritt 3: Visuelle Referenz erfassen

Führen Sie get_screenshot mit demselben Dateischlüssel und derselben Knoten-ID für eine visuelle Referenz aus.

get_screenshot(fileKey=":fileKey", nodeId="1-2")

Dieser Screenshot dient als Quelle der Wahrheit für die visuelle Validierung. Halten Sie ihn während der gesamten Implementierung zugänglich.

Schritt 4: Erforderliche Assets herunterladen

Laden Sie alle Assets (Bilder, Symbole, SVGs) herunter, die vom Figma MCP-Server zurückgegeben werden.

WICHTIG: Befolgen Sie diese Asset-Regeln:

  • Wenn der Figma MCP-Server eine localhost-Quelle für ein Bild oder SVG zurückgibt, verwenden Sie diese Quelle direkt.
  • Importieren Sie KEINE neuen Symbolpakete und fügen Sie keine hinzu – alle Assets sollten aus der Figma-Nutzlast stammen.
  • Verwenden oder erstellen Sie KEINE Platzhalter, wenn eine localhost-Quelle bereitgestellt wird.
  • Assets werden über den integrierten Asset-Endpunkt des Figma MCP-Servers bereitgestellt.

Schritt 5: In Projektkonventionen übersetzen

Übersetzen Sie die Figma-Ausgabe in das Framework, die Stile und die Konventionen dieses Projekts.

Wichtige Prinzipien:

  • Behandeln Sie die Figma MCP-Ausgabe (normalerweise React + Tailwind) als Darstellung von Design und Verhalten, nicht als endgültigen Codestil.
  • Ersetzen Sie Tailwind-Utility-Klassen durch die bevorzugten Hilfsprogramme oder Designsystem-Tokens des Projekts.
  • Verwenden Sie vorhandene Komponenten (Schaltflächen, Eingaben, Typografie, Symbol-Wrapper) wieder, anstatt Funktionalität zu duplizieren.
  • Verwenden Sie das Farbsystem, die Typografie-Skala und die Abstands-Tokens des Projekts konsistent.
  • Respektieren Sie vorhandene Routing-, Statusverwaltungs- und Datenabrufmuster.

Schritt 6: 1:1 Visuelle Rückmeldungstreue erreichen

Streben Sie pixelgenaue visuelle Rückmeldungstreue mit dem Figma-Design an.

Richtlinien:

  • Priorisieren Sie die Figma-Rückmeldungstreue, um Designs exakt zu entsprechen.
  • Vermeiden Sie fest codierte Werte – verwenden Sie Design-Tokens aus Figma, wo verfügbar.
  • Wenn Konflikte zwischen Designsystem-Tokens und Figma-Spezifikationen auftreten, bevorzugen Sie Designsystem-Tokens, passen Sie aber Abstände oder Größen minimal an, um die Optik zu treffen.
  • Befolgen Sie die WCAG-Anforderungen für Barrierefreiheit.
  • Fügen Sie bei Bedarf Komponentendokumentation hinzu.

Schritt 7: Gegen Figma validieren

Bevor Sie die Aufgabe als abgeschlossen markieren, validieren Sie die endgültige Benutzeroberfläche anhand des Figma-Screenshots.

Validierungs-Checkliste:

  • Layout stimmt überein (Abstände, Ausrichtung, Größen)
  • Typografie stimmt überein (Schriftart, Größe, Gewicht, Zeilenhöhe)
  • Farben stimmen exakt überein
  • Interaktive Zustände funktionieren wie entworfen (Hover, Aktiv, Deaktiviert)
  • Reaktionsverhalten folgt den Figma-Einschränkungen
  • Assets werden korrekt gerendert
  • Barrierefreiheitsstandards wurden eingehalten

Implementierungsregeln

Komponentenorganisation

  • Platzieren Sie UI-Komponenten im dafür vorgesehenen Designsystem-Verzeichnis des Projekts.
  • Befolgen Sie die Namenskonventionen für Komponenten des Projekts.
  • Vermeiden Sie Inline-Stile, es sei denn, sie sind für dynamische Werte wirklich notwendig.

Designsystem-Integration

  • Verwenden Sie IMMER Komponenten aus dem Designsystem des Projekts, wenn möglich.
  • Ordnen Sie Figma-Design-Tokens den Projekt-Design-Tokens zu.
  • Wenn eine passende Komponente vorhanden ist, erweitern Sie diese, anstatt eine neue zu erstellen.
  • Dokumentieren Sie alle neuen Komponenten, die dem Designsystem hinzugefügt werden.

Codequalität

  • Vermeiden Sie fest codierte Werte – extrahieren Sie diese in Konstanten oder Design-Tokens.
  • Halten Sie Komponenten komponierbar und wiederverwendbar.
  • Fügen Sie TypeScript-Typen für Komponenten-Props hinzu.
  • Fügen Sie JSDoc-Kommentare für exportierte Komponenten hinzu.

Beispiele

Beispiel 1: Implementieren einer Button-Komponente

Benutzer sagt: „Implementiere diese Figma-Button-Komponente: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15"

Aktionen:

  1. URL parsen, um fileKey=kL9xQn2VwM8pYrTb4ZcHjF und nodeId=42-15 zu extrahieren.
  2. Führen Sie get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15") aus.
  3. Führen Sie get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15") für die visuelle Referenz aus.
  4. Laden Sie alle Button-Symbole vom Asset-Endpunkt herunter.
  5. Überprüfen Sie, ob das Projekt eine vorhandene Button-Komponente hat.
  6. Wenn ja, erweitern Sie diese um eine neue Variante; wenn nein, erstellen Sie eine neue Komponente unter Verwendung der Projektkonventionen.
  7. Ordnen Sie Figma-Farben den Projekt-Design-Tokens zu (z. B. primary-500, primary-hover).
  8. Validieren Sie anhand des Screenshots auf Padding, Randradius und Typografie.

Ergebnis: Button-Komponente, die dem Figma-Design entspricht und in das Projekt-Designsystem integriert ist.

Beispiel 2: Erstellen eines Dashboard-Layouts

Benutzer sagt: „Erstelle dieses Dashboard: https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5"

Aktionen:

  1. URL parsen, um fileKey=pR8mNv5KqXzGwY2JtCfL4D und nodeId=10-5 zu extrahieren.
  2. Führen Sie get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") aus, um die Seitenstruktur zu verstehen.
  3. Identifizieren Sie die Hauptabschnitte aus den Metadaten (Kopfzeile, Seitenleiste, Inhaltsbereich, Karten) und deren untergeordnete Knoten-IDs.
  4. Führen Sie get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId") für jeden Hauptabschnitt aus.
  5. Führen Sie get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5") für die gesamte Seite aus.
  6. Laden Sie alle Assets (Logos, Symbole, Diagramme) herunter.
  7. Erstellen Sie das Layout unter Verwendung der Layout-Primitiven des Projekts.
  8. Implementieren Sie jeden Abschnitt nach Möglichkeit unter Verwendung vorhandener Komponenten.
  9. Validieren Sie das reaktionsfähige Verhalten anhand der Figma-Einschränkungen.

Ergebnis: Vollständiges Dashboard, das dem Figma-Design mit reaktionsfähigem Layout entspricht.

Best Practices

Immer mit Kontext beginnen

Implementieren Sie niemals auf der Grundlage von Annahmen. Rufen Sie immer zuerst get_design_context und get_screenshot ab.

Inkrementelle Validierung

Validieren Sie während der Implementierung häufig, nicht erst am Ende. So werden Probleme frühzeitig erkannt.

Abweichungen dokumentieren

Wenn Sie vom Figma-Design abweichen müssen (z. B. aus Gründen der Barrierefreiheit oder technischen Einschränkungen), dokumentieren Sie dies in Code-Kommentaren.

Wiederverwendung vor Neuerstellung

Überprüfen Sie immer, ob vorhandene Komponenten existieren, bevor Sie neue erstellen. Konsistenz in der gesamten Codebasis ist wichtiger als eine exakte Figma-Reproduktion.

Designsystem zuerst

Wenn Sie sich unsicher sind, bevorzugen Sie die Muster des Projekt-Designsystems gegenüber einer wörtlichen Figma-Übersetzung.

Häufige Probleme und Lösungen

Problem: Figma-Ausgabe ist abgeschnitten

Ursache: Das Design ist zu komplex oder hat zu viele verschachtelte Ebenen, um in einer einzigen Antwort zurückgegeben zu werden. Lösung: Verwenden Sie get_metadata, um die Knotenstruktur zu erhalten, und rufen Sie dann einzelne Knoten mit get_design_context ab.

Problem: Design stimmt nach der Implementierung nicht überein

Ursache: Visuelle Abweichungen zwischen dem implementierten Code und dem ursprünglichen Figma-Design. Lösung: Vergleichen Sie nebeneinander mit dem Screenshot aus Schritt 3. Überprüfen Sie Abstands-, Farb- und Typografiewerte in den Designkontextdaten.

Problem: Assets werden nicht geladen

Ursache: Der Asset-Endpunkt des Figma MCP-Servers ist nicht zugänglich oder die URLs werden geändert. Lösung: Stellen Sie sicher, dass der Asset-Endpunkt des Figma MCP-Servers zugänglich ist. Der Server stellt Assets unter localhost-URLs bereit. Verwenden Sie diese direkt ohne Änderung.

Problem: Design-Token-Werte unterscheiden sich von Figma

Ursache: Die Designsystem-Tokens des Projekts haben andere Werte als die im Figma-Design angegebenen. Lösung: Wenn sich Projekt-Tokens von Figma-Werten unterscheiden, bevorzugen Sie Projekt-Tokens für die Konsistenz, passen Sie aber Abstände/Größen an, um die visuelle Rückmeldungstreue zu wahren.

Design-Implementierung verstehen

Der Figma-Implementierungsarbeitsablauf etabliert einen zuverlässigen Prozess für die Übersetzung von Designs in Code:

Für Designer: Die Gewissheit, dass Implementierungen ihren Designs mit pixelgenauer Präzision entsprechen. Für Entwickler: Ein strukturierter Ansatz, der Rätselraten eliminiert und wiederholte Überarbeitungen reduziert. Für Teams: Konsistente, hochwertige Implementierungen, die die Integrität des Designsystems wahren.

Durch die Befolgung dieses Arbeitsablaufs stellen Sie sicher, dass jedes Figma-Design mit der gleichen Sorgfalt und Liebe zum Detail implementiert wird.

Zusätzliche Ressourcen

Individual skills in this repo

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

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

Verwandte Skills