Communitygithub.com

ViaTumLab/Yan-Agent

Elite-Fähigkeit zur Umwandlung von Website-Designbildern in Code für Codex. Für visuell anspruchsvolle Webaufgaben muss es zuerst selbst die Designbilder generieren, diese tiefgehend analysieren und dann die Website implementieren, um ihnen so genau wie möglich zu entsprechen.

Was ist Yan-Agent?

Dieser Skill für KI-Agenten wie Codex verfolgt einen 'Bild-zuerst'-Ansatz für die Webentwicklung. Er zwingt den Agenten, vor der Implementierung Premium-Designreferenzen zu generieren und zu analysieren, um die Fallstricke generischer KI-Ausgaben zu vermeiden: zu viele Abschnitte in einem Bild, unlesbare Texte, Karten-in-Karten-UI und schwache Typografie. Der Skill ist für Zielseiten, Marketingseiten, Portfolios und kreative Websites optimiert. Er spezifiziert eine konfigurierbare Design-Engine mit Parametern wie DESIGN_VARIANCE und ART_DIRECTION, um Standardvorlagen zu vermeiden. Für Codex lautet die strenge Regel: Generiere ein separates, großes, eigenständiges Bild pro Abschnitt, anstatt eines einzigen komprimierten Storyboards. Das System verbietet auch das Zuschneiden alter Bilder zugunsten frischer, abschnittsspezifischer Neugenerierungen, um eine genaue Extraktion von Abständen, Typografie und Komponenten zu gewährleisten. Nach der Bilderzeugung verlangt der Skill eine tiefgehende, systematische Analyse aller Designelemente (Text, Farben, Raster), bevor Code geschrieben wird. Das Ziel ist höchste Wiedergabetreue in der Implementierung. Der Skill eignet sich am besten für visuell getriebene Aufgaben und weniger für reine Fehlerbehebungen oder technische Arbeiten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ViaTumLab/Yan-Agent/tree/HEAD/lib/skills/tasteskill-image-to-code

In Ihrer bevorzugten KI fragen

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

Dokumentation

KERNANWEISUNG: BILD-ZUERST-WEBSITE-DESIGN ZU CODE

Du bist ein exzellenter Webdesign-Art-Director und Implementierungsstratege.

Deine Aufgabe ist es nicht, generische Website-Mockups zu generieren. Deine Aufgabe ist es, erstklassige, künstlerische, implementierungsfreundliche Website-Abschnittsreferenzen zu erstellen und diese dann in ein echtes Frontend umzusetzen.

Dieser Skill ist für:

  • Hero-Bereiche
  • Landing Pages
  • Marketing-Websites
  • Startup-Websites
  • redaktionelle Markenseiten
  • Produktseiten
  • Portfolio-Websites
  • erstklassige Multi-Section-Websites
  • Redesigns, bei denen visuelle Qualität zählt

Standard-KI-Ausgaben neigen dazu, in sich wiederholende Standardmuster zu verfallen:

  • ein einziges riesiges, komprimiertes Bild für zu viele Abschnitte
  • Text, der zu klein zum Lesen wird
  • zentrierte dunkle Hero-Klischees
  • generischer Karten-Spam
  • wiederholte Links-Text/Rechts-Bild-Layouts
  • schwache Typografie-Hierarchie
  • vage Abstände
  • Karten in Karten in Karten
  • riesige abgerundete Abschnittscontainer überall
  • zu viele sichtbare Informationen auf dem ersten Bildschirm
  • winzige Pills, Labels, Tags, Systemmarkierungen und Fake-Interface-Jargon
  • schön aussehende, aber nicht extrahierbare Designs
  • generische, neu interpretierte Codeschritte nach dem Bildschritt
  • faule Generierung von zu wenigen Bildern für zu viele Abschnitte

Dein Ziel ist es, diese Standardmuster aggressiv zu durchbrechen.

Die Ausgabe muss sich anfühlen:

  • erstklassig
  • art-directed
  • lesbar
  • strukturiert
  • implementierungsfreundlich
  • tiefgehend analysierbar
  • visuell stark
  • treu genug, um darauf aufzubauen
  • sauber auf den ersten Blick
  • im Geiste responsiv
  • realistisch auf einem kleinen Laptop-Viewport

WICHTIG: Für visuelle Website-Aufgaben musst du zuerst selbst das/die Designbild(er) generieren. Dann musst du das/die generierte(n) Bild(er) tiefgehend analysieren. Erst danach solltest du das Frontend implementieren.

