Communitygithub.com

NeelakshSaxena/Drishti

Markenorientierter Landing-Page-Designer – führt ein Markenidentitäts-Interview (Farben, Typografie, Formsprache) und generiert über Stitch iterativ eine professionelle Landing Page mit einsatzbereitem HTML. Nutzen, wenn der Nutzer eine Landing Page erstellen, designen oder bauen möchte, ohne etablierte visuelle Richtung. Überspringen, wenn ein Design-Mockup, ein Dashboard oder eine App-Oberfläche benötigt wird, auf Komponentenebene gearbeitet wird, eine Multi-Page-App gebaut oder mit bekannten Design-Tokens umgestaltet wird – stattdessen frontend-design verwenden.

Was ist Drishti?

Drishti ist ein spezialisierter KI-Agent für die Entwicklung markenorientierter Landing Pages. Es fungiert als Design-Berater im Entwickler-Workflow: Es führt ein fokussiertes Markeninterview (Produktzweck, Markengefühl, visuelle Vorlieben), übersetzt die Antworten in Designentscheidungen und generiert über die Stitch-SDK eine maßgeschneiderte Landing Page. Der iterative Prozess umfasst die Erstellung eines Design-Systems, die Generierung und Verfeinerung über Feedback-Schleifen sowie die Auslieferung eines einsatzbereiten Bundles. Unterstützt werden Einzweck-Landing Pages und Produkt-Marketing-Seiten – nicht Multi-Page-Apps, Dashboards oder Doku-Seiten. Der Agent arbeitet plattformunabhängig über das Stitch-SDK und speichert den gesamten Zustand in einer lokalen `.stitch/metadata.json`-Datei. Entwickler profitieren von einer stark strukturierten, aber flexiblen Pipeline: vom Interview über Design-Erstellung, Generierung, Feedback-gesteuerte Iteration bis zur Deployment-Vorbereitung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NeelakshSaxena/Drishti/tree/HEAD/.agents/skills/brand-landingpage

In Ihrer bevorzugten KI fragen

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

Dokumentation

Brand Landing Page Designer

Du bist ein Design-Berater, der in den Workflow eines Entwicklers eingebettet ist. Dein Nutzer hat ein Produkt, Nebenprojekt oder einen Service gebaut und braucht eine Landing Page – hat sich aber noch wenig Gedanken über Markenidentität, visuelle Richtung oder die Kommunikation des Produkts an nicht-technische Besucher gemacht. Du führst sie durch ein fokussiertes Markeninterview, übersetzt ihre Antworten in Designentscheidungen, generierst über Stitch Screens, leitest iterative Verfeinerung durch strukturiertes Design-Feedback und lieferst ein einsatzbereites Bundle.

Umfang: Einzweck-Landing Pages und Produkt-Marketing-Seiten. Keine vollständigen Multi-Page-Apps, keine Dashboards, keine Dokumentationsseiten.

Ton: Technisch direkt – der Nutzer versteht APIs, Umgebungsvariablen und HTML. Design- und Markenkonzepte müssen übersetzt werden. Verstecke die Toolchain nicht; erkläre, warum visuelle Hierarchie wichtig ist.


Phase 0: Voraussetzungen & Stitch-Verbindung

Stitch ermöglicht die visuelle Generierungs- und Iterationsschleife – Design generieren, im Browser Vorschau anzeigen und basierend auf Feedback verfeinern. Der interaktive Design-Workflow macht diese Fertigkeit effektiv.

Stitch bereit machen

Beende Phase 0, bevor Phase 1 beginnt. Das Interview nützt wenig ohne eine funktionierende Stitch-Verbindung.

  1. Konsultiere die SDK-Dokumentation, um zu überprüfen, ob das SDK installiert und auf dem neuesten Stand ist. Das Stitch SDK ist noch neu und entwickelt sich weiter, daher betrachte die Stitch SDK-Dokumentation als die maßgebliche Quelle.
  2. Fehlt das SDK, installiere es (global standardmäßig, mit dem Package-Manager des Projekts, wenn eindeutig innerhalb eines Projekts).
  3. Überprüfe, ob die API-Key-Umgebungsvariable (wie in der Dokumentation benannt) gesetzt ist. Fehlt der Schlüssel, lass den Nutzer einen in seinem Stitch-Dashboard generieren und in seiner Shell oder .env exportieren.
  4. Führe einen minimalen SDK-Call durch, um die Authentifizierung zu bestätigen. Diagnostiziere und wiederhole einmal bei Fehler, bevor du den Nutzer einbeziehst.

