Communitygithub.com

Jonas-Webdesign

Systematische Frontend-Webdesign- und CSS-Engineering-Skill, basierend auf Jonas Schmedtmanns Webdesign-Regeln, dem 7-Persönlichkeiten-Framework, den 10 Design-Zutaten und fortgeschrittener CSS-Architektur. Zwingender Workflow: Beginnt immer mit der Abstimmung der Website-Persönlichkeit mit dem Benutzer, bevor Code geschrieben wird.

Was ist Jonas-Webdesign?

Diese Skill übersetzt Jonas Schmedtmanns umfassendes Frontend-Curriculum (Webdesign-Regeln, responsive Websites mit HTML & CSS sowie fortgeschrittenes CSS und Sass) in einen systematischen, wiederholbaren Workflow. Sie ist für Entwickler und KI-Agenten gedacht, die hochwertige, konversionsorientierte und responsive Weboberflächen erstellen möchten. Die Skill unterstützt mehrere Plattformen wie Claude Code, Cursor und Codex und zwingt zu einem strukturierten Prozess: Zuerst wird eine Persönlichkeit aus einer Matrix von 7 Website-Charakteren (z.B. 'Serious/Elegant', 'Startup/Upbeat') ausgewählt, dann werden 10 Design-Zutaten (Typografie, Farben, Abstände etc.) mit exakten numerischen Skalen angewendet, und schließlich wird die Implementierung mit semantischem HTML5, BEM-Klassennamen, Flexbox und CSS Grid durchgeführt. Referenzdateien liefern konkrete CSS-Snippets und Token-Voreinstellungen für gängige Projekte wie Omnifood oder Natours.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zjy-dev/skills/tree/HEAD/skills/jonas-web-design

In Ihrer bevorzugten KI fragen

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

Dokumentation

Jonas Webdesign & Fortgeschrittene CSS Skill

Diese Skill übersetzt Jonas Schmedtmanns vollständiges Frontend-Curriculum (Webdesign-Regeln & Richtlinien, Baue responsive, reale Websites mit HTML & CSS und Fortgeschrittenes CSS und Sass) in einen systematischen, wiederholbaren Workflow zur Erstellung eleganter, konversionsorientierter und responsiver Webschnittstellen.

Kernphilosophie: Gutes Webdesign ist kein subjektives Rätselraten. Es ist ein rigoroses System, das auf 7 Website-Persönlichkeiten (plus Merkmalsmischung) basiert, konsistent auf 10 Design-Zutaten angewendet wird und mit Responsiven Einheiten (62,5% rem), Flexbox + CSS Grid sowie einer komponentengetriebenen Architektur entwickelt wird.


🚦 Phase 1: Zwingende Stilabstimmung

KRITISCHE REGEL: Zu Beginn jeder neuen Webseiten- oder UI-Designaufgabe – bevor Implementierungscode geschrieben wird (es sei denn, der Benutzer sagt explizit „Schreib einfach den Code / Überspringe die Bestätigung“) – MUSST du zuerst die visuelle Gestaltung mit dem Benutzer abstimmen und eine proaktive Agentenempfehlung geben.

Schritt 1.1: Schnelle Kontextanalyse (Definieren & Planen)

Leite stillschweigend aus der Anfrage des Benutzers ab:

  • WER & WAS: Branche, Zielgruppe, Geschäftsziel (z. B. Conversion, Markenprestige, Informationsklarheit) und Benutzerziel.
  • Benötigte Stimmung: Welche der 7 Website-Persönlichkeiten dient diesem Ziel am besten und ob eine Sekundärpersönlichkeit (Stil-Mix) eingebracht werden sollte (80 % Primär + 20 % Sekundär).

Schritt 1.2: Präsentiere deine Agentenempfehlung + Optionen

