Communitygithub.com

design-system

Verwendung beim Starten eines Designsystems, Styleguides oder Tokensets, Hinzufügen oder Ändern einer Komponente oder eines Tokens, Standardisieren von auseinanderlaufenden Bildschirmen oder Prüfen eines Guides auf lose Farben, Einzelstücke, fehlende Zustände oder nicht passende Bildschirme.

Was ist design-system?

Dieses Skill hilft KI-Agenten beim systematischen Aufbau, der Änderung und der Prüfung von Designsystemen, Styleguides und Tokensets. Es unterstützt die Erstellung von Design-Token-Schichten (Farben, Typografie, Abstände, Schatten etc.), die Definition von Interaktionsregeln und die strukturierte Entwicklung von Komponenten mit vollständigen Zustandsmatrizen. Der Skill stellt sicher, dass jede Entscheidung einmal getroffen und wiederverwendet wird, und verhindert lose Werte durch einen strikten, rollenbasierten Token-Ansatz. Er kann mit Tools wie Figma, Paper, HTML oder direktem Code verwendet werden, indem Adapter aus dem `references/adapters/`-Verzeichnis gewählt werden. Der Skill erzwingt wichtige Regeln: Keine losen Hex-Farben, eine gemeinsame Änderung von Design und Code, Zustandsmatrizen für alle interaktiven Elemente und das Prinzip 'Bericht zuerst, dann Änderung' bei Audits. Plattformunabhängig durch Adapter, eignet es sich für Agenten in Design- und Entwicklungsworkflows (z.B. Claude Code, Cursor).

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Designsystem

Übersicht

Ein Designsystem ist der Ort, an dem eine Entscheidung einmal getroffen und dann überall wiederverwendet wird. Jede Farbe ist ein Token, jedes interaktive Element zeigt alle seine Zustände, und jede Änderung erreicht jeden Bildschirm, der das Element verwendet. Baue es schichtweise auf, zuerst die Grundlagen, und halte für jede Schicht zur Freigabe an. Ein Audit berichtet und repariert nie von selbst.

Wann verwenden

  • "Erstelle einen Styleguide / ein Designsystem / Tokens für …"
  • Hinzufügen einer Komponente, Variante oder eines Tokens, oder Ändern einer vorhandenen.
  • "Diese Bildschirme konsistent machen", "standardisieren", "den Guide prüfen" oder lose Hex-Werte und Einzelstücke in den Bildschirmen.

Wann NICHT verwenden

  • Eine Frage zu einem einzelnen Wert ("Was ist unsere Primärfarbe?"): beantworte sie.
  • Eine kleine Änderung, die die Person genau beschrieben hat (ein Wert, ein Label, eine Größe), selbst an einem gemeinsam genutzten Element: ändere es einmal an der Stelle, wo es definiert ist, und sage, welche Bildschirme betroffen sind. Keine Zustandsmatrix, kein Stopp.

Bevor du beginnst

  1. Lies DESIGN.md im Projekt-Root, falls vorhanden: Es ist das Design-Briefing des Projekts.
  2. Finde heraus, was existiert: Tokens, der Guide, die Komponenten, die Bildschirme und der Code. Ein vorhandener Guide gewinnt im Aussehen. Folge seinen Regeln, auch wenn sie von den untenstehenden Standardeinstellungen abweichen, und erwähne die Abweichung einmal.
  3. Wähle den Adapter deines Tools in references/adapters/ (paper.md, figma.md, html.md). Wenn kein Adapter zu deinem Tool passt, führe die gleichen Verben in deinem Tool aus und sage, welche du von Hand zugeordnet hast. Ohne Design-Tool überhaupt, baue in HTML (html.md). Wenn du nur ein Bild hast, sage, dass daraus gelesene Werte Schätzwerte sind.
  4. Entscheide den Modus: erstellen, hinzufügen oder ändern oder prüfen.

Schritte · Erstellen

  1. Grundlagenentwurf:

    • Farbrollen (Token-Rollen);
    • Schriftgrößensystem;
    • Abstände;
    • Radius;
    • Schatten (höchstens zwei);
    • Layout-Breiten;
    • Bewegungsdauern;
    • ein kurzer Abschnitt "Wie wir schreiben".

    Benenne Tokens nach Rolle (text-muted, border-hover, danger-bg), niemals nur nach Wert (gray-500).

  2. Interaktionsregeln, einmal: für Elemente mit Rahmen, ohne Rahmen und die primäre Aktion schreibe, wie Hover, Gedrückt, Fokus (nur Tastatur), Deaktiviert, Laden und Ausgewählt aussehen. Komponenten folgen diesen Regeln, anstatt eigene zu erfinden.

  3. Halte an und zeige der Person die Grundlagen und die Interaktionsregeln. Baue noch keine Komponenten.

  4. Komponenten eine nach der anderen, in der Reihenfolge, in der die ersten Bildschirme sie benötigen. Jede erhält einen Guide-Abschnitt mit der Komponenten-Anatomie: eine Legende mit der Regel und dem Warum, Beispiele und eine Zustandsmatrix von Varianten × Zuständen. Füge jede zum Komponentenindex hinzu.

