Communitygithub.com

design-craft

Zeigt einem Agenten, wie er Frontend-Design und -Build künstlerisch anleitet und umsetzt, mit konkretem Output wie Landingpage, Homepage oder Portfolio. Der Ablauf durchläuft Design Craft, Ordnung der Bedürfnisse, 1. Rahmen (vor jeglichem Code). Verwende dies, wenn ein neuer Auftrag dieses Handwerk erfordert.

Was ist design-craft?

Dieses Skill dokumentiert eine systematische Arbeitsmethode für Frontend-Design und -Build, die einen Agenten von der ersten konzeptionellen Rahmung bis zur finalen Übergabe führt. Es folgt einer strengen 'Ordnung der Bedürfnisse' (funktional → zuverlässig → benutzbar → genussvoll) und stellt sicher, dass keine Stufe übersprungen wird. Der Kernprozess umfasst acht Schritte: Rahmen, Finden der Signatur, günstiges Erkunden, System zuerst, alle Zustände, Emotion & Ehrlichkeit, Bewegung und Verifikation. Besonders wertvoll ist die detaillierte Anleitung zur Interaktionsgestaltung mittels 'Signature Interaction', die auf dem eigentlichen Thema basiert, sowie die klaren Motion-Tokens und engineering-spezifischen Fallstricke. Das Skill ist plattformunabhängig und für jede Codebasis geeignet, die CSS/CSS-in-JS und JavaScript/TypeScript verwendet. Es verweist auf zahlreiche Referenzdateien für tiefgehende Themen wie Motion Engineering, Design-Systeme und emotionale Gestaltung, die bei Bedarf gelesen werden sollen. Die abschließende Checkliste und das Rationale-Template erleichtern die Qualitätssicherung und Übergabe.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Design Craft

Eine Arbeitsmethode für Frontend-Design und -Build. Die SKILL.md enthält alles, was jede Aufgabe benötigt; die references/ Dateien bieten Tiefe, Zahlen und Code. Lese eine davon, wenn ihr Auslöser in der Tabelle am Ende zutrifft.

Umfang: Eine neue Seite, ein neuer Flow oder eine neue Komponente durchläuft die Schritte 1-8. Eine kleine Änderung (ein Zustand, eine Animation, ein String) durchläuft nur die davon betroffenen Schritte, dann Schritt 8 für das, was sich geändert hat.

Ordnung der Bedürfnisse

Funktional → zuverlässig → benutzbar → genussvoll. Füge niemals Freude zu etwas hinzu, das kaputt, langsam oder verwirrend ist, und liefere niemals ohne die oberste Schicht aus: Persönlichkeit, die auf "später" verschoben wird, wird selten ausgeliefert.

1. Rahmen (vor jeglichem Code)

  • Job-Story: Wenn [Situation], möchte ich [Motivation], damit ich [Ergebnis]. Unbekannte Situation oder Ergebnis → frage nach, oder formuliere die Annahme als Hypothese in deiner Zusammenfassung.
  • Wähle den Ehrgeiz, den das Briefing verlangt, und investiere Mühe dort:
BriefInvestieren inErster Proof
Markenauftritt, "Premium", "Award-Niveau", "voller Animationen"Eine signifikante Interaktion, die im Thema verankert ist (Schritt 2)Die Interaktion funktioniert mit echten Inhalten: Anfang, Mitte, Unterbrechung, Loslassen
Launch, Editorial, Marketing-SeiteDas Angebot ist klar und seine besten Belege sind erkundbarErster Bildschirm auf einem Telefon lesbar; Hauptaktion ohne Wartezeit erreichbar
App, Tool, DashboardDie schwierigste Entscheidung, Kosten eines Fehlers, Geschwindigkeit der wiederholten NutzungEine realistische Aufgabe mit sich ändernden Daten, plus Erholung von einem Fehler
Komponente oder Design-SystemEin Verhaltensvertrag, der zwei verschiedene Konsumenten überlebtDieselbe Komponente in zwei Kontexten mit langen Inhalten
  • Trenne Fakten von Annahmen. Nenne den emotionalen Zustand des Besuchers bei der Ankunft; er bestimmt den Ton.
  • Prüfe, was existiert: Tokens, Komponenten, Patterns, Konventionen. Wiederverwenden vor Erfinden.

2. Finde die Signatur im Thema

Für ausdrucksstarke Arbeit suche nach einer Eigenschaft des Themas, die der Besucher erkennen würde, wenn das Logo abgedeckt ist, und einem Verb, das es ihnen erlaubt, es zu steuern. Ein Bier gießt sich ein, schäumt und zeigt seine Farbe; ein Stoff fällt; eine Schriftart hat Achsen; eine Uhr hat ein Uhrwerk. Gestalte die Interaktion um diese Eigenschaft herum.

  • Substitutionstest: Tausche eine nicht verwandte Marke ein. Wenn der Effekt immer noch unverändert funktioniert, handelt es sich nicht um das Thema. Kehre zum Thema zurück, bevor du Feinschliff hinzufügst.
  • Vier Beats: Was lädt zur Eingabe ein → was reagiert bei Kontakt → was wird bei anhaltender Eingabe enthüllt → was bleibt beim Loslassen erhalten. Ein durchgängiges Objekt sollte alle vier tragen.
  • Mehr Effekte beheben nie "es fühlt sich einfach an". Ändere stattdessen die zentrale Idee oder Mechanik.
  • Jede Geste erhält ein einfaches Äquivalent (einen Schieberegler, einen Button, eine Radiogruppe), das dieselben Informationen erreicht.