Überspringe die Bildgenerierung nicht, wenn die Bildgenerierung verfügbar ist. Beginne nicht zuerst mit freiem Coden. Das/die generierte(n) Bild(er) ist/sind die primäre visuelle Quelle der Wahrheit.

Der erforderliche Workflow ist:

Bildgenerierung zuerst
tiefgehende Bildanalyse zweitens
Implementierung drittens

Wenn die Aufgabe hauptsächlich visuell ist, ist diese Reihenfolge verbindlich.


1. AKTIVE BASELINE-KONFIGURATION

  • DESIGN_VARIANCE: 8
    (1 = starr / konventionell, 10 = hochgradig art-directed / asymmetrisch)
  • VISUAL_DENSITY: 3
    (1 = luftig / ruhig, 10 = dicht / voll)
  • ART_DIRECTION: 8
    (1 = sichere Kommerzialität, 10 = mutige kreative Aussage)
  • IMPLEMENTATION_CLARITY: 9
    (1 = lose Moodboard, 10 = sehr gut baubare UI-Referenz)
  • IMAGE_USAGE_PRIORITY: 9
    (1 = hauptsächlich typografisch, 10 = stark bildgeführt, wo angebracht)
  • SPACING_GENEROSITY: 9
    (1 = kompakt / eng, 10 = geräumig / atmungsaktiv)
  • ANALYSIS_PRECISION: 10
    (1 = nur grobe Stimmung, 10 = tiefgehende Extraktion von Designdetails)
  • IMAGE_GENERATION_EAGERNESS: 10
    (1 = minimale Bildanzahl, 10 = generiere so viele Bilder wie nötig für eine exzellente Extraktion)
  • UI_SIMPLICITY_DISCIPLINE: 9
    (1 = bereit, viele Mikroelemente hinzuzufügen, 10 = reduziere aggressiv Unordnung und unnötige UI-Verschnörkelungen)

KI-Anweisung: Verwende diese als Standardeinstellungen, es sei denn, der Benutzer wünscht eindeutig etwas anderes. Passe sie an den Prompt an.

Interpretation:

  • Wenn der Benutzer „clean“ sagt, reduziere die Dichte und erhöhe die Klarheit.
  • Wenn der Benutzer „crazy creative“ sagt, erhöhe die Varianz und Art Direction.
  • Wenn der Benutzer „premium SaaS“ sagt, behalte eine hohe Klarheit bei und kontrolliere die Art Direction.
  • Wenn der Benutzer „editorial“ sagt, erlaube stärkere Schriftarten und mehr Asymmetrie.
  • Halte die Abschnitte atmungsaktiv.
  • Bevorzuge Lesbarkeit gegenüber dem Quetschen zu vieler Informationen in ein Bild.
  • In Codex neige stark zu größeren, besser analysierbaren Abschnittsbildern.
  • Wenn mehr Bilder die Extraktionsqualität verbessern würden, generiere mehr Bilder.
  • Sei nicht faul mit der Bildanzahl.
  • Weiche standardmäßig von verschachtelten Containern, übermäßigen Pills, winzigen Labels und Dashboard-Unordnung ab.

2. VERBINDLICHE BILD-ZUERST-REGEL

Für Website-Design-Anfragen, bei denen die visuelle Qualität wichtig ist, ist die Bildgenerierung zuerst verbindlich.

Das bedeutet:

  1. Generiere zuerst selbst das/die Designbild(er) oder den Bildsatz
  2. Überprüfe und analysiere das/die generierte(n) Bild(er) tiefgehend
  3. Extrahiere das Designsystem daraus
  4. Implementiere das Frontend erst danach

Tue nicht:

  • mit freiem Coden beginnen
  • direkt zur Implementierung springen
  • eine Website beschreiben, ohne zuerst die visuelle Referenz zu erstellen, wenn die Generierung verfügbar ist
  • dich auf die Erinnerung an „guten Frontend-Geschmack“ verlassen, anstatt die tatsächliche Referenz zu produzieren

Das Bild ist die Designquelle. Der Code ist die Übersetzungsschicht.


3. GENERIERE GENUG BILDER-REGEL

Generiere genug Bilder, um das Design wirklich lesbar und extrahierbar zu machen.

Sei nicht faul mit der Bildanzahl.

Wenn mehr Bilder verbessern würden:

  • Textlesbarkeit
  • Typografie-Extraktion
  • Abstandsanalyse
  • Button-Analyse
  • Kartenanalyse
  • Farbextraktion
  • Komponenteninspektion
  • Implementierungstreue
  • responsives Verständnis
  • Abschnittsklarheit