Präsentiere einen strukturierten, prägnanten Stil-Abstimmungsvorschlag (oder verwende das ask_question-Werkzeug, falls verfügbar, zusammen mit einer kurzen Vorschau des visuellen Rezepts):

  1. 🎯 Agentspezifischer Empfehlungsvorschlag (Empfohlene Richtung):
    • Hauptstil (Primärpersönlichkeit) + Stil-Mix (Sekundäre Merkmalseinbringung) (z. B. Startup/Upbeat (Startup/Energiegeladen) + Calm/Peaceful (Ruhig/Friedlich)).
    • Empfehlungsgrund (Warum es passt): 1–2 Sätze, die die Geschäfts-/Benutzerziele des Produkts mit dieser Persönlichkeitskombination verbinden.
    • Vorschau des visuellen Rezepts:
      • Typografie (Schriftart & -größe): Empfohlene Überschriften- & Textschrift-Kombination + Überschriften-Skalierung (52px+ fett vs. leichte Serife).
      • Farbpalette (Farbsystem): Hauptfarbe + Akzentfarbe + getönter Hintergrund + dunkelgrauer Text (mit konkreten Hex-Werten, niemals reines #000).
      • Form & Tiefe (Ecken & Schatten): Randradius (0px scharf vs. 9px–12px freundlich vs. 16px+ verspielt) & Schattenstrategie (keine vs. subtile Erhebung Flat Design 2.0 vs. farbiges Leuchten).
      • Layout & Hero-Muster (Kernlayout & erster Bildschirm): z. B. Geteiltes 2-Spalten-Hero + Featured-in-Streifen + Z-Pattern-Schritte + 3-Spalten-Karten + hervorgehobene Preisstufe.
  2. 🎨 Alternative Stilrichtungen (2 kontrastierende Alternativen): Biete 2 verschiedene alternative Persönlichkeiten aus der Tabelle der 7 Persönlichkeiten an (z. B. Option B: Minimalist/Simple (Minimalistisch/Einfach) + Bold/Confident (Kühn/Selbstbewusst), Option C: Serious/Elegant (Seriös/Elegant)), damit der Benutzer leicht vergleichen und wählen kann.
  3. Warte auf Benutzerbestätigung: Bitte den Benutzer, das empfohlene Rezept zu bestätigen, Option B/C zu wählen oder eine Zutat anzupassen (Farben, Dunkel-/Hellmodus, Rundung). Sobald bestätigt, fahre sofort mit Phase 2 & Phase 3 fort.

🎭 Die 7 Website-Persönlichkeiten Matrix

Jede Design-Zutat muss an die gewählte Website-Persönlichkeit angepasst werden. (Für vollständige CSS :root-Voreinstellungen und Hybrid-Mixing-Regeln lies references/personalities-and-tokens.md).

#PersönlichkeitTypische BranchenTypografieFarbsystemBilder & IconsSchatten & RadiusLayout-Tendenzen
01Serious / Elegant(Seriös/Elegant)Luxus, Immobilien (Nexter), Haute Couture, Schmuck, Boutique-HotelsDünne/leichte Serifen-Überschriften (Playfair Display, Cormorant), kleiner Text (16px)Gold (#c69963), Champagner/Pastell-Cremes (#f9f7f6), tiefes Marineblau (#101d2c), AnthrazitGroße, hochauflösende Produkt-/Raumfotos; keine Icons oder ultra-dünne Linien-IconsKeine Schatten (none)Kein Radius (0px)Kreativ, asymmetrisch, überlappende CSS-Grids, Magazin-Layouts
02Minimalist / Simple(Minimalistisch/Einfach)Portfolios, Designstudios, minimalistische Mode, Entwickler-DokumentationEckige/saubere serifenlose Schrift (Inter, Work Sans), kleine/mittlere TextgrößeMonochrom (#222/#333 auf reinem #fff), max. 1 zurückhaltende FarbeWenige kuratierte Fotos zur Farbgebung; keine Illustrationen; minimale/keine IconsKeine Schatten (none)Kein Radius (0px)Einfach, schmales 1-Spalten-Layout oder sauberes Schweizer Grid mit dünnen Rändern
03Plain / Neutral(Schlicht/Neutral)Enterprise B2B, Finanzen, etablierte Konzerne, DatenportaleNeutrale serifenlose Schrift (Inter, Roboto), kleiner kompakter Text (14–16px)Sichere Firmenblau (#1d4ed8), Schiefergrau (#334155), nichts AuffälligesKleine bis mittlere funktionale Fotos; einfache beschriftete UI-IconsKeine SchattenKein Radius (0–4px)Strukturiert, kompakte Zeilen, Boxen, Seitenleisten, F-Muster, Tabellen
04Bold / Confident(Kühn/Selbstbewusst)Digitalagenturen, Abenteuerreisen (Natours), Sport, starke TechnologieEckige serifenlose Schrift (Montserrat, Lato), riesige fette Großbuchstaben (52–98px, 700+)Mehrere leuchtende gesättigte Farben; große farbintensive AbschnitteViele große, wirkungsvolle Fotos oder Hintergrundvideos; wenige/keine IconsNormalerweise keine SchattenNormalerweise 0px RadiusDiagonale clip-path/geneigte Abschnitte, große Farbblöcke, kühne Grids
05Calm / Peaceful(Ruhig/Friedlich)Gesundheitswesen, Wellness, Ernährung (Omnifood), Hautpflege, Öko-MarkenWeiche Serifen-Überschriften (Lora, Merriweather) oder warme abgerundete serifenlose Schrift (Rubik)Pastell-/Erdtöne: warmes Creme (#fdf2e9), Terrakotta, Salbei, sanftes BlauWarme menschliche Fotos & farblich abgestimmte Illustrationen; häufige Icons in getönten KreisenWenige/weiche SchattenMäßiger Radius (8–12px)Ausgewogene Z-Muster, großzügige Leerräume (96–128px), warme Abschnitte
06Startup / Upbeat(Startup/Energiegeladen)SaaS, KI-Produkte, moderne Apps (Trillo), Fintech, Produktivität1 saubere serifenlose Schrift (Inter, Rubik, Plus Jakarta Sans), mittlere ÜberschriftenBlau, Grün, Indigo, Lila; hellgraue/getönte Hintergründe + subtile Verläufe3D/Vektor-Illustrationen, App-UI-Mockups, subtile Formen; sehr häufige IconsSubtile Schatten + LeuchteffekteHäufiger Radius (9–16px)Kartenreihen, Z-Muster, Logo-Streifen, Preistabellen, 200–400ms Bewegung
07Playful / Fun(Verspielt/Lustig)Kinder-/Haustierprodukte, Essen & Trinken, kreative Communities, lockere SpieleRunde/kreative serifenlose Schrift (Rubik, Quicksand), zentrierter Text üblichMehrfarbige lebendige Paletten über Hintergründe, Karten und TextHandgezeichnete oder 3D-Illustrationen, geometrische Muster; handgezeichnete/Duotone-IconsSubtile oder versetzte SchattenHoher Radius (16px–Pillenform)Collage-Grids, federnde Hover-Interaktionen, lustiger Konversationstext

💡 Profi-Tipp — Merkmalseinbringung (Stil-Mix): Kombiniere 1 Primärpersönlichkeit mit 1 Sekundärpersönlichkeit, um unverwechselbare, nicht generische Designs zu erstellen:

  • Startup/Upbeat + Calm/Peaceful (z. B. Omnifood: SaaS-Conversionsstruktur + warmer #fdf2e9 Creme-Hintergrund & #e67e22 Orange).
  • Startup/Upbeat + Bold/Confident (Moderne SaaS-Karten + übergroße 74px eckige Typografie & dunkle kontrastreiche Abschnitte).
  • Minimalist/Simple + Bold/Confident (Monochromes sauberes Grid + gigantische Typografie & krasse Farbblöcke).

📐 Phase 2: Anwenden der 10 Design-Zutaten & Quantifizierte Skalen

Rate niemals Schriftgrößen, Abstände oder Farben. Erzwinge Jonas' exakte numerische Skalen über CSS Custom Properties (:root). Für alle 86 Regeln der 10 Zutaten konsultiere references/ten-design-ingredients.md.

1. Das strenge Schriftgrößen- & Abstandssystem

Setze html { font-size: 62.5%; } (1rem = 10px) und beschränke alle Schriftgrößen und Abstandswerte auf diese beiden vordefinierten Skalen:

  • Schriftgrößen-Skala (px): 10 / 12 / 14 / 16 / 18 / 20 / 24 / 30 / 36 / 44 / 52 / 62 / 74 / 86 / 98
  • Abstands-Skala (px): 2 / 4 / 8 / 12 / 16 / 24 / 32 / 48 / 64 / 80 / 96 / 128

2. Kernregeln-Checkliste über die 10 Zutaten

  1. Typografie:
    • Verwende 1 Schriftart (oder max. 2: Serifen-Überschrift + serifenloser Text) aus kuratierten Familien (Inter, Rubik, Work Sans, Montserrat, Lato, Playfair Display, Merriweather, Lora).
    • Textkörper: 16px–20px (20px–24px für lange Artikel), Gewicht >= 400, line-height: 1.5–2.0, Zeilenlänge < 75ch (65ch–72ch ideal).
    • Überschriften: 44px–86px+, Gewicht 600–700, enge line-height: 1.05–1.2, negativer letter-spacing: -0.5px bis -1.5px.
    • Augenbrauen-Unterüberschriften: Klein (12px–16px), fett (600–700), GROSSBUCHSTABEN, gesperrt letter-spacing: 0.75px–2px, Farbe des Primärfarbtons.
    • Nie Text ausrichten (text-align: justify) und nie lange Textblöcke (> 3 Zeilen) zentrieren.
  2. Farben:
    • Erstelle ein System aus Hauptfarbe + Grauskala + optionaler Akzentfarbe und generiere Tönungen (gemischt mit #fff für Abschnitts-/Icon-Hintergründe) und Schattierungen (gemischt mit #000 für Hover-Zustände & dunkle Überschriften).
    • Nie reines #000000 für Text verwenden – verwende abgeschwächtes Dunkelgrau (#333, #444, #555).
    • Auf dunklen farbigen Hintergründen verwende eine helle Tönung dieser Hintergrundfarbe für den Textkörper.
    • Halte WCAG-Kontrast ein: >= 4,5:1 für normalen Text, >= 3,0:1 für großen Text (18px+).
  3. Bilder & Illustrationen:
    • Zeige echte Menschen, um Emotionen auszulösen; stelle sicher, dass nebeneinanderliegende Bilder identische Abmessungen haben (aspect-ratio + object-fit: cover).
    • Text auf Bildern: Verwende immer eine von Jonas' 3 Methoden: (1) Abdunkeln/Aufhellen mit linear-gradient(rgba(0,0,0,0.6), ...)-Überlagerung, (2) Text in einen neutralen Bildbereich platzieren oder (3) Text in eine getönte/unscharfe Box setzen.
  4. Icons:
    • Verwende ein einziges SVG-Icon-Paket (Phosphor, Ionicons, Lucide, Heroicons). Mische niemals Pakete oder verwende .png/.jpg.
    • Skaliere rohe Icons niemals über 24px–32px hinaus; wenn ein größerer Funktionsanker (48px–64px) benötigt wird, setze das 24px–32px Icon in einen getönten Kreis/Quadrat (background: var(--color-primary-tint-1); padding: 1.6rem; border-radius: 50%).
  5. Schatten & 6. Randradius:
    • Halte Schatten leicht (rgba(0,0,0,0.05) bis 0.12) und spärlich. Skaliere die Schattenunschärfe mit der Erhebung (klein für Karten, groß für schwebende Modale).
    • Ändere Schatten + translateY(-2px) bei :hover und verringere bei :active. Passe border-radius an die Rundung der Schriftart und die Persönlichkeit an.
  6. Leerraum (Gesetz der Nähe):
    • Verwende massiven Leerraum zwischen Abschnitten (80px–128px, z. B. padding: 9.6rem 0) und Elementgruppen (48px–96px).
    • Elemente, die zusammengehören, müssen näher beieinander sein (z. B. Überschrift näher an ihrem Textabsatz als am Element darüber; Formularlabel näher an seinem Eingabefeld als am vorherigen Feld). Bevorzuge Leerraum gegenüber Trennlinien.
  7. Visuelle Hierarchie:
    • Platziere hochprioritäre Inhalte und CTAs nahe dem oberen Rand.
    • Kombiniere Größe, Gewicht, Farbe und Abstand: entwerte sekundäre Labels/Metadaten (#767676, 14px), damit Titel und wichtige Datenpunkte (Preise, Metriken) hervorstechen.
    • Entwerte Komponente B, um Komponente A hervorzuheben (z. B. kombiniere .btn--full primären CTA mit sekundärem .btn--outline Button; hebe 1 „Bestes Preis-Leistungs-Verhältnis“-Preiskarte mit einem getönten Hintergrund/Band hervor, während die andere Stufe schlicht weiß mit einer dezenten Umrandung bleibt).
  8. Benutzererfahrung (UX):
    • Verwende vertraute Layout-Muster; schreibe beschreibende, nutzenorientierte CTA-Texte (z. B. „Starte gesund zu essen“ anstelle von „Absenden“).
    • Halte Animationen schnell und zielgerichtet (200ms–500ms). Halte blaue/unterstrichene Texte strikt für Links vor.
    • Unterbreche lange Texte mit Unterüberschriften, Blockzitaten, Feature-Boxen und Aufzählungslisten mit Icons.
  9. Komponenten & Layout-Montage:
    • Baue Seiten aus Atomaren Elementen → UI-Komponenten → Abschnittskomponenten → Layout-Mustern (Kartenreihe, Karten-Grid, Z-Muster, F-Muster, Einzelspalte, Seitenleiste, Magazin, asymmetrische Überlappung) zusammen.

🏗️ Phase 3: 7-Schritte-Ausführung & Fortgeschrittene CSS-Entwicklung

Befolge Jonas' 7 Schritte zu einer großartigen Website und Denken – Bauen – Architekturieren-Engineering-Standards (detaillierte Muster in references/css-architecture-and-layouts.md):

  1. Abschnitte definieren & planen: Zeichne den narrativen Fluss vor dem Codieren auf (z. B. Sticky Nav → Hero Split mit Social Proof → Featured-In Logo-Streifen → How It Works Z-Pattern mit 01/02/03 großen Zahlen → Feature/Product Cards mit Tags → Testimonials + Fotogalerie-Grid → Preisvergleich + Feature-Icons → High-Contrast Split CTA Formular → Multi-Column Footer).
  2. Semantisches HTML5 + Flache BEM-Benennung:
    • Verwende <header>, <nav>, <main>, <section class="section-...">, <article>, <figure>, <footer>.
    • Verwende saubere BEM-Klassen (.meal__content, .btn--full, .pricing-plan--complete) und wiederverwendbare Layout-Primitive (.container, .grid, .grid--2-cols, .grid--3-cols, .grid--4-cols, .grid--center-v).
  3. Kombiniere Flexbox (1D) & CSS Grid (2D):
    • Verwende Flexbox für 1D-Komponenten-Interna (Navbars, Button-Reihen, Icon+Label-Listen, vertikale Kartenstapel).
    • Verwende CSS Grid für 2D-Seiten- & Abschnitts-Layouts, asymmetrische überlappende Medien (grid-row / grid-column Spannen) und automatisch responsive Karten-Grids (repeat(auto-fit, minmax(25rem, 1fr))).
  4. Responsive Skalierung & Breakpoints:
    • Skaliere das gesamte Design mühelos, indem du die html-Schriftgröße an Breakpoints reduzieren, an denen das Layout bricht (62,5% → 56,25% bei 1200px → 50% bei 944px), und breche mehrspaltige Grids auf 2 und dann auf 1 Spalte auf mobilen Geräten (<= 544px) zusammen.

📚 Gebündelte Referenzleitfäden

Lade diese Referenzdateien, wenn du konkrete CSS-Snippets, Token-Voreinstellungen oder detaillierte Regeln benötigst:

  • references/personalities-and-tokens.md: Vollständige Aufschlüsselung der 7 Website-Persönlichkeiten, Mischungstabelle für Merkmalseinbringung und kopierbare :root CSS-Custom-Property-Voreinstellungen (Omnifood, Nexter, Natours, Modernes SaaS).
  • references/ten-design-ingredients.md: Die vollständigen 86 Regeln, aufgeschlüsselt nach den 10 Design-Zutaten mit Code-Beispielen und Leitlinien für Farbton- und Schattierungsgenerierung.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills