Communitygithub.com

Design-Tokens

Erstellt das visuelle System einer Website als CSS Custom Properties, inklusive Farbpalette, Typografie-Skala, Abstände, Radien und Schatten, mit Kontrastprüfung.

Was ist Design-Tokens?

Der Skill „Design-Tokens“ automatisiert die Erstellung eines konsistenten visuellen Systems für Webseiten durch die Definition von CSS-Custom-Properties. Er behandelt alle wesentlichen Design-Aspekte: eine rollenbasierte Farbpalette (Hintergrund, Oberfläche, Text, Akzent), eine fluide Typografie-Skala mit Clamp-Funktionen sowie konsistente Abstände, Radien und Schatten. Der Skill stellt sicher, dass alle Text-Hintergrund-Paare die WCAG-Kontrastanforderungen (mindestens 4,5:1 bzw. 7:1) erfüllen, und bietet Tool-Unterstützung zur automatischen Generierung und Prüfung der Werte. Er ist besonders nützlich für Projekte, bei denen ein einheitliches Erscheinungsbild wichtig ist, wie bei Neubauten ohne definierte Styles, bei Dark-Mode-Implementierungen oder beim Rebranding bestehender Websites. Unterstützte Plattformen umfassen CLI-Tools wie „webcraft“ und MCP-Clients mit dem Tool „generate_tokens“. Die berechneten Werte dienen als erster Entwurf und sollten visuell überprüft werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/design-tokens

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Design-Tokens?

Ein kleiner Satz benannter Werte, der überall verwendet wird, macht eine Website geplant und nicht zusammengewürfelt. Definiere Tokens vor Komponenten; eine spätere Änderung der Marke bedeutet dann nur noch die Bearbeitung eines Blocks.

Was du angeben solltest

Eine Markenfarbe (oder ein Stimmungswort), einen hellen oder dunklen Hintergrund und den Ton (geschäftlich, verspielt, redaktionell, technisch). Alles andere kann abgeleitet werden.

Farbe

Arbeite mit Rollen, nicht mit Farbnamen, damit ein Rebranding keine Umbenennung erfordert.

TokenRolleFaustregel
--bgSeitenhintergrundGebrochenes Weiß oder nahe Schwarz, niemals reines #fff oder #000
--surfaceKarten, Eingabefelder2 bis 4 % Helligkeitsunterschied zu --bg
--textFließtextMindestens 7:1 auf --bg
--mutedSekundärtextMindestens 4,5:1 auf --bg
--borderTrennlinien10 bis 15 % Textfarbe gemischt in Hintergrundfarbe
--accentButtons, HervorhebungenDie Markenfarbe
--accent-inkLinks und Akzenttext auf --bgDie Markenfarbe, abgedunkelt (oder aufgehellt auf dunklem Hintergrund), bis sie 4,5:1 erreicht
--on-accentText auf AkzentDiejenige von Weiß oder Dunkel, die 4,5:1 erreicht

Richtlinien:

  • Töne die Neutralfarben leicht in Richtung des Akzentfarbtons (2 bis 6 % Sättigung). Reine Grautöne neben einem warmen Akzent wirken zusammenhangslos.
  • Verwende den Akzent auf ungefähr 10 % der Fläche. Wenn alles akzentuiert ist, ist nichts akzentuiert.
  • Ein zweiter Akzent ist selten nötig. Füge einen nur für eine eindeutige Bedeutung hinzu, z. B. Erfolg oder Sonderangebot.
  • Für den Dark Mode nicht invertieren. Erhöhe die Helligkeit der Oberfläche mit zunehmender Höhe und reduziere die Akzentsättigung ein wenig, damit es nicht leuchtet.

Wenn die CLI webcraft verfügbar ist, generiere einen Startsatz anstatt die Werte von Hand abzuleiten. Sie wendet alle obigen Regeln an, löst die Helligkeit, bis jedes Paar besteht, und erstellt das dunkle Thema separat:

webcraft tokens "#e4572e" --tone editorial -o tokens.css      # auch: --base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json                 # WordPress theme.json mit denselben Werten

In einem MCP-Client ist dasselbe das Tool generate_tokens. Behandle die Ausgabe als ersten Entwurf: optisch anpassen, dann erneut prüfen.

