Communitygithub.com

visuelles-design

Verwenden Sie dies, wenn Sie ein Designsystem aufbauen oder ändern, z. B. Design-Tokens, Farbpalette, Kontrast, Schriften, Schriftskala, Abstandsskala, Dark Mode, Bewegungs-Tokens oder Komponenten-Zustandsspezifikationen. Nicht für das Layout oder die Kritik einer bestimmten Seite oder ein Redesign; verwenden Sie `designer`. Nicht zum Erstellen von Bildern; verwenden Sie `artist`.

Was ist visuelles-design?

Diese Skill-Anleitung beschreibt den systematischen Aufbau eines Designsystems, das die visuelle Grundlage für alle Bildschirme eines Produkts bildet. Es definiert die Erstellung von Design-Tokens für Farbe, Typografie, Abstand, Form, Tiefe und Bewegung sowie die darauf aufbauenden Komponentenspezifikationen. Der Fokus liegt auf der Etablierung eines konsistenten und skalierbaren Systems vor der Anwendung auf konkrete Seiten (was die Aufgabe des `designer`-Skills ist). Die Anleitung betont die Bedeutung einer schriftlichen Designrichtung, semantischer Tokens, Barrierefreiheit (WCAG-Kontrast) und der vollständigen Definition aller Komponentenzustände. Sie ist für Entwickler und Designer gedacht, die mit Tools wie Claude Code, Cursor oder Codex arbeiten, und bietet eine klare Build-Reihenfolge, Farbregeln und viele praktische Hinweise ('Gotchas'), um typische Fehler zu vermeiden. Die Anleitung unterstützt die plattformunabhängige Implementierung von Designsystemen und enthält Verweise auf verwandte Skills wie `designer` und `frontend`.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heliacon/claude-skills/tree/HEAD/skills/visual-design

In Ihrer bevorzugten KI fragen

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

Dokumentation

Visuelles Design

Das System unter jedem Bildschirm: Tokens für Farbe, Schrift, Raum, Form, Tiefe und Bewegung sowie die darauf aufbauenden Komponentenspezifikationen. Der designer-Skill wendet dieses System auf echte Seiten an. Bauen Sie das System einmal; lassen Sie Seiten es ausgeben.

Die wichtigsten Regeln

  1. Schreiben Sie die Designrichtung in Worten, bevor Sie ein Token erstellen. Drei oder vier Sätze: Für wen es ist, wie es sich anfühlen soll, wie es sich niemals anfühlen darf und die eine Sache, die es vom Fachgebiet übernimmt. Jede Token-Entscheidung wird an diesem Absatz gemessen.
  2. Komponenten referenzieren semantische Tokens, niemals Primitive. --color-text-primary, nicht --grey-900. Dark Mode, Theming und Rebrandings werden dann zu einer Neuzuordnung, nicht zu einer Neuschreibung.
  3. Überprüfen Sie den Kontrast für jedes reale Paar in beiden Designs anhand der folgenden Tabelle. Eine Palette, die auf Weiß besteht, kann auf ihrer eigenen getönten Oberfläche versagen.
  4. Ein Standardwert ist keine Entscheidung. Framework-Graustufen, Inter auf allem, ein 4px Radius auf jeder Box: Jedes sieht für sich gut aus, und zusammen sehen sie aus wie jedes andere Produkt. Entscheiden Sie sich für jeden Wert oder akzeptieren Sie ihn bewusst.
  5. Jede Komponentenspezifikation listet jeden Zustand auf: Standard, Hover, Fokus, Aktiv, Deaktiviert, Laden, Fehler und ggf. Ausgewählt. Fehlende Zustände werden im Build erfunden – und das inkonsistent.
  6. Weniger Werte, konsistent verwendet. Eine Skala mit 6 Stufen, die überall verwendet wird, ist besser als eine mit 14 Stufen, die zufällig verwendet werden.

