Start / Skills / Web- & UI-Design / Design System (Tokens und Folien)
Web- & UI-Design

Design System (Tokens und Folien)

claudekitMITSprache des Skills: Englisch
Lizenz geprüftEnthält SkripteMittleres Risiko
DemoEchter Lauf · claude-sonnet-5-5 · Oktober 2026
Using the design-system skill, define a three-layer design token set (primitive, semantic, component) for a SaaS dashboard primary button, including hover and disabled states, and show the CSS variables.
Skill: design-system

Here's a three-layer token set for a SaaS dashboard primary button. It follows the skill's rules: no raw values in components, and the semantic layer is the theme switch.

/* ==========================================================
   LAYER 1 — PRIMITIVE: raw values, no meaning attached
   ========================================================== */
:root {
  /* Blue scale */
  --color-blue-50:  #EFF6FF;
  --color-blue-500: #3B82F6;
  --color-blue-600: #2563EB;
  --color-blue-700: #1D4ED8;
  --color-blue-800: #1E40AF;

  /* Neutral scale */
  --color-gray-50:  #F9FAFB;
  --color-gray-100: #F3F4F6;
  --color-gray-200: #E5E7EB;
  --color-gray-400: #9CA3AF;
  --color-gray-900: #111827;
  --color-white:    #FFFFFF;

  /* Spacing (4px base) */
  --space-2: 0.5rem;
  --space-4: 1rem;

  /* Radius, type, motion */
  --radius-md: 0.375rem;
  --font-size-sm: 0.875rem;
  --font-weight-medium: 500;
  --duration-fast: 150ms;
  --ease-standard: cubic-bezier(0.4, 0, 0.2, 1);

  /* Shadow */
  --shadow-sm: 0 1px 2px rgb(17 24 39 / 0.08);
  --shadow-md: 0 4px 8px rgb(17 24 39 / 0.12);
}

/* ==========================================================
   LAYER 2 — SEMANTIC: purpose-based aliases (theme layer)
   ========================================================== */
:root {
  --color-primary:          var(--color-blue-600);
  --color-primary-hover:    var(--color-blue-700);
  --color-primary-active:   var(--color-blue-800);
  --color-on-primary:       var(--color-white);

  --color-muted:            var(--color-gray-100);
  --color-muted-foreground: var(--color-gray-400);
  --color-muted-border:     var(--color-gray-200);

  --color-focus-ring:       var(--color-blue-500);

  --control-padding-y:      var(--space-2);
  --control-padding-x:      var(--space-4);
  --control-radius:         var(--radius-md);
  --elevation-low:          var(--shadow-sm);
  --elevation-mid:          var(--shadow-md);
  --transition-interactive: var(--duration-fast) var(--ease-standard);
}

/* Dark theme: only semantic values are remapped */
[data-theme="dark"] {
  --color-primary:          var(--color-blue-500);
  --color-primary-hover:    var(--color-blue-600);
  --color-primary-active:   var(--color-blue-700);
  --color-on-primary:       var(--color-gray-900);
  --color-muted:            var(--color-gray-900);
  --color-muted-foreground: var(--color-gray-400);
  --color-muted-border:     var(--color-gray-400);
}

/* ==========================================================
   LAYER 3 — COMPONENT: button-specific, references semantic only
   ========================================================== */
:root {
  /* Default */
  --button-primary-bg:      var(--color-primary);
  --button-primary-fg:      var(--color-on-primary);
  --button-primary-border:  transparent;
  --button-primary-shadow:  var(--elevation-low);

  /* Hover */
  --button-primary-bg-hover:     var(--color-primary-hover);
  --button-primary-fg-hover:     var(--color-on-primary);
  --button-primary-shadow-hover: var(--elevation-mid);

  /* Active (pressed) */
  --button-primary-bg-active:     var(--color-primary-active);
  --button-primary-shadow-active: none;

  /* Disabled */
  --button-primary-bg-disabled:     var(--color-muted);
  --button-primary-fg-disabled:     var(--color-muted-foreground);
  --button-primary-border-disabled: var(--color-muted-border);
  --button-primary-shadow-disabled: none;

  /* Shape & type */
  --button-primary-padding: var(--control-padding-y) var(--control-padding-x);
  --button-primary-radius:  var(--control-radius);
  --button-primary-font-size:   var(--font-size-sm);
  --button-primary-font-weight: var(--font-weight-medium);
  --button-primary-focus-ring:  var(--color-focus-ring);
}

Usage: the component rule consumes only layer-3 tokens.

