Communitygithub.com

Design Details

Design-Fähigkeit. Entwickle eine originelle, ambitionierte Website-Seite mit dem Designer im Loop, unter Verwendung echter Referenzabschnitte aus dem Design Details MCP. Verwende dies, wenn ein Designer nach einer neuen Landing Page, Homepage, Marketing-Seite oder einer grundlegenden Neugestaltung einer solchen fragt. Nicht geeignet für kleine Styling-Korrekturen, App-Flows oder das Kopieren einer Website.

Was ist Design Details?

Diese Fähigkeit (Skill) unterstützt einen KI-Agenten (wie Claude Code) bei der Erstellung von herausragenden, galerie-würdigen Webseiten, indem sie den Designer im Loop hält und reale, preisgekrönte Referenzen aus dem Design Details MCP nutzt. Der Fokus liegt auf Handwerk und Ambition: die Seite soll nicht nur sauber und korrekt sein, sondern eine mutige, gestalterische Idee umsetzen. Der Arbeitsablauf ist streng strukturiert in sechs Schritte: Briefing, Recherche der mutigsten Referenzen (mit MCP-Suche nach ‚Move‘ und ‚Job‘), Erstellung von zwei grundlegend verschiedenen Gestaltungsrichtungen, Planung jedes einzelnen Abschnitts mit individuellem Layout, anschließender Aufbau im Projekt‑Stack unter Beachtung von Text‑ und Typografie‑Budgets, sowie finale Prüfung und Vorlage beim Designer. Der Skill definiert verschiedene Arten von Mut (type-led, image-led, product-led, object-led, structure-led, quiet) und gibt konkrete Anweisungen zur Komposition, zu Checks wie dem ‚Template Check‘, ‚Gallery Check‘ und zur Vermeidung von wiederholten Layout‑Mustern.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/color2life/design-details-skill/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Design Details?

Das Ziel ist eine Seite, die gut genug ist, um in einer Design-Galerie vorgestellt zu werden – keine saubere Vorlage. Drei Dinge führen gemeinsam dorthin:

  1. Echte Referenzen. Das Design Details MCP enthält Abschnitte von echten, preisgekrönten Websites, jeweils mit einem Screenshot, gemessenen Fakten und einer Bauanmerkung. Schau sie dir an; stelle sie dir nicht vor.
  2. Ambition mit Handwerk. Nimm die kühnste Idee, die eine Referenz bietet, und setze sie richtig um: lesbar, zugänglich, schnell.
  3. Der Designer. Er legt die Ambition fest, wählt die Richtung und genehmigt das Ergebnis. Halte inne und warte auf ihn: nach den Richtungen, nach der Seite und immer dann, wenn er einen Abschnitt als „basic“ markiert.

Eine saubere, korrekte, vergessbare Seite ist ein Misserfolg, kein sicheres Ergebnis.

Mutig ist nicht groß

Riesige Schrift ist eine Möglichkeit, mutig zu sein, und die am meisten überstrapazierte. Seiten, die alle in einem riesigen Wort, ein paar kleinen Zeilen und einem Button enden, sehen gleich aus, egal um welches Geschäft es geht. Die Arten von Mut:

  • Typografie-getrieben: Maßstab und Anordnung der Wörter sind die Idee.
  • Bild-getrieben: Ein Foto oder Film beherrscht den Bildschirm; die Schrift ist bescheiden und sorgfältig platziert.
  • Produkt-getrieben: Das echte Produkt ist der Held, groß und funktionsfähig.
  • Objekt-getrieben: Ein Objekt oder eine Illustration trägt die Idee.
  • Struktur-getrieben: Ein ungewöhnliches Raster, eine Liste, Abfolge oder Interaktion ist die Idee.
  • Ruhig: Kleine Schrift, weiter Raum und ein präzises Detail; Zurückhaltung ist die Aktion.

Wähle nach Aufgabenstellung und Material, nicht danach, was am lautesten wirkt. Die Schrift sollte so groß sein, wie die Idee es braucht, nicht so groß, wie es passt.

Schritt 1 — Briefing

Lies zuerst das Projekt: Marke, Schriftarten, Farben, Tokens, DESIGN.md, Komponenten, Stack. Behalte, was existiert.

