Communitygithub.com

Web Design Playbook

Design-Skill. Workflow für die Design-Implementierung von Websites/Landingpages/HTML-Mockups. Einsetzbar bei Neuerstellung, Redesign oder Anfragen wie „mach es hübsch“. Erzwingt den Ablauf: Referenz-Layer laden → Richtung festlegen → Implementieren → Gerätetest → Lernerkenntnisse sichern. Wird auch verwendet, wenn Nutzer eine Website teilen, die ihnen gefällt („diese Seite ist toll / als Referenz“).

Was ist Web Design Playbook?

Das **Web Design Playbook** ist ein strukturierter Workflow zur konsistenten Design-Implementierung von Websites, Landingpages und HTML-Mockups auf Basis von KI-Agenten (z. B. Claude Code, Cursor oder Codex). Es zwingt den Agenten in einen festen Ablauf aus fünf Schritten: (1) Laden des Referenz-Layers, (2) Festlegen der Designrichtung, (3) Implementierung, (4) Gerätetest vor dem Deployment und (5) Rückführung der Lernerkenntnisse. Das Herzstück ist die zentrale **„Sammeldatei“** unter `~/.claude/design-taste.md`, die als lebendiges Dokument die persönlichen Designvorlieben und bewährten Muster des Nutzers speichert. Wenn der Nutzer beispielsweise eine Website teilt („die sieht toll aus“) oder Reaktionen auf erstellte Designs gibt, werden diese sofort in der Sammeldatei festgehalten. Vor jeder neuen Design-Implementierung liest der Agent diese Datei, um sicherzustellen, dass alle Entscheidungen den bereits validierten Vorlieben entsprechen. Dieses Playbook eignet sich besonders für Agenten, die wiederholt Designarbeit leisten – es reduziert Halluzinationen und stellt sicher, dass der Output jedes Mal konsistent und geschmackssicher ist.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ry071702-prog/web-design-playbook/tree/HEAD/skills/web-design-playbook

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Web Design Playbook?

Ein auf Typs basierender Workflow zur reproduzierbaren Design-Implementierung. Der Kern ist die ständige Interaktion mit der untenstehenden „Sammeldatei“: gute Designs werden absorbiert, die gewonnenen Erkenntnisse aus der Arbeit werden zurückgeschrieben. Dadurch entwickelt sich das Playbook mit jeder Nutzung zu einem immer besser auf den jeweiligen Nutzer zugeschnittenen Typs.

Sammeldatei (Das Herz dieses Skills)

Dies ist die autoritative Quelle für die Designvorlieben und Referenzseiten eines Nutzers. Sie befindet sich unter ~/.claude/design-taste.md. Falls sie noch nicht existiert, wird sie beim ersten Durchlauf mit folgender Vorlage erstellt:

# Design Taste — Meine Design-Sammlung

## Bewährte Prinzipien
<!-- Füge hier zeilenweise hinzu, welche Designmuster beim Nutzer „ziehen“ und welche nicht -->

## Referenzseiten
<!-- Füge hier Seiten hinzu, die dem Nutzer gefallen, zusammen mit einer kurzen Begründung, was daran gut ist -->
| Seite | URL | Was ist gut? |
|---|---|---|

Wann wird hinzugefügt (Absorption)

  • Wenn der Nutzer eine URL teilt und sagt „diese Seite ist toll“, „als Referenz bitte“ oder „so in etwa“, wird die Seite sofort analysiert und das Gute (Layout/Farbwahl/Typografie/Bewegung/Informationsarchitektur) kurz in der Referenzseiten-Liste festgehalten.
  • Wenn aus den Reaktionen des Nutzers auf erstellte Designs hervorgeht, dass ein bestimmtes Muster „zieht“ oder „nicht zieht“, wird dies als einzeiliger Eintrag unter „Bewährte Prinzipien“ hinzugefügt.

Wann wird gelesen (Anwendung)

  • Vor jeder Design-Implementierung MUSS diese Datei gelesen werden (Schritt 1 des Workflows). Sie dient als Entscheidungsgrundlage für Designrichtung, Farbwahl und Bewegung.

Workflow

1. Referenz-Layer laden (MUSS vor der Implementierung)

In dieser Reihenfolge lesen:

  1. DESIGN.md im Projektstammverzeichnis – die autoritative Quelle für das jeweilige Projekt. Höchste Priorität.
  2. Sammeldatei ~/.claude/design-taste.md – die persönlichen, validierten Vorlieben des Nutzers.
  3. Die untenstehenden „Design-Prinzipien (Startwerte)“ – Fallback, falls die ersten beiden nichts hergeben.

2. Richtung festlegen

  • Falls der Ton noch nicht feststeht, zuerst einen groben Entwurf eines Bildschirms (Hero + repräsentativer Bereich) erstellen, um die Richtung vorzulegen und eine Zustimmung einzuholen. Ein Richtungswechsel nach Fertigstellung aller Seiten ist am teuersten.
  • Sobald die Richtung feststeht, wird sie im Projekt mittels DESIGN.md-Format (YAML-Tokens + Prosa für die Absicht) fixiert. Jeder spätere Beteiligte – Mensch oder KI – kann dies lesen und bleibt im Ton konsistent.