Wann nicht zu verwenden

  • Anordnung einer bestimmten Seite, Auswahl, was oberhalb der Falz kommt, Kritik an einem Bildschirm oder Durchführung eines Redesigns: designer.
  • Erstellen von Illustrationen, Symbolen, Hero-Bildern oder Markenzeichen: artist.
  • Diagramme und Datenvisualisierungspaletten: Der frontend-Skill references/charts.md. Kategoriale Diagrammfarben haben andere Einschränkungen als eine Markenpalette.
  • Implementierung der Tokens in einem Framework: frontend.

Build-Reihenfolge

Jede Ebene baut auf der vorherigen auf:

  1. Richtungsabsatz.
  2. Farbe: Primitive, dann semantische Tokens.
  3. Typografie: Schriften, dann Skala und Rollen.
  4. Abstandsskala und Raster.
  5. Radius, Rahmen und Höhe.
  6. Bewegungs-Tokens.
  7. Komponenten-Tokens und Komponentenspezifikationen.

Farbe

Struktur:

Primitive (Rohwerte, eine Rampe pro Farbton, z. B. 50, 100 ... 900, 950):
  --blue-600: oklch(0.55 0.17 255)

Semantische Tokens (referenzieren Primitive, benannt nach Funktion):
  --color-bg, --color-surface, --color-surface-raised
  --color-text, --color-text-muted, --color-text-on-accent
  --color-accent, --color-accent-hover
  --color-border, --color-focus-ring
  --color-danger, --color-success, --color-warning (jeweils mit einer für Text geeigneten Variante)

Regeln, die eine durchdachte Palette von einer Standardpalette unterscheiden:

  • Erstellen Sie Rampen in OKLCH. Die Helligkeit bleibt über verschiedene Farbtöne hinweg wahrnehmbar gleich, sodass ein 600er Blau und ein 600er Grün das gleiche visuelle Gewicht haben. HSL-Helligkeit lügt.
  • Tönen Sie die Neutraltöne. Reines Grau und reines Schwarz oder Weiß wirken unbesessen. Fügen Sie eine kleine Menge Chroma (etwa 0.005 bis 0.015) in Richtung des Markenfarbtons hinzu.
  • Text auf einer farbigen Oberfläche verwendet einen dunklen Farbton dieser Oberfläche, nicht neutrales Grau. Grau auf Farbe wirkt ausgewaschen.
  • Wählen Sie einen Grad der Festlegung und halten Sie ihn: zurückhaltend (neutraler Grund, eine Akzentfarbe), festgelegt (Markenfarbton durchgängig präsent), volle Palette oder getränkt (Markenfarbton ist der Grund). Eine halbe Festlegung wirkt wie Unentschlossenheit.
  • Lassen Sie Farbe niemals allein Bedeutung tragen. Kombinieren Sie sie mit einem Symbol, einer Beschriftung oder einem Muster.
  • Achten Sie auf die aktuellen Reflexe. Eine warme Cremeseite mit einer Serifen-Auszeichnungsschrift und einem Terrakotta-Akzent oder ein fast schwarzer Grund mit einem säurehaltigen Akzent sind das, wozu generierte Designs greifen, wenn nichts entschieden wurde. Verwenden Sie sie nur, wenn der Richtungsabsatz dies verlangt.

Kontrast (WCAG 2.2)

PaarAAAAA
Fließtext (unterhalb großer Schrift)4,5:17:1
Große Schrift: 24px normal oder etwa 18,7px fett und größer3:14,5:1
UI-Komponentengrenzen, Symbole, Fokusindikatoren, Diagrammmarkierungen mit Bedeutung3:1keine
  • Platzhaltertext, der dem Benutzer etwas mitteilt, ist Text: 4,5:1.
  • Deaktivierte Steuerelemente sind ausgenommen, aber ein Benutzer muss dennoch sehen können, dass ein Steuerelement vorhanden ist.
  • Messen Sie berechnete Farben, einschließlich Deckkraft und Überlagerungen. Eine Beschriftung mit 60 % Deckkraft auf einer getönten Karte ist eine neue Farbe.