Überprüfe jedes Text-Hintergrund-Paar vor der Finalisierung:

webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css   # Fallback ohne Installation, nur Hex-Werte

Die erste Form gibt das Verhältnis und die WCAG-Stufen für ein Paar aus. Die zweite liest eine CSS-Datei und prüft die Standard-Rollenpaare in jedem Themenblock (:root, [data-theme], prefers-color-scheme), löst var() auf und liest Hex, rgb(), hsl(), oklch() und color-mix(). Fehlschlagende Paare sind der häufigste Barrierefreiheitsfehler auf neuen Websites, und sie sind für Menschen mit gutem Sehvermögen auf einem guten Monitor unsichtbar, weshalb dies ein Skript und keine Entscheidung nach Gefühl ist.

Typografie

  • Höchstens zwei Schriftfamilien: eine für Überschriften, eine für Fließtext. Eine einzelne Familie in zwei Strichstärken ist oft besser.
  • Paare durch strukturellen Kontrast (Serifen-Auszeichnung mit serifenlosem Fließtext oder kondensierte Auszeichnung mit normalem Fließtext), nicht zwei ähnliche serifenlose Schriften.
  • Fließtextgröße 16 bis 18 Pixel, Zeilenhöhe 1,5 bis 1,7, Zeilenlänge 60 bis 75 Zeichen.
  • Auszeichnungsschrift: Zeilenhöhe 0,95 bis 1,1, negativer Buchstabenabstand, der mit der Größe zunimmt.
  • Fluide Skala mit clamp(), damit es keine Sprünge zwischen den Breakpoints gibt:
:root {
  --step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
  --step-0:  clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
  --step-1:  clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
  --step-2:  clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
  --step-3:  clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
  --step-4:  clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
  --step-5:  clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
  • Lade Schriftarten mit font-display: swap, lade die ein oder zwei Dateien vor, die oberhalb des Falzes verwendet werden, und subsette sie bei Selbsthosting.

Abstände, Radius, Schatten

:root {
  --space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
  --space-6: 1.5rem;  --space-8: 2rem;   --space-12: 3rem;   --space-16: 4rem;
  --section: clamp(4rem, 3rem + 6vw, 9rem);   /* vertikaler Abstand zwischen Abschnitten */
  --gutter:  clamp(1rem, 0.5rem + 3vw, 3rem); /* seitlicher Seitenabstand */
  --container: 76rem;

  --radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
  --shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
  • Wähle eine Ecken-Persönlichkeit (scharf, weich oder Pille) und halte sie ein. Gemischte Radien sind der schnellste Weg, um inkonsistent zu wirken.
  • Der Abstand zwischen Abschnitten sollte deutlich größer sein als der Abstand innerhalb von ihnen; diese Lücke zeigt dem Auge, wo ein Abschnitt endet.

Ausgabe

Liefere eine tokens.css mit einem :root-Block, einem optionalen [data-theme="dark"]-Block und einer kurzen Tabelle, welches Token wo verwendet wird. Gib dann die Kontrastergebnisse für Fließtext, sekundären Text und Button-Text an.

Rebranding einer bestehenden Website

Ordne zuerst vorhandene hartcodierte Werte Rollen zu (durchsuche das CSS nach Hex-Codes und zähle Vorkommen), ersetze sie durch Tokens, überprüfe, ob sich visuell nichts geändert hat, und tausche dann die Token-Werte aus. Beides auf einmal zu tun, macht Regressionen unmöglich nachvollziehbar.

Individual skills in this repo

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

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

launch-qa

Run a pre-launch quality check on a website covering performance, accessibility, SEO basics, forms, cross-device behavior and content, and report findings ranked by severity with fixes. Use this whenever someone says a site is "ready to launch", "going live", asks "can you check my site", wants a QA pass, a website audit, a Lighthouse-style review, or wants to know why a page is slow or scoring badly.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

wordpress-theme-build

Turn a static HTML/CSS/JS design into a custom WordPress theme that the client can edit, covering theme structure, theme.json, enqueueing scripts, block patterns, custom post types and editable content. Use this whenever someone wants to convert a design or static site to WordPress, build a custom or block theme, make sections editable in Gutenberg, add GSAP or other scripts to a theme properly, or asks why their theme edits are lost or their content is hard-coded.

Verwandte Skills