Frage einmal, in einer Nachricht, höchstens fünf Fragen, jede mit einem Antwortvorschlag, damit der Designer mit „mach weiter“ antworten kann:

  • Wer und was: Zielgruppe, Angebot, die eine Aktion, die ein Besucher ausführen soll.
  • Material: Was ist echt (Fotos, Produkt, Logo, Text), was kann mit freien Lizenzen vertreten werden und was existiert noch nicht.
  • Gefühl: Ein oder zwei Wörter mit einer Kante. „Sauber und modern“ ist kein Gefühl.
  • Ambition: sicher (vertraut, ruhig), ausdrucksstark (eine einprägsame Bewegung pro Bildschirm; der Standard) oder extrem (Galerie-Niveau: Kompositionen, die eine typische Seite niemals versuchen würde, egal welcher Art oben).
  • Umfang: Welche Abschnitte und ob zuerst Richtungen gesehen werden sollen (Standard: ja).

Wird etwas ausgelassen, nenne die Annahme in einer Zeile und fahre fort. Erfinde niemals Fakten, Zahlen, Kunden, Testimonials, Auszeichnungen oder Kontaktdaten.

Schritt 2 — Auf die Suche nach den kühnsten Referenzen

Wenn das MCP nicht verbunden ist, sage dies, erkläre, wie https://designdetails.io/api/mcp hinzugefügt wird, und frage, ob ohne Referenzen fortgefahren werden soll. Ohne das MCP behaupte keine referenzgestützten Entscheidungen.

Wenn es verbunden ist, folge der MCP-Anleitung. Suche auf zwei Arten:

  1. Nach der Bewegung. Suche nach einer Komposition, aus jeder Branche. Bei ausdrucksstarker und extremer Ambition kommt diese Suche zuerst. Eine Bank kann sich von einem Modelabel leihen. Schreibe jede Suche selbst, ausgehend von diesem Briefing: Beginne mit dem, was nur dieses Unternehmen hat (ein Objekt, ein Moment, ein Material, eine Gewohnheit seiner Kunden) und beschreibe ein Layout, das darum herum aufgebaut ist, in den Worten dessen, was du auf dem Bildschirm sehen würdest. Sende niemals einen Satz, der aus dieser Fähigkeit oder einem früheren Projekt kopiert wurde; dieselben Wörter liefern dieselben Referenzen, und jede Seite sieht am Ende gleich aus.
  2. Für die Aufgabe. Verwende create_page_recipe mit dem Briefing und slots, um Abschnitte abzudecken, die eine strukturelle Passform benötigen (Preise, Buchung, Team).

Spann das Netz weit. Frage nach 20 Ergebnissen pro Suche (limit: 20) und schau über die ersten drei hinaus, bevor du wählst. Verwende jede Website höchstens einmal pro Seite. Ein paar laute Helden passen zu vielen Suchen; verwende einen nur, wenn er besser zu diesem Briefing passt als alles andere, was du gesehen hast, und sage, was du sonst noch in Betracht gezogen hast.

Schau dir die tatsächlichen Bilder an. Text, Links und Bewertungen sind kein Hinsehen. Nenne für jeden starken Kandidaten seine kühnste Bewegung in einer Zeile: das, was eine typische Seite nicht tun würde. Rufe get_section_build_blueprint für die Referenzen ab, von denen du tatsächlich bauen wirst; ihre gemessenen Schriftgrößen, Abstände und Platzierungen sind das, was eine Bewegung zum Funktionieren bringt.

Schreibe für jede Referenz, von der du bauen wirst, eine Kompositionsstudie anhand des Bildes und des Bauplans (Layout, Struktur, Maße, Medienpositionen), weil Bauanmerkungen eher Zutaten als Platzierung beschreiben:

  • wo die Überschrift sitzt (oben, Mitte oder unten; links, zentriert oder rechts), wie viele Zeilen und wie breit;
  • wo die Beschreibung und der Button sitzen und wie kurz sie sind;
  • wie viel vom Bildschirm das Bild einnimmt und wo es Raum zum Wachsen hat;
  • was leer gelassen wird.

Suche nur noch einmal, um eine benannte Lücke zu füllen. Verwende mindestens eine Handvoll Suchen nach der Bewegung, bevor du dich festlegst.

Schritt 3 — Zwei Richtungen, dann stopp

Erstelle zwei Richtungen, die sich in der Art unterscheiden: zwei verschiedene Arten von Mut aus der obigen Liste, mit unterschiedlichem Aussehen. Höchstens eine darf typografie-getrieben sein. Bei ausdrucksstarker oder extremer Ambition ist jede Richtung um die kühnste Bewegung einer Referenz herum aufgebaut, die intakt bleibt. Nenne diese Bewegung in einer Zeile.