.btn-primary {
  padding: var(--button-primary-padding);
  font-size: var(--button-primary-font-size);
  font-weight: var(--button-primary-font-weight);
  border: 1px solid var(--button-primary-border);
  border-radius: var(--button-primary-radius);
  background: var(--button-primary-bg);
  color: var(--button-primary-fg);
  box-shadow: var(--button-primary-shadow);
  transition: background var(--transition-interactive),
              box-shadow var(--transition-interactive);
  cursor: pointer;
}
.btn-primary:hover:not(:disabled) {
  background: var(--button-primary-bg-hover);
  color: var(--button-primary-fg-hover);
  box-shadow: var(--button-primary-shadow-hover);
}
.btn-primary:active:not(:disabled) {
  background: var(--button-primary-bg-active);
  box-shadow: var(--button-primary-shadow-active);
}
.btn-primary:focus-visible {
  outline: 2px solid var(--button-primary-focus-ring);
  outline-offset: 2px;
}
.btn-primary:disabled,
.btn-primary[aria-disabled="true"] {
  background: var(--button-primary-bg-disabled);
  color: var(--button-primary-fg-disabled);
  border-color: var(--button-primary-border-disabled);
  box-shadow: var(--button-primary-shadow-disabled);
  cursor: not-allowed;
}

State matrix (matches the skill's spec pattern):

Property Default Hover Active Disabled
Background blue-600 blue-700 blue-800 gray-100
Text white white white gray-400
Border none none none gray-200
Shadow sm md none none

Notes

  • Layer rule: components reference semantic tokens, and semantic tokens reference primitives. Nothing skips a layer.
  • Rebranding: change --color-primary and the button follows, with no component edits.
  • Dark theme: the dark block flips --color-on-primary to dark text because blue-500 with white text is only about 3.7:1 contrast. Verify contrast against your final palette.
  • Disabled state: it has a visible border and muted text, so it doesn't rely on color alone.

I haven't run the skill's generate-tokens.cjs or validate-tokens.cjs scripts, and I haven't written these tokens to a file. If you want, I can put them in the starter JSON format, generate tokens.css, and run the validator over src/.

Real run in an isolated folder with only this skill installed. Only the Skill and Read tools were enabled; the model answered from SKILL.md without opening the reference files, and no bundled script was run.

Was es macht

Hilft dem Modell, Design-Tokens aufzubauen und konsequent zu verwenden: dreischichtige Struktur (primitive Werte, semantische Aliase, Komponenten-Tokens), CSS-Variablen, Abstands- und Typografieskalen, Zustandsspezifikationen für Komponenten (Hover, Active, Disabled) und Tailwind-Integration. Dazu kommt ein Foliensystem mit Datentabellen zu Storystrategie, Layout, Typografie, Farbe und Textformeln, mit dem sich HTML-Präsentationen bauen lassen.

So funktioniert es

  1. SKILL.md erklärt die Token-Architektur und verweist auf Referenzdateien zu den Schichten, Komponentenspezifikationen, Zuständen und Tailwind.
  2. generate-tokens.cjs wandelt eine JSON-Token-Datei in CSS-Variablen oder ein Tailwind-Snippet um; validate-tokens.cjs findet fest codierte Werte im Code.
  3. Für Folien durchsucht search-slides.py die mitgelieferten CSV-Tabellen nach Deck-Strategie und Layouts, generate-slide.py schreibt ein HTML-Deck, und die Validatoren prüfen die Token-Konformität.

Geeignet für

Ein Token-System von Grund auf aufsetzen, Komponentenzustände dokumentieren, Designentscheidungen in CSS-Variablen überführen und markenkonforme Pitch-Decks erstellen.

Hinweise & Risiken

Node.js- und Python-Skripte, die lokale Dateien lesen. Zwei schreiben Ausgaben: `generate-tokens.cjs` schreibt CSS in den `-o`-Pfad (überschreibt ohne Rückfrage, legt fehlende Ordner an), `generate-slide.py` schreibt ein HTML-Deck. Übergeben Sie `generate-slide.py` immer `-o`: Der Standardordner wird aus dem Installationsort des Skills abgeleitet (vier Ebenen über dem Skript) und liegt bei Installation auf Benutzerebene außerhalb Ihres Projekts. Zielordner: Wegwerfverzeichnis oder versionierter Ort. Die Skripte stellen keine Netzwerkanfragen (`fetch-background.py` baut nur Pexels-URLs); erzeugte Folien laden Chart.js und Schriften beim Öffnen im Browser von öffentlichen CDNs. Kein Konto, kein Schlüssel nötig. SKILL.md erwähnt Dateien und Werkzeuge, die nicht im Paket sind (`docs/brand-guidelines.md`, `assets/design-tokens.json`, `/slides:create`, Skill `brand`); der Folien-Workflow klappt am besten, wenn Ihr Projekt sie schon hat. Testdatei fehlt.