Typografie

  • Wählen Sie Schriften basierend auf der Register des Inhalts, nicht aus Gewohnheit. Drei Rollen: eine ausdrucksstarke Auszeichnungsschrift, sparsam verwendet; eine komfortable Fließtextschrift; eine Gebrauchsschrift für Beschriftungen, Bildunterschriften und Daten (Tabellenziffern für Zahlen in Tabellen).
  • Kombinieren Sie mit einem klaren Kontrast (Serife mit Sans-Serife, geometrisch mit humanistisch) oder verwenden Sie eine Familie über verschiedene Strichstärken hinweg. Zwei Schriften, die ähnlich, aber nicht gleich sind, wirken wie ein Fehler.
  • Modulare Skala. Wählen Sie ein Verhältnis: 1,2 für dichte Produkt-UI, 1,25 bis 1,333 für Inhalte und Marketing. Benennen Sie Rollen, nicht Größen: display, h1 bis h4, body-lg, body, body-sm, label, caption.
  • Zeilenlänge 60 bis 75 Zeichen für Fließtext (max-width: 70ch).
  • Auszeichnungsschriften erhalten einen engeren Buchstabenabstand (etwa -0.02em bis -0.04em) und eine Größenobergrenze (etwa 6rem über clamp()). Größer wirkt selten beabsichtigt.
  • text-wrap: balance bei Überschriften, text-wrap: pretty bei Fließtext.
  • Zeilenabstand: etwa 1,5 für Fließtext, 1,1 bis 1,25 für Auszeichnungsschriften.

Raum, Form, Tiefe

  • Abstandsskala auf einer 4er- oder 8er-Basis: zum Beispiel 4, 8, 12, 16, 24, 32, 48, 64. Komponenten verwenden Tokens, niemals rohe Pixelwerte.
  • Radius: zwei oder drei Werte mit einer Regel, wo welcher angewendet wird. Verschachtelte Radien: Der innere Radius entspricht dem äußeren Radius minus dem Abstand zwischen ihnen.
  • Höhe: drei oder vier Ebenen, jede mit einer Funktion (ruhende Karte, Dropdown, Modal). Verwenden Sie in dunklen Designs eine hellere Oberfläche, um die Höhe anzuheben, keinen schwereren Schatten.

Bewegung

  • Tokens: Dauern (z. B. 120ms, 200ms, 320ms) und zwei oder drei Beschleunigungskurven (eine für das Erscheinen, eine schärfere für das Verschwinden). Elemente verwenden sie wieder; niemand wählt einen pro Element spezifischen Wert.
  • Bewegung erklärt eine Änderung: woher etwas kam, was reagiert hat. Bewegung, die nur dekoriert, wirkt generiert.
  • Ein choreografierter Moment ist besser, als wenn alles gleichzeitig einblendet.
  • Beachten Sie prefers-reduced-motion: reduce: Entfernen Sie Bewegung und lange Übergänge, behalten Sie Deckkraftänderungen bei.
  • Skalieren Sie Fotos nicht beim Hovern. Animieren Sie den Container (Schatten, Rahmen, Hintergrund).

Dark Mode

  • Ein dunkles Design ist eine Neuzuordnung von semantischen Tokens, niemals eine Umkehrung. Verwenden Sie dunkle Graustufen für den Grund, nicht reines Schwarz, und reduzieren Sie das Chroma von Akzentfarben, die leuchten.
  • Überprüfen Sie jedes Kontrastpaar im dunklen Design erneut.
  • Verhindern Sie das Aufblitzen des falschen Designs: Bestimmen Sie das Design in einem kleinen Inline-Skript im Dokumentenkopf, vor dem ersten Paint.

Lesen Sie references/dark-mode.md bei der Implementierung von Theme-Wechseln, Persistenz oder Bildern im Dark Mode.

Komponentenspezifikationen

Lesen Sie references/component-spec.md, bevor Sie eine Komponentenspezifikation schreiben. Es enthält die Vorlage und die Checkliste für Zustände.