Jede Richtung hat ein Aussehen und ein Layout, getrennt gewählt:

  • Aussehen: Das Oberflächensystem (Schriftartenpaarung, Palette, Papier oder Hintergrund, wie Fotos behandelt werden, Ecken und Linien), übernommen vom gesamten Design einer Referenz-Website mit get_website_design.
  • Layout: Die Komposition, übernommen von der Abschnittsreferenz, deren Bewegung es beibehält. Die beiden können von verschiedenen Websites stammen.

Schreibe für jede Richtung zuerst einen kurzen Plan: die Referenzen (IDs und Links), ihre Art von Mut, die Idee in einem Satz, die Bewegung, die sie beibehält, das Aussehen und woher es stammt, was sich für dieses Unternehmen ändert, die Schriftart und Palette (vier bis sechs Farben), die Verwendung des Heldenbildes und was der Besucher zuerst, zweitens und drittens liest.

Dann zwei Überprüfungen:

  • Die Vorlagenprüfung: Würde eine typische Seite in dieser Kategorie so aussehen? Wenn ja, treibe den spezifischen Teil weiter.
  • Die Galerieprüfung: Würde Design Details diesen Eröffnungsbildschirm in seine eigene Bibliothek aufnehmen? Wenn nicht, ist er nicht bereit, gezeigt zu werden.
  • Die Gleichheitsprüfung: Lege die beiden Studien nebeneinander und neben die letzte mit dieser Fähigkeit erstellte Seite, falls vorhanden. Wenn zwei von ihnen eine Form teilen (ein riesiges Wort, ein paar kleine Zeilen, ein Button), ändere eine.

Erstelle eine kurze visuelle Studie des Eröffnungsbildschirms jeder Richtung und zeige sie neben ihren Referenzbildern, wobei die Bewegung benannt wird. Biete an: A, B oder keins von beidem.

Halte inne und warte auf den Designer. Baue die vollständige Seite nicht, bevor er gewählt hat.

Schritt 4 — Plane jeden Abschnitt

Eine Seite ist gut, wenn jeder Abschnitt gestaltet ist, nicht nur der Hero. Bevor du baust, schreibe einen Abschnittsplan. Für jeden Abschnitt:

  • Aufgabe: Die eine Sache, die er vermitteln muss.
  • Layout-Idee: Eine eigene Idee, übernommen von einer inspizierten MCP-Referenz (suche nach der Bewegung, geschrieben aus dem Inhalt dieses Abschnitts, wie in Schritt 2), mit ihrer Kompositionsstudie. Die Art der gemeinten Idee: ein Satz allein mit seinen Schlüsselwörtern, die aufleuchten, oder ein Bild, das durch eine Linie geteilt wird, mit der Behauptung darauf. Diese zeigen die Art; suche nicht wörtlich nach ihnen.
  • Gewicht: ruhig oder reich.
  • Scrollen: Hält den Scroll (angeheftet, schreitet durch) oder nicht.

Dann überprüfe den Plan:

  • Keine Standardabschnitte. Eine Überschrift über gleichen Karten, ein Foto neben Text, eine Überschrift mit einem Button, eine Zahlenreihe, ein Logo-Streifen: jede ist die „basic“ Version. Ersetze sie durch eine Layout-Idee.
  • Rhythmus. Keine zwei Nachbarn teilen eine Form. Auf einen ruhigen Abschnitt folgt ein reicher.
  • Ruhige Oberfläche. Eine Hintergrundfamilie, eine Akzentfarbe, zwei Schriftarten, derselbe Abstand zwischen den Abschnitten. Die Struktur ist mutig; die Oberfläche ist es nicht.
  • Bewegungsobergrenze. Höchstens drei Abschnitte halten den Scroll.
  • Echtes Produkt zuerst. Wo das Unternehmen ein Produkt hat, sind seine echten Bildschirme und echten Daten die stärkste Bildsprache; Fotos sind zweitrangig. Wenn es eine funktionierende App gibt (eine URL oder einen Ordner), führe sie aus und mache Screenshots der echten Bildschirme. Zeichne die Oberfläche nur, wenn nichts existiert, und kennzeichne sie als Beispiel.

Wenn der Designer einen Abschnitt als „basic“ markiert, gestalte nur diesen Abschnitt neu: biete drei Optionen an, keine davon sicher, und behalte den Rest der Seite bei.

Schritt 5 — Bauen