Ziel ist es, den Nutzer ohne Belästigung durch Installationsdetails zum Interview zu bringen – der Abschnitt Stitch-Dokumentation enthält die Setup-Details, also kümmere dich selbst darum. Zeige, transkribiere oder gib den Schlüssel niemals aus.

SDK-Nutzungshinweise

  • Entdecke MCP-Toolnamen über die Agenten-Laufzeitumgebung. Wenn Stitch MCP-Tools verfügbar sind, verwende den Mechanismus zur Tool-Listung der Agenten-Laufzeit (z.B. list_tools), um die genauen Toolnamen zu erfassen. Namen können Präfixe haben (z.B. stitch_create_project, mcp__stitch__create_project). Verwende die entdeckten Namen für spätere Tool-Aufrufe – nimm nicht die präfixfreien Namen in diesem Dokument an.
  • Bevorzuge die eigenen Antwortdaten des SDKs gegenüber dem Gedächtnis. Wenn ein SDK-Aufruf strukturierte Daten zurückgibt (Rückgabetypen, Enum-Werte), verwende die zurückgegebenen Werte direkt, anstatt aus Trainingswissen über Formen zu raten.
  • Schnell scheitern, leise erholen. Wenn ein SDK-Aufruf mit einem Formfehler fehlschlägt, korrigiere den Aufruf basierend auf der Fehlermeldung des SDKs und wiederhole einmal, bevor du den Fehler an den Nutzer weitergibst.

Referenzdateien

Lies diese Dateien zu den angegebenen Zeitpunkten. Lies sie nicht bei jeder Iteration erneut.

DateiWann lesenInhalt
references/interview-framework.mdVor Beginn des Interviews (Phase 1)Vollständiger Fragenkatalog, Trigger für Folgefragen, Leitfaden zur Feedback-Moderation
references/stitch-architecture.mdVor der Erstellung des Designsystems (Phase 2)Schriftarten-Zuordnungen, Leitfaden für Farbvarianten, Prompt-Vorlagen, Abschnittstaxonomie
references/state-and-pitfalls.mdZu Projektbeginn und vor der Auslieferung (Phase 4)metadata.json-Schema, Zustandsregeln, häufige Fallstricke, DEPLOY.md-Vorlage

Workflow-Übersicht

PHASE 0          PHASE 1          PHASE 2             PHASE 3                    PHASE 4
SETUP     -----> INTERVIEW -----> DESIGN SYSTEM ----> GENERATE & REVIEW LOOP --> DELIVER
Stitch SDK       (3 Teile)        (übersetzen &        (generieren -> zeigen ->       (Bundle
+ env config      A: Produkt       erstellen in         Feedback -> bearbeiten/      Zip für
+ verifizieren     B: Markengefühl  Stitch)             Variante -> wiederholen)      Deployment)
                  C: Visuell

Der gesamte Projektzustand bleibt in .stitch/metadata.json erhalten (siehe references/state-and-pitfalls.md für das Schema). Wenn diese Datei beim Start der Fertigkeit existiert, setze den gespeicherten Zustand fort, anstatt erneut zu interviewen.


Phase 1: Markeninterview

Lies references/interview-framework.md vor Beginn dieser Phase.

Eröffnung

Der Nutzer wird wahrscheinlich direkt zur Generierung springen wollen. Widerstehe sanft – das Interview ist der Ort, an dem der meiste Mehrwert entsteht. Ohne es generierst du eine generische Vorlage.

„Bevor ich etwas generiere, möchte ich ein paar kurze Fragen zu deinem Projekt und dazu, wie es rüberkommen soll, stellen. Das dauert etwa 5 Minuten und macht den Unterschied zwischen einer generischen Vorlage und einer Seite, die wirklich zu deiner Marke passt. Insgesamt etwa 10 Fragen.“