Fallstricke

  • 11 Farbtöne namens 100 bis 900. Das sind 9 Schritte. Benennen Sie Rampen so, dass Anzahl und Namen übereinstimmen (50, 100 ... 900, 950 ergibt 11).
  • "Große Schrift" bedeutet 18 Punkt, nicht 18 Pixel. 18px normaler Fließtext benötigt 4,5:1, nicht 3:1. Der Schwellenwert für große Schrift ist 24px normal oder etwa 18,7px fett.
  • Primitive Tokens in Komponenten. Funktioniert bis zum ersten Theme. Dann muss jede Komponente bearbeitet werden.
  • Kontrast im Mockup überprüft, nicht im Build. Deckkraft, Überlagerungen und Antialiasing ändern die tatsächliche Farbe. Messen Sie die gerenderten Pixel oder die berechneten Stile.
  • Eine globale Anpassung zur Behebung eines lokalen Problems. Die gesamte Palette abdunkeln, um ein einzelnes fehlschlagendes Paar zu retten, verschiebt alle anderen Paare. Korrigieren Sie das Token des Paares.
  • Ein Token, das niemand verwendet, oder ein Rohwert, den niemand tokenisiert hat. Beides bedeutet, dass das System und der Build auseinandergedriftet sind. Durchsuchen Sie den Build nach rohen Hex- und Pixelwerten.
  • Eine neue Schriftart, die für eine Überschrift geladen wurde. Jede Schriftart kostet Ladezeit. Verwenden Sie die Schriften, die das System bereits lädt.

Überprüfung

  • Richtungsabsatz geschrieben, und jede Token-Familie kann darauf zurückgeführt werden.
  • Jedes Text- und UI-Paar besteht AA in hell und dunkel, gemessen auf der gebauten Seite.
  • Komponenten verwenden nur semantische Tokens: grep zeigt keine rohen Farb- oder Abstandswerte im Komponentencode.
  • Jede Komponentenspezifikation listet alle ihre Zustände auf.
  • Einstellung für reduzierte Bewegung getestet: Es bleibt keine Bewegung übrig.
  • Theme-Wechsel zeigt kein Aufblitzen bei einem harten Neuladen mit der entgegengesetzten Systemeinstellung.

Individual skills in this repo

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

api-design

Use when designing or changing an HTTP API contract, adding or editing a route, endpoint or webhook, writing an OpenAPI spec, choosing error, pagination or versioning shapes. Also when asking "is this a breaking change". Not for server internals such as jobs, retries or rate-limit storage; use `backend-patterns`.

artist

Use when making or directing visual assets such as illustrations, hero images, icons, logos, brand marks, textures or diagrams, or writing prompts for an image-generation model. Covers art direction, reference boards and critique against a brief. Not for page layout; use `designer`. Not for palettes and tokens; use `visual-design`.

copywriter

Use when writing, rewriting or reviewing words a customer reads, such as landing or marketing pages, headlines, taglines, calls to action, pricing pages, product descriptions, onboarding text, button labels, error messages and empty states. Not for long-form docs or articles; use `docs`. Not for positioning strategy; use `marketing`.

designer

Use when asked to critique, redesign or review the layout and hierarchy of a page, screen, landing page or dashboard (hero, CTAs, card grids, testimonials), or when a design \"looks off\", \"looks generic\" or \"looks AI-made\". Use it for any layout feedback, even if the word design is not used. Not for tokens, palettes or type scales; use `visual-design`. Not for images; use `artist`.

frontend

Use when building, reviewing or fixing browser UI, such as pages, components, forms, client state, charts, print or PDF views, accessibility or web performance (Core Web Vitals, bundle size, slow renders). Not for visual direction, layout critique or brand (use `designer` or `visual-design`). Not for native or React Native apps (use `mobile`).

game-design

Use when designing or reviewing how a game plays: core loop, mechanics, game feel and juice, difficulty curve, progression, economy and balance, tutorials, HUD and menus or a game design document (GDD) and playtest plan. Not for engine code or rendering (use `frontend`) or for non-game product UX (use `ux-research`).

ux-research

Use when planning or synthesising user research (interviews, usability tests, surveys), mapping a journey or job to be done, specifying an interaction's states, or running a heuristic review of a flow. Not for menus, labels, taxonomy or site structure; use `information-architecture`. Not for visual polish; use `designer`.

Verwandte Skills