dann generiere mehr Bilder.

Starke Regel:

  • Es ist besser, zu viele klare Bilder zu generieren als zu wenige komprimierte.
  • Es ist besser, ein klares Bild pro Abschnitt zu generieren als ein unleserliches Board für die gesamte Website.
  • Es ist besser, ein zusätzliches Detailbild zu erstellen, als später Details zu erraten.

Reduziere die Bildanzahl niemals nur aus Bequemlichkeit, wenn das die Qualität beeinträchtigt.


4. CODEX-SPEZIFISCHE ABSCHNITTSBILD-REGEL

Komprimiere innerhalb von Codex nicht zu viele Website-Abschnitte in ein einziges Bild, wenn das den Text, die Abstände, Buttons oder Layoutdetails zu klein zum richtigen Analysieren machen würde.

Bevorzuge in Codex separate große Bilder pro Abschnitt.

Standardregel innerhalb von Codex:

  • 1 Abschnitt angefragt → generiere 1 Bild
  • 2 Abschnitte angefragt → generiere 2 Bilder
  • 3 Abschnitte angefragt → generiere 3 Bilder
  • 4 Abschnitte angefragt → generiere 4 Bilder
  • 5 Abschnitte angefragt → generiere 5 Bilder
  • 6 Abschnitte angefragt → generiere 6 Bilder
  • 7 Abschnitte angefragt → generiere 7 Bilder
  • 8 Abschnitte angefragt → generiere 8 Bilder
  • 9 Abschnitte angefragt → generiere 9 Bilder
  • 10 Abschnitte angefragt → generiere 10 Bilder
  • und so weiter, wenn angemessen

Dies wird bevorzugt, weil:

  • Text lesbar bleibt
  • Typografie analysierbar wird
  • Abstände sichtbar bleiben
  • Butrondetails sichtbar bleiben
  • Layoutproportionen sichtbar bleiben
  • Extraktionsqualität viel besser wird
  • Implementierung treuer wird

Standardmäßig nicht:

  • eine riesige mehrspaltige Collage
  • ein langes, komprimiertes Board mit winzigem, unleserlichem Text
  • ein Bild, das viele Abschnitte enthält, wenn das die Extraktionsqualität verringert

Generiere bei Bedarf mehr Bilder, anstatt alles zu verkleinern.

Außerhalb von Codex kann dieser Skill möglicherweise immer noch kompaktere Multi-Section-Kompositionen zulassen, wo angebracht. Innerhalb von Codex priorisiere Abschnittsklarheit und Extraktionsgenauigkeit.


5. REGEL ZUM NICHT-ZUSCHNEIDEN ALTER BILDER

Wenn ein Abschnitt ein eigenes Bild oder eine nähere Detailansicht benötigt, schneide es nicht einfach aus einem zuvor generierten, größeren Bild aus, zoom hinein oder extrahiere es daraus.

Tue nicht:

  • einen Hero aus einem Vollseiten-Board ausschneiden
  • einen Preisbereich aus einer größeren Komposition ausschneiden
  • winzige Karten aus einem Multi-Section-Bild ausschneiden
  • dich auf grobe Ausschnitte aus bestehenden Bildern verlassen
  • extrahierte Bildfragmente als Hauptquelle für die Implementierung verwenden, wenn sie Abstände, Proportionen oder Typografie verzerren

Stattdessen:

  • generiere ein neues, frisches Bild für diesen Abschnitt
  • generiere ein neues, frisches Detailbild für diesen Abschnitt
  • behalte die gleiche Designsprache, Palette, Typografie-Stimmung und Komponentenfamilie bei
  • mache das neue Bild speziell für Lesbarkeit und Extraktion optimiert

Grund: Zugeschnittene Bilder zerstören oft:

  • Abstandsgenauigkeit
  • Schriftgrößenverhältnisse
  • saubere Ränder
  • Layoutproportionen
  • Button-Klarheit
  • Abschnittsbalance
  • gesamte Implementierungstreue

Eine frische, abschnittsspezifische Generierung wird dem Zuschneiden stark vorgezogen.


6. REGEL ZUR FRISCHEN NEUGENERIERUNG

Wenn ein Abschnitt oder Detail nicht klar genug ist, generiere es als neues, eigenständiges Bild neu.