Baue die gewählte Richtung im Stack des Projekts. Lies Handwerk und KI-Tells vor dem Bauen, Bewegung, wenn die Seite sich bewegt.

  • Baue zuerst den Hero, rendere ihn und setze ihn neben seine Referenz. Überprüfe die Kompositionsstudie Punkt für Punkt: Überschriftenposition, Zeilenanzahl, Bildanteil, leerer Raum. Die kühnste Bewegung muss überleben. Wenn sie zu einem vertrauten Layout verweichlicht ist, baue sie neu. Wenn der Text zu lang für die Platzierung ist, kürze den Text, nicht die Platzierung.
  • Ambition überlebt Zugänglichkeit. Wenn eine mutige Bewegung ein Problem erzeugt (Text auf einem belebten Foto, sehr große Schrift, enger Beschnitt), löse es mit Technik: einem Schleier, einem ruhigeren Beschnitt, größerer oder fetterer Schrift, einem festen Band hinter dem Text. Ziehe dich nicht auf das Standardlayout zurück.
  • Eine Designsprache auf der ganzen Seite: dieselben Schriftarten, Größen, Abstände, Oberflächen. Jeder Abschnitt leiht sich sein Layout von seiner Referenz, nicht sein Aussehen.
  • Textbudget (hart), festgelegt durch die Art der Richtung:
    • Typografie- oder objekt-getrieben: eine Überschrift von höchstens sechs Wörtern, eine Zeile von höchstens zwölf Wörtern, ein Button.
    • Bild-, produkt-, struktur-getrieben oder ruhig: eine Überschrift von höchstens zehn Wörtern, höchstens zwei kurze Sätze (etwa dreißig Wörter), ein gefüllter Button und höchstens ein Textlink.
    • Immer: kein Slogan oder Label über der Überschrift, keine zweite Aussage. Abschnittsüberschriften höchstens sechs Wörter; Elemente sind Namen, mit höchstens einer kurzen Zeile, wo es wesentlich ist. Im Zweifelsfall streichen.
  • Typografiebudget (hart): eine Schriftfamilie für fast alles; eine zweite nur für eine eindeutige Rolle; niemals mehr als zwei. Höchstens drei Größen pro Bildschirm. Die größte Größe wird durch die Idee bestimmt: Eine ruhige oder bild-getriebene Seite braucht keine Poster-Überschrift.
  • Echter, spezifischer Text: kurz und selbstbewusst. Echtes oder mit Quellenangabe vertretenes Material; ehrliche Platzhalter nur, wo nichts existiert.
  • Das Briefing gewinnt über die Referenz; die Referenz gewinnt über die Gewohnheit.

Schritt 6 — Überprüfen, dann zeigen

  1. Rendere bei 1440 und 390 Breite. Schau dir die Screenshots an.
  2. Führe den Seitenprüfer aus dem Ordner dieser Fähigkeit aus: node scripts/check-page.mjs <Seitendatei oder URL>. Behebe jedes fail; behebe oder erkläre jedes warn. Er prüft, was ein Skript sehen kann (Labels über Überschriften, Akzentwörter, die Text- und Typografiebudgets, Kontrast, Überlauf, nebeneinander liegende gefüllte Buttons); er beurteilt kein Design.
  3. Gehe die Überprüfung durch: die kühnste Bewegung, die Galerieprüfung, Handwerk und Tells.
  4. Designer-Runden. Führe die Designer-Überprüfung durch, idealerweise von einem frischen Helfer ohne Erinnerung an den Bau: ein Urteil für jeden Abschnitt (genehmigt, halb fertig, schwach, basic), ein Problem und eine Bewegung für jeden nicht genehmigten Abschnitt, dann die gesamte Seite (Nachbarn, Rhythmus, Tells, kleiner Text, Überlappungen). Behebe, rendere neu, überprüfe erneut. Schütze genehmigte Abschnitte. Höchstens drei Runden.
  5. Beende mit einem Urteil: ship, fix oder rebuild.

Zeige dem Designer die Screenshots neben den Referenzen und die Rundenaufzeichnungen mit Vorher-Nachher-Bildern: die Bewegung, die jeder Abschnitt beibehalten hat und von wo, was überprüft und nicht überprüft wurde, und die Platzhalter. Halte inne und warte auf seine Zustimmung. Sein „Nein“ ist eine echte Antwort.

Ehrlichkeit

  • Sage, welche Entscheidungen von Referenzen stammen und welche deine eigenen sind.
  • Bauanmerkungen sind redaktionelle Lesarten, oft KI-geschrieben. Vertraue dem Bild mehr als der Anmerkung.
  • Ein Standbild zeigt keine Bewegung oder mobiles Verhalten. Behaupte dies nicht.
  • Berichte nie etwas als überprüft, das du nicht gerendert gesehen hast.
  • Behaup nicht, dass die Seite besser konvertieren oder einen anderen Workflow übertreffen wird.

Diese Fähigkeit leiht sich Ideen von mehreren Open-Source-Design-Fähigkeiten; siehe Quellenangaben.

Verwandte Skills