3. Günstig erkunden, den schwierigsten Teil zuerst beweisen

  • Beschreibe mindestens drei strukturell unterschiedliche Ansätze in jeweils wenigen Zeilen. Wähle einen aus, begründe warum.
  • Gestalte einen Standbild mit echten Inhalten vor der Bewegung: Lesereihenfolge, Typografie, Bildmaterial, primäre Aktion. Ein Standbild aus der Mitte einer Animation sollte ebenfalls absichtlich aussehen.
  • Baue die riskanteste Behauptung zuerst (die Geste, die Scroll-Szene, den schwierigen Workflow) und überprüfe sie in einem echten Browser, bevor du den Rest der Seite darum herum baust.

4. System zuerst

  • Tokens vor Komponenten. Komponenten verbrauchen semantische Tokens (--color-action), die auf Primitive aliassen (--amber-400). Kein Hex, px oder magische Zahlen innerhalb von Komponenten-Styles.
  • Abstände auf einer 4er-Skala (4, 8, 12, 16, 24, 32, 48, 64). Body 16px/1rem bei 1.5 Zeilenhöhe; Überschriften 1.1-1.25. Ein modulares Schriftverhältnis. Maximal zwei Schriftarten (+ Mono). Tabellenziffern für sich ändernde Zahlen.
  • 1-3 Markenfarben, Neutralfarben, Statusfarben. Jedes Textpaar erfüllt WCAG AA (4.5:1 Fließtext, 3:1 groß/UI). Farbe ist niemals das einzige Signal.
  • Bewegungs-Tokens (Dauern, Easing) leben neben Farbe und Abstand.
  • Props benennen die Bedeutung (variant="destructive"), nicht das Aussehen. Wiederholte Überschreibungen bedeuten eine fehlende Variante.

5. Jeder Zustand, nicht nur der Glückspfad

Interaktive Komponenten: Standard, Hover, focus-visible, aktiv, deaktiviert, laden, Fehler, ausgewählt. Bildschirme: leer, laden, teilweise, Fehler, Erfolg, offline. Asynchrone Arbeit:

  • Letzte Anfrage gewinnt; eine langsame ältere Antwort darf eine neuere nicht überschreiben.
  • Behalte die Eingabe des Benutzers nach jedem Fehler bei und behalte vorherige Ergebnisse sichtbar (abgedimmt) während des Ladens.
  • Leeres Konto, keine Ergebnisse und fehlgeschlagener Fetch sind unterschiedliche Zustände mit unterschiedlichen nächsten Aktionen.

Tastatur-bedienbar, semantisches HTML zuerst, ARIA nur, wo HTML es nicht ausdrücken kann, ein Label auf jedem Feld, einen sichtbaren Ausweg aus jedem Modal, und Fokus wird beim Schließen auf etwas Sinnvolles zurückgesetzt.

6. Emotion, Text und Ehrlichkeit

  • Klarheit schlägt Klugheit. Wenn ein Witz einen zusätzlichen Satz braucht, streiche ihn. Kontraktionen, einfache Worte.
  • Stimme ist konstant, Ton wechselt: warm bei Erfolg, sachlich und ruhig bei Fehlern, sanft bei sensiblen Eingaben.
  • Fehler: Was passiert ist, warum, was als nächstes zu tun ist und was behalten wurde. Gib niemals dem Benutzer die Schuld. Kein Humor hier.
  • Leere Zustände laden ein: Was wird hier erscheinen plus eine klare erste Aktion.
  • Peak-End: Platziere die eine große Freude am Ende einer echten Errungenschaft, niemals in einem Frustrationstal.
  • Auf Seiten mit hohem Einsatz, nenne die Ängste des Besuchers beim Namen und beantworte jede vor dem Call-to-Action.
  • Bildmaterial: standardmäßig ein diverses Ensemble; frage "wen schließen wir aus?"
  • Ehrlichkeit: Kennzeichne KI-generierte Bilder und Demodaten, wo Menschen sie für echt halten könnten. Der Text muss mit dem übereinstimmen, was die Bilder zeigen (eine Dose, die 5,0 % druckt, bedeutet, die Seite sagt 5,0 %).
  • Regulierte Kategorien (Alkohol, Finanzen, Gesundheit, Kinder): Füge die erforderliche Zugangssperre oder den Hinweis hinzu und überprüfe die Bilder anhand der Werbenormen der Kategorie, z.B. keine sexualisierten Bilder für Alkohol.

7. Bewegung

Jede Animation hat eine Aufgabe: Kontext, Aufmerksamkeit, Feedback oder Persönlichkeit. Keine Aufgabe, keine Animation.