3. Implementierung

  • Bevor dekorative Komponenten (Buttons/Überschriften/Karten/Loader/Hintergrundmuster usw.) selbst erstellt werden, prüfen, ob es bereits fertige Teile in Web BENTO gibt.
    • Einzelseiten: https://amix-design.com/tl/web-bento/parts/<slug>.html slug = gradient / heading / button / card / text-effect / divider / hover / glass-shadow / badge / loading / form / background-pattern / speech-bubble / list / alert / table
    • Bei Übernahme an die Projektfarben/Ecken/Rundungen/Fonts anpassen (kommerziell nutzbar, kein Credit nötig; nur eine Weiterverteilung als Sammlung ist untersagt – daher nicht in das Repository einbinden).
  • Bewegung sollte von leichten Implementierungen ausgehen: CSS/Framer Motion → Rive/Lottie → Three.js. prefers-reduced-motion MUSS respektiert werden.

4. Gerätetest (MUSS vor dem Deployment)

  • Im Browser Screenshots bei mindestens drei Breiten (390/880/1280px) machen und visuell prüfen (z. B. mit Chrome DevTools MCP). Dass der Build durchläuft und dass das visuelle Erscheinungsbild stimmt, sind zwei verschiedene Dinge.
  • Japanisch-Check: Umbruchfehler in Überschriften (isolierte Partikel am Zeilenanfang, Worttrennungen), Abschneiden von Elementen, Informationen, die nur sichtbar sind, wenn man mit der Maus darüber fährt.
  • Behandlung japanischer Zeilenumbrüche: Sinnabschnitte in nowrap-Blöcke aufteilen; word-break: auto-phrase; untrennbare Wortgruppen in nowrap-Spans packen.

5. Lernerkenntnisse sichern

  • Sobald anhand der Nutzerreaktionen klar wird, dass ein Muster „zieht“ oder „nicht zieht“, wird dies sofort in der Sammeldatei unter „Bewährte Prinzipien“ festgehalten.
  • Durch diese Wiederholung ersetzt sich die Entscheidungsbasis von „allgemeinen Prinzipien“ hin zu „validierten Vorlieben dieses Nutzers“. Darin liegt der eigentliche Wert dieses Playbooks.

Design-Prinzipien (Startwerte)

Dies sind die Startwerte, bis die Sammeldatei gefüllt ist, und dienen als Fallback. Sie können jederzeit geändert werden, wenn sie nicht passen:

  • Weißer Hintergrund + eine Akzentfarbe + große Typografie + konkretes Motiv zum Thema. Zu viele Farben oder dunkle Farben mit Gold („luxuriös“) wirken schnell wie KI-generierte Vorlagen.
  • Interaktive Spielereien und bewegungsreiche, eventartige Animationen, aber niemals auf Kosten der Lesbarkeit von Informationen.
  • Emotion wird durch die Metapher des Themas erzeugt (Beispiel: Eine Fußballturnier-Seite → Zeitungslayout; eine Vorführungs-Seite → Schulfest-Atmosphäre). Vermeide generische Gradienten + Glaskarten als Standardlösung.

Anpassungsanleitung (Hier eigene Änderungen vornehmen)

StelleWie anpassen
Design-Prinzipien (Startwerte)Sobald persönliche validierte Prinzipien existieren, wird die Sammeldatei zur autoritativen Quelle. Dieser Abschnitt kann gelöscht oder durch die eigenen Muster ersetzt werden.
Pfad der SammeldateiFalls das Team die Datei teilt, lege sie im Repository ab (z. B. design/taste.md) und ändere den Pfad im Text.
Prüfbreiten 390/880/1280pxAn die tatsächlichen Breakpoints des Projekts anpassen.
Japanisch-CheckBei mehrsprachigen Projekten durch die Typografie-Prüfung der Zielsprache ersetzen (z. B. Silbentrennung).
InspirationsquellenFalls der Nutzer präferierte Designer oder Stilrichtungen hat, diese als Referenz in Schritt 1 aufnehmen.

Verbotenes

  • Keine KI-Bildgenerierung, die fiktive IPs, Charaktere oder Produkte erstellt (am gefährlichsten in Kontexten, die reale IPs betreffen). Dekorationen sind auf abstrakte Geometrie, Typografie, Markenfarben, offizielle Assets und echte Fotos beschränkt.
  • Keine Weitergabe von nicht-redistribuierbaren Materialsammlungen oder Inhalten Dritter direkt im Repository; stattdessen per Link darauf verweisen.

Empfohlene Ergänzungen (optional)

  • Taste Skill – Qualitätssicherung gegen Output-Schrott: npx skills add Leonxlnx/taste-skill -g -s design-taste-frontend (+ high-end-visual-design / redesign-existing-projects)
  • DESIGN.md-Prüfung: npx @google/design.md lint

Verwandte Skills