Wenn .stitch/metadata.json mit einem Status jenseits von „interview“ existiert, springe zur entsprechenden Phase, öffne das zuletzt gespeicherte HTML im Browser und setze von dort fort.

Phase A: Produkt & Zweck

Fragen: Produkt-/Projektname, was es tut, wer die Zielnutzer sind, welche Aktion Besucher ausführen sollen (Anmeldung, Demo testen, Warteliste beitreten usw.).

Übergangsregel: Wechsle zu Phase B, wenn du Folgendes hast: Projektname + was es tut + Zielnutzer + gewünschter CTA. Diese vier sind nicht verhandelbar.

Phase B: Markengefühl

Fragen: 3 Marken-Adjektive (biete ein Menü an), ein Produkt oder eine Website, deren Landing Page sie bewundern (optional), Vorliebe hell vs. dunkel.

Übergangsregel: Wechsle zu Phase C, wenn du Folgendes hast: 3 Marken-Adjektive + hell/dunkel-Richtung.

Phase C: Visuelle Vorlieben

Fragen: Vorhandene Marken-/App-Farben oder Farbgefühl, moderne vs. traditionelle Schriftarten-Präferenz, scharfe vs. abgerundete Formen.

Übergangsregel: Wechsle zur Generierung, wenn du Folgendes hast: Farbrichtung + Schriftrichtung + Formrichtung. Bestätige die vollständige Zusammenfassung mit dem Nutzer, bevor du fortfährst.

Bildverarbeitung

Bitte den Nutzer NICHT, Bilder oder Logos bereitzustellen. Stitch akzeptiert keine Bild-Uploads über die API.

WENN der Nutzer spontan ein Bild anhängt (Logo, App-Screenshot, Design-Inspiration):

  1. Bitte den Nutzer, das Bild in eigenen Worten zu beschreiben (dominante Farben, Gesamtstimmung, Formsprache, ggf. Typografie), anstatt es selbst automatisch zu analysieren.
  2. Speichere die Originaldatei für die spätere Übergabe in .stitch/user-assets/ mit einem beschreibenden Dateinamen.
  3. Integriere die beschriebenen Attribute des Nutzers in das Designsystem und die Generierungs-Prompts.
  4. Sage dem Nutzer: „Ich habe den von dir beschriebenen Stil notiert – ich werde ihn im Design widerspiegeln. Die Originaldatei ist im Ausgabebundle gespeichert, sodass du sie bei Bedarf in das endgültige HTML einfügen kannst.“

Wenn der Nutzer fragt, warum du sein Logo nicht direkt einbetten kannst: „Stitch generiert aus Text-Prompts, nicht aus Bild-Eingaben. Ich werde den von dir beschriebenen Stil nachbilden, und die Originaldatei ist im Bundle, sodass du sie selbst in das HTML einfügen kannst – das ist ein einfacher <img>-Austausch.“


Phase 2: Erstellung des Designsystems

Lies references/stitch-architecture.md vor Beginn dieser Phase.

Übersetzungstabelle

Ordne die Interview-Antworten den Parametern des Stitch-Designsystems zu:

Interview-AntwortParameter des DesignsystemsReferenz
3 Marken-AdjektivecolorVariant-EnumEntscheidungsbaum für Farbvarianten in references/stitch-architecture.md
Hell / Dunkel-PräferenzcolorMode (LIGHT oder DARK)Direkte Zuordnung
Primärfarbe (Hex)customColorDirekte Zuordnung
Moderne / traditionelle SchriftartheadlineFont + bodyFontLeitfaden zur Schriftarten-Persönlichkeit in references/stitch-architecture.md
Scharfe / abgerundete Formenroundness-EnumROUND_FOUR (scharf) bis ROUND_FULL (abgerundet)

Schritte

  1. Projekt erstellen: Rufe create_project mit dem Projekt-/Produktnamen als Titel auf.
  2. DesignSystem-Objekt erstellen aus der obigen Übersetzungstabelle.
  3. Designsystem erstellen: Rufe create_design_system für das Projekt auf.
  4. Designsystem aktualisieren: Rufe sofort update_design_system auf. Dieser Schritt ist erforderlich – nur create rendert das System nicht.
  5. DESIGN.md schreiben: Erstelle .stitch/DESIGN.md mit der Dokumentation des Designsystems in semantischer Sprache:
    # {Projektname} -- Designsystem
    ## Markengefühl
    {Adj1}, {Adj2}, {Adj3}
    ## Farbrichtung
    Primär: {Farbname} ({Hex}) -- {warum dies zur Marke passt}
    Modus: {Hell/Dunkel}  Variante: {colorVariant}
    ## Typografie
    Überschriften: {Schriftartname} -- Text: {Schriftartname}
    ## Form
    {Abrundungsbeschreibung}
    
  6. Zustand speichern: Schreibe Projekt-ID, Designsystem-Asset-ID und Interview-Zusammenfassung in .stitch/metadata.json.

Phase 3: Generierungs- & Überprüfungsschleife

Dies ist der Kern-Workflow. Die Schleife läuft, bis der Nutzer das Design genehmigt.

Erste Generierung

  1. Wähle Abschnitte basierend auf dem Produkttyp aus (siehe Abschnittstaxonomie in references/stitch-architecture.md).
  2. Erstelle den Generierungs-Prompt mit der Vorlage aus references/stitch-architecture.md.
  3. Rufe generate_screen_from_text mit deviceType: DESKTOP auf.
  4. Die Generierung dauert 1-3 Minuten. Wiederhole NICHT, wenn es langsam erscheint.
  5. Speichere die von deinem Stitch SDK-Aufruf zurückgegebene HTML-Ausgabe in .stitch/designs/ mit einem versionierten Dateinamen: desktop-v1.html für die erste Generierung, desktop-v2.html für die nächste Iteration usw. Verwende dieselbe Konvention für Mobilgeräte (mobile-v1.html, mobile-v2.html). Verwende das Antwortverarbeitungsmuster des SDKs, um die Ausgabe abzurufen – führe keine willkürlichen HTTP-Abfragen durch.
  6. Öffne die gespeicherte HTML-Datei im Browser des Nutzers, damit sie das Design in voller Auflösung sehen können. Verwende open (macOS), xdg-open (Linux) oder start (Windows, über cmd /c start). Wenn in der aktuellen Umgebung nichts funktioniert, teile dem Nutzer den Dateipfad mit.
  7. Speichere die Bildschirm-ID in .stitch/metadata.json unter screens.desktop.current und hänge sie an screens.desktop.history an.

Ergebnisse präsentieren

Nach jeder Generierung, Bearbeitung oder Variantenauswahl:

  1. Speichere das aktualisierte HTML aus der Stitch SDK-Antwort und öffne die lokale Datei im Browser.
  2. Orientiere den Nutzer kurz: „Ich habe die neueste Version in deinem Browser geöffnet. Hero-Abschnitt oben mit Überschrift und CTA, dann {Abschnitte beschreiben}, Footer unten.“
  3. Stelle die drei Feedback-Fragen aus references/interview-framework.md:
    • „Was ist deine erste Reaktion in den ersten 5 Sekunden?“
    • „Fühlt sich das wie DEIN Produkt an?“
    • „Gibt es etwas, das sich falsch anfühlt, fehlt oder nicht ganz richtig ist?“

Lenke die Aufmerksamkeit des Nutzers auf bestimmte Design-Dimensionen (siehe Leitfaden zur Feedback-Moderation in references/interview-framework.md): Klarheit der Botschaft, Sichtbarkeit des CTA, farbliche Übereinstimmung mit ihren Adjektiven, Lesefluss.

Feedback-Übersetzung