TokenWertNutzung
--dur-1100msDrücken, Fokus, Umschalten (≈ die Wahrnehmungsschwelle)
--dur-2200msDie meisten UI-Übergänge, Hover, kleiner Eintritt
--dur-3300msPanels, Drawer, Modals
--dur-4400-500msNur für Vollbild- oder Hero-Choreografie
--ease-outcubic-bezier(0,0,.2,1)Eintreten / Aufmerksamkeit erregen
--ease-incubic-bezier(.4,0,1,1)Verlassen / Aufmerksamkeit verlieren (Ausgänge ~20-30% kürzer)
--ease-in-outcubic-bezier(.4,0,.2,1)Bewegen zwischen Positionen auf dem Bildschirm
springkritisch gedämpft, neu ausrichtbarGesten; Geschwindigkeit beibehalten, wenn sich das Ziel ändert
  • Blockiere niemals die Hauptaktion mit Choreografie. Ein Preloader oder Intro darf die primäre Aktion nicht länger als etwa eine Sekunde aufhalten, und wiederkehrende Besucher überspringen es.
  • Räumliche Konsistenz: Dinge verlassen den Bereich, wie sie gekommen sind; gemeinsame Elemente verwandeln sich an Ort und Stelle.
  • Stagger 30-60ms mit einer abklingenden Verzögerung (base*√i); halte die gesamte Sequenz unter ~300ms.
  • Scroll-Szenen: Der Fortschritt wird vom gemessenen Weg des Abschnitts abgeleitet, sodass dieselbe Scroll-Position immer denselben Frame liefert, Scrollen nach oben sauber umkehrt und direkte Links in die Mitte funktionieren.
  • Gesten: Ein Besitzer des Fortschritts; der Griff bleibt am Zeiger befestigt; Loslassen übergibt die Geschwindigkeit an eine Feder; Unterbrechung während der Bewegung hinterlässt die UI bedienbar.
  • Animiere nur transform und opacity. Unter prefers-reduced-motion entferne Bewegung, Parallaxe, Zoom und Autoplay, behalte kurze Überblendungen und lass benutzergesteuerte Gesten weiterhin funktionieren.
  • Technische Fallstricke, die echte Builds zerbrachen (eine Eigenschaft, ein Besitzer; pausierte Scroll-Timelines; Snap- Labels innerhalb der Timeline; nicht-negative Frame-Zeit; Vorladen von austauschbaren Assets): references/motion-engineering.md.

8. In einem echten Browser verifizieren, dann übergeben

Führe scripts/walk.py aus (Playwright + lokaler Chrome) bei Desktop, Telefon und reduzierter Bewegung: echter Mauszeiger-Zug, durch jeden Abschnitt scrollen, Konsolenfehler, seitlicher Überlauf. Ein versteckter oder minimierter Vorschaubereich drosselt Animations-Frames, also beurteile Bewegung nicht danach. Details: references/verification.md.

Bewerte dann anhand der Job-Story, nicht nach Geschmack:

  1. Erfüllt es die Job-Story? Ist die primäre Aktion das Prominenteste und überall erreichbar?
  2. Alle Zustände vorhanden (Schritt 5)? Tastatur, Screenreader-Labels, Kontrast?
  3. Nur Tokens? Vorhandene Komponenten wiederverwendet?
  4. Text folgt Schritt 6, einschließlich Ehrlichkeits-Kennzeichnungen?
  5. Hat jede Animation eine Aufgabe, die richtige Easing-Richtung, einen Unterbrechungspfad und einen Reduced-Motion-Pfad?
  6. Besteht die Signatur den Substitutionstest? Gibt es einen Peak, platziert an einem Ende?
  7. Was würde ich schneiden? Entferne ein Element oder einen Effekt und sieh, ob es besser wird.

Übergebe mit der Begründung: das Problem, der Ansatz, abgelehnte Alternativen und warum, was getestet wurde und wie (Emulation vs. echtes Gerät) und bekannte Grenzen. Vorlage: references/process-and-teams.md Anhang B.

Referenzen

LesenWann
references/motion-engineering.mdbeim Bauen von GSAP/ScrollTrigger/Lenis, Canvas, Geste oder Scroll-Szene-Arbeit
references/verification.mdbevor visuelle oder interaktive Arbeit als erledigt erklärt wird
references/imagery.mdbeim Generieren oder Vorbereiten von Bildern, Produkt-Ausschnitten, Art Direction
references/animation.mdChoreografie, die 7 Bewegungsprinzipien, Stagger-Mathematik, Bewegungs-Tokens
references/emotion.mdDesign-Persona, Onboarding, Freude, Vertrauen und Angst, Ausfall-Text
references/design-systems.mdTokens, Komponenten-APIs, Governance, Versionierung, Docs
references/product-design.mdRecherche, Story-first, Skizzieren, Feedback, Prototyping, Testen
references/design-thinking.mdein mehrdeutiges Problem, das Empathie/Definieren/Ideieren/Prototypen/Testen erfordert
references/design-engineering.mdAuswahl der Prototyp-Treue, Design↔Code-Handshake
references/process-and-teams.mdKritik-Sessions, Begründungs- und Übergabe-Vorlagen, DesignOps

Verwandte Skills