Schritte · Ein Element hinzufügen oder ändern

  1. Prüfe, ob eine vorhandene Komponente plus eine Variante es abdeckt. Bevorzuge Wiederverwendung gegenüber einem Einzelstück.
  2. Zeichne es mit der Anatomie, einschließlich der vollständigen Zustandsmatrix. Eine neue Farbe, Größe oder ein neues Icon wird jetzt zu einem Token oder Icon-Set-Eintrag, nicht später.
  3. Liste jeden Bildschirm und jede Code-Stelle auf, die das Element verwendet.
  4. Halte an und zeige der Person die Änderung und diese Liste.
  5. Nach Genehmigung: propagieren:
    • aktualisiere jeden Bildschirm auf der Liste;
    • aktualisiere den Code, falls vorhanden;
    • aktualisiere den Komponentenindex;
    • berichte, was wo geändert wurde.

Schritte · Prüfen

  1. Führe die Prüfliste über den Guide, die Bildschirme und den Code aus, falls vorhanden.
  2. Schreibe den Bericht: Ergebnisse nach Schweregrad geordnet, jeweils mit Angabe des Ortes, des Grundes und des vorgeschlagenen Fixes.
  3. Halte an und zeige der Person den Bericht. Ändere keine Datei, bis sie sagt, welche Fixes gemacht werden sollen. Das Speichern von Kopien der Originale macht das Bearbeiten nicht akzeptabel.

Regeln

Fest (jedes Projekt):

RegelWarum
Jede Farbe ist ein Token; keine losen Hex-Werte in Bildschirmen oder CodeLose Werte entwickeln sich zu fast identischen Duplikaten, die niemand auf einmal ändern kann
Ein Icon-SetGemischte Sets sehen aus wie gemischte Produkte
Design und Code ändern sich gemeinsam, Design zuerstSonst ist der Guide innerhalb einer Woche nicht mehr die Wahrheit
Jedes interaktive Element hat eine ZustandsmatrixAd-hoc gezeichnete Zustände auf Bildschirmen stimmen nie überein
Eine Änderung an einem gemeinsam genutzten Element wird mit den betroffenen Bildschirmen aufgelistet, bevor sie propagiert wirdSonst gestaltet eine "kleine" Änderung leise zwanzig Bildschirme um

Standardeinstellungen (ein vorhandener Guide überschreibt sie):

StandardWarum
Bei Hover verdunkeln Elemente mit Rahmen nur den RahmenEin sich ändernder Hintergrund auf Karten und Feldern wirkt schwerfällig
Hover ist dezenter als AusgewähltWenn Hover wie Ausgewählt aussieht, denken Leute, zwei Dinge seien ausgewählt
Auswählen ändert nie die SchriftstärkeEine Gewichtsänderung verschiebt die Textbreite
Platzhalter sind heller als deaktivierter TextSonst liest sich ein Platzhalter wie eingegebener Text
Elemente in gestapelten Listen und Menüs haben einen kleinen Abstand, nie berührendBerührende Hervorhebungen verschmelzen zu einem Block
Der Fokusring erscheint nur über die TastaturEin Ring nach einem Mausklick sieht aus wie ein Fehler
Laden behält die exakte Größe des ElementsLayout-Verschiebung
Schatten nur auf schwebenden Dingen (Menüs, Popover, Dialoge, Toasts) in zwei StärkenSchatten überall flachen die Hierarchie, die sie erzeugen sollten
Maximal eine primäre Aktion pro BildschirmZwei Primäre bedeuten, der Bildschirm hat sich nicht entschieden

Fertig, wenn

  • Erstellen: Grundlagen und Interaktionsregeln genehmigt; jede Komponente hat ihre Anatomie, Zustandsmatrix und einen Indexeintrag.
  • Ändern: Jeder gelistete Bildschirm und jede Code-Stelle aktualisiert und der Index aktualisiert.
  • Prüfen: Ein geordneter Bericht geliefert und keine Datei geändert.

Häufige Fehler

GedankeRealität
"Ich baue den ganzen Guide auf einmal: Tokens und zehn Komponenten"Zehn Komponenten auf nicht genehmigten Grundlagen bedeuten zehn Überarbeitungen. Grundlagen, Stopp, dann Komponenten.
"Das Audit hat Probleme gefunden, ich korrigiere sie einfach"Die Person ist vielleicht mit der Hälfte der Korrekturen nicht einverstanden. Bericht, Stopp, korrigiere nur, was sie auswählt.
"Ich habe die Originale in einem Backup-Ordner behalten, also ist Korrigieren sicher"Ein Backup sorgt nicht dafür, dass die Person mit den Korrekturen einverstanden ist. Bericht zuerst.
"Buttons haben Hover und Deaktiviert, das reicht"Eine Zustandsmatrix hat jeden Zustand × jede Variante: Normal, Hover, Gedrückt, Fokus, Deaktiviert, Laden, Ausgewählt.
"--teal-600 ist ein Token"Es ist ein Wert. Komponenten brauchen Rollen (--color-primary), damit der Wert an einer Stelle geändert werden kann.
"Dieser Bildschirm braucht eine leicht andere Karte"Mach sie zu einer Variante der Karte oder verwende die Karte. Ein Einzelstück ist der Beginn von Abweichung.

Verwandte Skills