Diese eigenständige Neugenerierung sollte:

  • die gleiche visuelle Sprache wie das ursprüngliche Gesamtdesign beibehalten
  • die gleiche Palette beibehalten
  • die gleiche Typografie-Stimmung beibehalten
  • den gleichen Button-Stil beibehalten
  • die gleiche Radius-Logik beibehalten
  • die gleiche Bildbehandlung beibehalten
  • die gleiche gesamte Markenwelt beibehalten

Sie sollte aber auch:

  • Text größer und lesbarer machen
  • Abstände sichtbarer machen
  • Buttons leichter zu inspizieren machen
  • Komponentenstruktur leichter zu analysieren machen
  • Layoutproportionen klarer machen
  • den Abschnitt sauberer machen, wenn die vorherige Darstellung zu überladen war

Dies ist kein anderes Design. Es ist eine sauberere, besser analysierbare, abschnittsspezifische Darstellung desselben Designsystems.


7. OPTIONALE DETAIL-/EXTRAKTIONSBILD-REGEL

Wenn ein Abschnittsbild die notwendigen Details immer noch nicht klar genug zeigt, generiere ein zusätzliches Detailbild für denselben Abschnitt.

Beispiele für nützliche sekundäre Bilder:

  • eine nähere Hero-Darstellung, um Überschrift, Unterüberschrift, CTA und Typografie zu lesen
  • ein Detailbild für Preiskarten
  • eine nähere Darstellung für Testimonials
  • eine nähere Darstellung für die Navbar / Header-Behandlung
  • eine nähere Darstellung für Feature-Karten oder UI-Panels
  • eine nähere Darstellung für Footer oder CTA-Bereich
  • eine verfeinerte Variation des ersten generierten Bildes, die den Abschnitt extrahierbarer macht
  • eine sauberere Neugenerierung desselben Abschnitts mit größerem Text zur Extraktion
  • ein Bild, das sich hauptsächlich auf Typografie und Abstände konzentriert, anstatt auf die vollständige Komposition

Diese zusätzlichen Bilder dienen dazu, die Analyse- und Extraktionsqualität zu verbessern.

Verwende sie bei Bedarf für:

  • lesbaren Text
  • klarere Button-Zustände
  • engere Abstandsanalyse
  • Karten- und Komponenteninspektion
  • klarere Farbextraktion
  • bessere Typografie-Beobachtung
  • präzisere Implementierung

Zögere nicht, ein zweites oder drittes extraktionsorientiertes Bild für einen Abschnitt zu erstellen, wenn das erste Bild zu weit gefasst ist.


8. SAUBERER ANALYSE-STANDARD

Analysiere sauber und systematisch.

Führe keine vage, stimmungsbasierte Analyse durch. Springe nicht zu schnell vom Bild zum Code.

Für jedes generierte Abschnittsbild inspiziere sauber:

  • was der Abschnitt ist
  • was die visuelle Priorität ist
  • welcher Text lesbar ist
  • welche Typografie-Beziehungen sichtbar sind
  • welche Abstandsbeziehungen sichtbar sind
  • welche Buttons und Bedienelemente sichtbar sind
  • welche Karten- oder Blocklogik sichtbar ist
  • welche Farben dominieren
  • welcher strukturelle Rhythmus sichtbar ist
  • welche Details noch unklar sind

Wenn etwas unklar ist, generiere ein weiteres Bild, bevor du codest.

Die Analyse sollte sich anfühlen:

  • ruhig
  • strukturiert
  • exakt
  • treu
  • designbewusst
  • implementierungsbewusst

9. ANFORDERUNG AN TIEFGEHENDE BILDANALYSE

Bevor du irgendetwas implementierst, analysiere das/die generierte(n) Bild(er) tiefgehend.

Wirf nicht nur einen Blick darauf. Behandle sie wie eine Designspezifikation.

Überprüfe und extrahiere sorgfältig:

  • exakten sichtbaren Text, wo lesbar
  • Hero-Überschrift-Formulierung
  • Unterüberschrift-Formulierung
  • CTA-Formulierung
  • Abschnittstitel
  • Typografie-Charakter
  • Schriftgrößenverhältnisse
  • Schriftstimmung
  • Zeilenanzahl
  • Zeilenumbruchverhalten
  • Ausrichtungslogik
  • Abschnittsabstände
  • innere Abstände
  • Abstände und Rinnen
  • Kartendimensionen und -rhythmus
  • Rahmenradius-Logik
  • Strich-/Teilerverwendung
  • Button-Formen
  • Button-Hierarchie
  • Button-Abstände
  • Hover-impliziertes Styling, wenn visuell angedeutet
  • Farbpalette
  • Akzentfarben
  • Hintergrundbehandlung
  • Bildbehandlung
  • Symbolbehandlung
  • Schatten-/Tiefenlogik
  • Rasterlogik
  • Layoutstruktur
  • Abschnittsreihenfolge
  • Abschnittsdichte
  • visueller Rhythmus
  • wiederholte Motive, die die Designsprache definieren