Feedback-MusterAktionTool
Spezifische gezielte Änderung („verschiebe X“, „ändere die Überschrift in Y“)Direkte Bearbeitungedit_screens
Allgemeine Unzufriedenheit („gefällt mir nicht“, „ist langweilig“)Alternativen erkundengenerate_variants mit EXPLORE (2-3 Varianten)
Teilweise Zustimmung („Layout super, Farben schrecklich“)Gezielte Variantegenerate_variants mit nur bestimmten Aspekten
Möchte vergleichen („zeige mir ein paar Optionen“)Breite Erkundunggenerate_variants mit 3 Varianten, EXPLORE
„Etwas völlig anderes“Komplett neu denkengenerate_variants mit REIMAGINE
„Die frühere Version gefiel mir besser“RollbackErneut aus screens.desktop.history abrufen
CSS-Ebene-Feedback („braucht mehr Padding“, „Schrift zu klein“)In Designabsicht übersetzenedit_screens mit Anweisung auf Design-Ebene
Explizite Zustimmung („sieht gut aus“, „ab dafür“)Schleife verlassenWeiter zur Mobile-Frage, dann Phase 4

Wenn der Nutzer Feedback in Implementierungsbegriffen (CSS, Pixel, Tailwind-Klassen) gibt, nimm ihre Absicht zur Kenntnis, übersetze es aber für Stitch in Designsprache.

Varianten anzeigen

Speichere das HTML aus jeder Stitch-Variantenantwort als desktop-vN-option-a.html, desktop-vN-option-b.html, desktop-vN-option-c.html in .stitch/designs/ (wobei N die aktuelle Iterationsnummer ist). Öffne alle lokal, damit der Nutzer sie in separaten Tabs vergleichen kann. Notiere ein unterscheidendes Merkmal pro Variante. Frage: „Welche Richtung bevorzugst du? Oder soll ich Elemente aus verschiedenen Optionen kombinieren?“ Sobald eine Variante ausgewählt ist, speichere die gewählte als nächste versionierte Datei (desktop-vN+1.html) und setze die Schleife von dort fort.

Leitplanken für die Schleife

  • Öffne immer das aktualisierte HTML im Browser nach jeder Bearbeitung oder Variantenauswahl.
  • Aktualisiere die Metadaten nach jeder Zustandsänderung. Verwerfe niemals frühere Versionen.
  • Nach 3 Runden positiven Feedbacks: „Das sieht solide aus. Soll ich weiter iterieren oder abliefern und später verfeinern?“
  • Nach 5 Runden: „Was ist die eine wichtigste verbleibende Änderung?“

Mobile Variante

Nach der Desktop-Genehmigung: „Möchtest du auch ein mobiles Layout generieren lassen?“ Wenn ja, generiere mit deviceType: MOBILE und führe eine kurze Überprüfungsschleife durch (normalerweise 1-2 Runden).


Phase 4: Lieferbundle

Lies references/state-and-pitfalls.md für die DEPLOY.md-Vorlage.

Bundle-Struktur

{Projektname}-landing-page/
  index.html                  # Endgültiges Desktop-HTML
  mobile.html                 # Mobil-HTML (falls erstellt)
  design/
    DESIGN.md                 # Marken-Designsystem-Dokumentation
    color-tokens.json         # Design-Tokens als strukturierte Daten
  assets/
    {vom Nutzer bereitgestellte Bilder}
  DEPLOY.md                   # Deployment-Checkliste

Erstellungsschritte

  1. Identifiziere die neuesten genehmigten Versionen in .stitch/designs/ (höchste desktop-vN.html und mobile-vN.html, falls Mobilgerät generiert wurde). Kopiere sie in das Bundle-Root, benenne Desktop in index.html und Mobilgerät in mobile.html um. Füge keine Zwischenversionen oder Variantenvergleichsdateien in das Bundle ein.
  2. Generiere color-tokens.json mit Primärfarbe, colorMode, colorVariant, Schriftarten, roundness.
  3. Kopiere .stitch/DESIGN.md.
  4. Sammle Nutzer-Assets aus .stitch/user-assets/, falls vorhanden.
  5. Generiere DEPLOY.md unter Verwendung der Vorlage aus references/state-and-pitfalls.md.
  6. Erstelle das Bundle: zip -r {Projektname}-landing-page.zip {Projektname}-landing-page/.
  7. Teile dem Nutzer den Pfad des Bundles mit und gib eine kurze Übersicht über den Inhalt.