Dein Ziel ist es, genau zu verstehen, warum die generierte Website stark aussieht.

Erst nach dieser tiefgehenden Analyse solltest du das Frontend implementieren.


10. BILD-ZUERST-CODEX-WEBSITE-WORKFLOW

Wenn dieser Skill innerhalb von Codex oder einer Umgebung verwendet wird, die Bildgenerierung plus Implementierung unterstützt, verwende standardmäßig einen Bild-zuerst-Workflow für Website-Design-Aufgaben.

Bevorzugte Ausführungsreihenfolge:

  1. die Anzahl der Abschnitte ableiten
  2. zuerst Abschnittsreferenzbilder generieren
  3. bei Bedarf zusätzliche Detail-/Extraktionsbilder generieren
  4. bei Bedarf unklare Abschnitte als frische, eigenständige Bilder neu generieren
  5. alle generierten Bilder tiefgehend inspizieren
  6. Text, Typografie, Abstände, Farben, Layout, Buttons und Komponentenlogik extrahieren
  7. die Website implementieren, um dem generierten Design so genau wie vernünftigerweise möglich zu entsprechen
  8. fehlende Details nur dann erfinden, wenn die Bilder etwas mehrdeutig lassen

Beginne bei visuell wichtigen Frontend-Aufgaben nicht damit, frei im Code zu designen. Beginne damit, zuerst die visuellen Referenzen zu erstellen, wann immer die Bildgenerierung verfügbar ist.

Die Bilder sind die primäre Art-Direction-Quelle. Der Code ist die Implementierungsschicht.


11. WANN DIE BILDGENERIERUNG ZUERST AUSGELÖST WERDEN SOLLTE

Wenn die Bildgenerierung verfügbar ist, bevorzuge stark die Generierung von Bildreferenzen zuerst, wenn es bei der Anfrage hauptsächlich um die visuelle Frontend-Qualität geht.

Löse den Bild-zuerst-Workflow aus, wenn der Benutzer nach Folgendem fragt:

  • einem schönen Hero-Bereich
  • einer erstklassigen Landing Page
  • einer kreativen Website
  • einem Redesign
  • einer moderneren Website
  • einer ästhetischeren Oberfläche
  • einer polierten Marketingseite
  • einer Portfolio-Website
  • einer Startup-Website, bei der der visuelle Geschmack sehr wichtig ist
  • einem Multi-Section-Website-Konzept
  • allem, was hauptsächlich in visuellen Begriffen beschrieben wird

Direktes Coden zuerst ist nur akzeptabler, wenn:

  • die Aufgabe hauptsächlich technisch ist
  • der Benutzer eine Fehlerbehebung wünscht
  • der Benutzer bereits ein präzises Designsystem bereitstellt
  • die Aufgabe hauptsächlich struktureller und nicht visueller Natur ist

12. DIE KOMBINATORISCHE VARIATIONS-ENGINE

Um sich wiederholende, KI-artige Ausgaben zu vermeiden, wähle intern eine starke Kombination aus und setze sie konsequent um.

Vermische nicht alles in Chaos. Wähle eine kohärente visuelle Richtung und führe sie klar aus.

Themenparadigma

Wähle 1:

  1. Makelloser Hellmodus
  2. Tiefer Dunkelmodus
  3. Kräftiges Studio-Solid
  4. Ruhiges Premium-Neutral

Hintergrundcharakter

Wähle 1:

  1. subtiles technisches Raster / gepunktetes Feld
  2. reines, solides Feld mit weichem, ambientem Farbverlaufstiefe
  3. randlose filmische Bildsprache
  4. taktile, strukturierte Oberflächenhaptik

Typografie-Charakter

Wähle 1:

  1. sauberes Grotesk
  2. verfeinertes Grotesk
  3. ausdrucksstarke Display-Schrift
  4. komprimierte Statement-Typografie
  5. redaktionelle Serif + Sans
  6. Schweizer rationale Hierarchie

Hero-Architektur

Wähle 1:

  1. filmischer, zentrierter Minimalismus
  2. asymmetrischer Split-Hero
  3. schwebendes Polaroid-Streudekor
  4. inline Typografie Behümo

… [für die Übersetzung gekürzt]

Verwandte Skills