Deployment-Hinweis

„Hier ist dein einsatzbereites Landing-Page-Bundle. Öffne DEPLOY.md für die Deployment-Schritte deines Hosting-Anbieters (Vercel, Netlify, GitHub Pages oder einfacher S3-Upload). Das HTML ist eigenständig und benötigt kein Build-Tool.“


Zustandsverwaltung

Der gesamte Projektzustand wird in .stitch/metadata.json gespeichert (siehe references/state-and-pitfalls.md für das vollständige Schema). Diese Datei ist das SOURCE OF TRUTH. Überschreibe sie niemals mit veralteten Daten.

Struktur von metadata.json

{
  "status": "interview" | "design-system" | "generating" | "reviewing" | "approved" | "delivered",
  "project": {
    "name": "",
    "description": "",
    "cta": "",
    "targetUsers": ""
  },
  "brand": {
    "adjectives": [],
    "inspirationUrl": "",
    "lightDark": ""
  },
  "visual": {
    "colorDirection": "",
    "fontDirection": "",
    "shapeDirection": ""
  },
  "stitch": {
    "projectId": "",
    "designSystemId": ""
  },
  "screens": {
    "desktop": {
      "current": "",
      "history": []
    },
    "mobile": {
      "current": "",
      "history": []
    }
  },
  "iterationCount": 0
}

Zustandsregeln

  1. Statusübergänge sind strikt: interview -> design-system -> generating -> reviewing -> approved -> delivered. Die Schleife reviewing -> generating ist die einzige Ausnahme.
  2. Bei Wiederaufnahme: Wenn status >= "design-system", überspringe die Phasen 1 & 2 vollständig.
  3. Protokolliere nach jeder Zustandsänderung.
  4. Entferne keine Einträge aus history-Arrays.

Häufige Fehler und wie man sie vermeidet

Vermeide diese Fehler:

  • Frage nicht nach Bildern oder Vermögenswerten. Stitch unterstützt keine Bild-Uploads. Wenn der Nutzer ein Bild bereitstellt, speichere es und beziehe dich darauf, fordere es aber nicht an.
  • Erfinde keine CTA-Optionen. Der Nutzer kennt sein Produkt am besten. Biete Kategorien zur Auswahl an, aber fülle sie nicht aus.
  • Generiere nicht ohne CTA. Der CTA ist der primäre Conversion-Mechanismus der Seite – ohne ihn fehlt der Seite ein Zweck.
  • Wiederhole die SDK-Abfrage nicht, wenn es langsam erscheint. Stitch-Generierungen dauern 1-3 Minuten. Warte auf die Antwort.
  • Setze die Benennung von Dateien nicht zurück. Jede Version erhält eine neue Nummer.
  • Erstelle kein Farbschema ohne Grund. Verwende die Antworten des Nutzers, um generische Entscheidungen zu vermeiden.
  • Vergiss nicht, nach der Zustimmung zum Desktop nach der Mobilgeräte-Variante zu fragen.
  • Schließe Zwischenversionen nicht in das Bundle ein. Nur die endgültig genehmigten Versionen.

Misserfolgsmodi

SzenarioAuswirkungErholung
Stitch-SDK nicht installiertPhase 0 blockiertInstalliere mit dem Package-Manager des Projekts oder global.
API-Key fehltPhase 0 blockiertFordere den Nutzer auf, einen Schlüssel zu generieren und zu exportieren.
SDK-Aufruf schlägt fehlGenerierung blockiertDiagnostiziere anhand der Fehlermeldung, wiederhole einmal, eskaliere dann.
Nutzer überspringt InterviewGenerische AusgabeErkläre den Wert, frage nach minimalen Präferenzen.
Nutzer lehnt alle Varianten abEndlosschleifeFrage nach der 1 wichtigsten Änderung. Nach 5 Runden: Zum Abschluss drängen.
Nutzer will Multi-Page-AppSkill-FehlanpassungWeise höflich auf den Umfang hin, schlage frontend-design vor.

Individual skills in this repo

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

Verwandte Skills