Communitygithub.com

Design Skill

Router für designbezogene HTML-Artefaktaufgaben. Entscheidet über Routing, Stil, Vorlagen und Qualitätssicherung.

Was ist Design Skill?

Design Skill ist der zentrale Router für designbezogene HTML-Artefaktaufgaben in KI-Agenten wie Claude Code, Cursor oder Codex. Es analysiert Benutzeranfragen entlang der drei Achsen Inhalt, Szenario und Stil und entscheidet, welches Artefakt-Skill primär zuständig ist, ob auf `design-system-reference.md` oder `design-system-generation.md` zurückgegriffen werden soll, und wann der Export (`export.md`) aufgerufen wird. Der Skill arbeitet standardmäßig schnell und intern – er hält nur bei wirklich mehrdeutigen Anfragen inne und stellt dann eine gezielte Frage. Er priorisiert Stilquellen nach Benutzervorgabe, Design-System (DESIGN.md), Vorlage und parallelen Randbedingungen. Für Schnittstellenszenarien (Dashboards, Admin-Panels, Formulare, Prototypen) wird auf ein ausgereiftes Basissystem aus `design-systems/style-skills` zurückgegriffen, um professionelle und konsistente Ergebnisse zu erzielen. Für expressive Szenarien (Landingpages, Portfolios, Kampagnen) wird eine detaillierte visuelle Planung inklusive Design-Read und visuellen Commitments erstellt. Eine Qualitätskontrolle (`quality-gate.md`) stellt sicher, dass das Artefakt nutzbar und editierbar ist.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antilsabh789-pixel/kabaddi-pro/tree/HEAD/.migration-backup/skills/design

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Design Skill?

Design Skill ist der Router für designbezogene HTML-Artefaktarbeit.

Es entscheidet:

  • ob die Aufgabe designbezogen ist
  • welches Artefakt-Skill primär zuständig sein soll
  • ob die Aufgabe design-system-reference.md verwenden soll
  • ob die Aufgabe design-system-generation.md verwenden soll
  • ob die Aufgabe export.md verwenden soll
  • wie viel Klärung nötig ist, bevor gehandelt wird
  • wie die Anfrage vor dem Routing schnell gelesen werden soll (siehe „Vor dem Generieren“)
  • wie integrierte Designqualitäts-Standards angewendet werden
  • wie generiertes HTML für spätere Bearbeitungen strukturiert bleibt

Design Skill sollte kompakt bleiben.

Artefaktspezifische Strukturregeln gehören in die Artefakt-Skill-Dateien. Geschäftsbeurteilung für ein Szenario lebt in diesem Szenario-Skill. Übergreifende Handwerksregeln gehören in horizontal-craft/. Referenzauswahl gehört in design-system-reference.md. DESIGN.md-Import / -Extraktion / -Persistenz gehört in design-system-generation.md. Export / Paketierung / Übergabe gehört in export.md.

Der standardmäßige Erstauslieferungsgegenstand ist ein Designartefakt, normalerweise HTML, sofern das ausgewählte Artefakt-Skill oder das Exportziel kein Standbild, Deck, Paket oder Designsystem-Spezifikation erfordert. Export wird aufgerufen, wenn der Benutzer das aktuelle Artefakt paketieren, herunterladen, konvertieren oder übergeben möchte.

Der Ablauf (einmal lesen; er regelt alles Weitere)

Das gesamte Skill ist ein Ablauf. Das meiste läuft intern und sofort ab – es hält nur an, wenn eine Anfrage wirklich mehrdeutig ist. Machen Sie keinen Schritt zu einem auszufüllenden Formular oder einer Datei, die zuerst gelesen werden muss.

BENUTZERANFRAGE
   │
   ▼
1. VERSTEHEN (intern, stillschweigend bei offensichtlichen Anfragen) – drei Achsen parallel auflösen:
     • Inhalt   – Thema, Information, Ziel
     • Szenario – Form + Absicht  → welches Szenario-Skill   (siehe Routing)
     • Stil     – welche Art von Stilhinweis, falls vorhanden   (siehe Stil-Routing)
   Offensichtlich auf allen drei → fortfahren. Nur EINE Achse wirklich unklar → eine gezielte Frage stellen.
   Bei offenen / kreativen Anfragen umfasst das Verständnis auch eine kreative Lesart, nicht nur diese
   operativen Achsen – ergänzen Sie den kreativen Kontext + Design Read (siehe §Kreative Kontextvervollständigung).
   │
   ▼
1.5 VORLAGEN PRÜFEN (standardmäßig durchführen, nicht nur auf Anfrage)
   Durchsuchen Sie `design-templates/INDEX.md` nach Carrier + Szenario, um eine Übereinstimmung mit der Anfrage zu finden.
     • Klare Übereinstimmung  → als Ausgangspunkt übernehmen; die SKILL.md dieser Vorlage lesen. Die Verwendung einer
                      passenden Vorlage erhöht in der Regel die Qualität – bevorzugen Sie dies gegenüber dem Entwurf von Grund auf.
     • Keine gute Übereinstimmung → direkt mit dem Szenario-Skill fortfahren. Erzwingen Sie niemals eine Vorlage, die nicht passt.
   Eine Vorlage ist eine Ausgangsstruktur/ein Gerüst, keine zu klonende Seite – behalten Sie den tatsächlichen Inhalt des Benutzers,
   wenden Sie das Szenario-Skill + das horizontale Handwerk an und kopieren Sie nicht den genauen Layout-Fingerabdruck der Referenz.
   │
   ▼
2. STIL NACH PRIORITÄT FÜLLEN (pro Dimension: Farbe · Schriftart · Layout · Symbole · Abstands-Token)
   Für jede Dimension aus der höchstpriorisierten Quelle übernehmen, die sie abdeckt:
     1) Benutzers unmittelbare Beschreibung   ← höchste; die von ihr berührten Dimensionen sind gesperrt
     2) Designsystem (DESIGN.md)      ← füllt Dimensionen, die der Benutzer nicht angesprochen hat
     3) Vorlage / Startwert                ← füllt, was übrig bleibt (insb. Layout-Gerüst)
     4) parallele Randbedingungen           ← Fallback für jede noch leere Dimension
        (nur die benötigten laden: Schriftart / Symbole / Farbe / a11y …)
   Quellen kombinieren – z. B. Designsystem-Token + Layout einer Vorlage ist normal.
   Stilhinweis ist ein vages Stimmungswort, kein benanntes System („清新/简约/高级/科技感/复古/温暖/极简/
   赛博“ usw.): assoziieren Sie NICHT einfach frei einen Look – ordnen Sie ihn der Bibliothek zu. Lesen Sie
   den Index von `design-systems/style-skills` (und Marken-`index.json`) und wählen Sie den Eintrag, dessen `mood` /
   `formality` / `scheme`-Tags am besten zu den Wörtern passen, und verwenden Sie ihn als Basis. Die Stil-Tags sind die
   Brücke vom Adjektiv des Benutzers zu einem konkreten System (z. B. 清新简约 → 极简/克制 → `minimal`/`clean`;
   高级 → 奢华/克制 → `luxury`/`refined`; 科技感 → Technikgefühl/Zukunft → `futuristic`/`hud`). Nur von Grund auf
   entwerfen, wenn nichts in der Bibliothek zur Stimmung passt.
   Kein Stilhinweis + Szene ist zurückhaltend / nicht kreativitätsgetrieben (Tool, Dashboard, Admin,
   Formular, Bericht, Hinweis, generische SaaS/Unternehmensseite): Entwerfen Sie NICHT einen Stil von Grund auf –
   wählen Sie aktiv eine ausgereifte Basis aus `design-systems/` (siehe Ausgereiftes System als Fallback), damit das
   Ergebnis professionell und konsistent ist. (Ausdrucksstarke Szenen, die ein unverwechselbares Aussehen wünschen, überspringen dies
   und gehen gemäß §Kreativer Kontext mutig vor.)
   Konflikt: Wenn die Beschreibung des Benutzers dem Designsystem in einer Dimension widerspricht,
   gewinnt der Benutzer in dieser Dimension – UND sagen Sie dies in einer Zeile
   („Habe es wie gewünscht mit <X> erstellt; beachten Sie, dass dies vom beigefügten Designsystem abweicht –
    sagen Sie mir, ob Sie lieber die Richtung des Systems beibehalten möchten.“)
   │
   ▼
3. ERSTELLEN mit dem Urteilsvermögen des Szenario-Skills + dem gefüllten Stil.
   │
   ▼
4. QUALITÄTSKONTROLLE – `quality-gate.md` als schlanke finale Checkliste vor der Auslieferung ausführen.

Warum Priorität-Füllen wichtig ist: Es lädt Randbedingungen nur, wenn eine Dimension tatsächlich leer ist – sie lesen die Symbolrandbedingung nur, wenn nichts Symbole geliefert hat, die Farbrandbedingung nur, wenn nichts Farbe geliefert hat. Das hält das Skill leichtgewichtig, statt jede Regel jedes Mal auszuspucken.

Ausgereiftes System als Fallback

Für Schnittstellen-/zurückhaltende Szenen (Produktprototypen, Dashboards, Admin-Panels, Web-Tools, Einstellungen/Formulare/Onboarding/Checkout, datenlastige Oberflächen, generische Unternehmens-/Hinweisseiten) auf ein ausgereiftes System setzen statt auf freien Geschmack – unabhängig davon, ob der Benutzer ein Stimmungs- oder Stilwort angegeben hat. Die Szene (und etwaiges Stimmungswort) auf einen Eintrag in design-systems/style-skills über seine mood-Tags auflösen und ihn als UI-Basis übernehmen. Schnittstellenreife ist das Ziel; ein echtes System gibt Struktur, Komponentendisziplin, Abstandsrhythmus, Zustandsverhalten und Interaktionskonventionen.

Dies NICHT auf kreative/ausdrucksstarke Szenen anwenden:

  • social-card.md
  • content-page.md
  • redaktionelle / literarische Seiten
  • portfolio.md
  • landing-page.md und ausdrucksstarke Marken-/Story-/Lifestyle-Seiten

Für diese aus dem eigenen visuellen Urteil des Artefakt-Skills + horizontalem Handwerk + kreativem Kontext entwerfen. Sie können auf den Charakter eines Systems verweisen (und eine benannte Marke lädt immer brand-inspiration), werden aber nicht in ein UI-Kit gedrängt. Das Artefakt sollte nicht wie ein generisches UI-Kit aussehen.


Kontextquellen, die Schritt 2 (Stil füllen) speisen können: Benutzerinhalte, Screenshots, eine ausgewählte Vorlage/ein Startwert, eine hochgeladene DESIGN.md, das aktuelle Artefakt, Marken-Assets, vorhandene Seiten, Designsysteme/UI-Kits oder Figma-/Codebasis-Referenzen. Verwenden, was vorhanden ist; eine parallele Randbedingungsdatei nur für eine Dimension lesen, die sonst nichts abdeckt.

1. Zuerst verstehen

Dieser Teil entscheidet, „was vor dem Handeln klar sein muss“. Meistens verinnerlicht und sofort erledigt; nur bei echter Mehrdeutigkeit wird eine Frage gestellt.

Rolle

Dieser Agent ist designorientiert.

Es ist kein generischer UI-Generator. Es sollte bei jedem Artefakt Designurteile einbringen.

Ein designorientierter Agent sollte:

  • verstehen, wofür das Artefakt ist
  • entscheiden, was der Benutzer zuerst bemerken soll
  • Elemente entfernen, die ihren Platz nicht verdienen
  • Referenzen verwenden, bevor er sich auf generischen Geschmack verlässt
  • Struktur für spätere Bearbeitungen erhalten
  • Artefakte erstellen, die nutzbar, editierbar und absichtsvoll sind

Das Ziel ist nicht, mehr Schnittstelle zu generieren. Das Ziel ist, ein Designartefakt zu erstellen, das dem Benutzer hilft, etwas Nützliches zu kommunizieren, zu testen, zu veröffentlichen, zu präsentieren oder zu übergeben.


Inhaltssprache

Die Sprache des generierten HTML-Inhalts muss der Gesprächssprache des Benutzers entsprechen, sofern der Benutzer nicht ausdrücklich etwas anderes verlangt.

Regeln:

  • Wenn der Benutzer auf Chinesisch schreibt, muss der gesamte sichtbare Text im Artefakt (Überschriften, Fließtext, Beschriftungen, CTAs, Mikrotext, Navigation, Platzhalter, Alt-Text) auf Chinesisch sein.
  • Wenn der Benutzer auf Englisch schreibt, englischen Inhalt generieren.
  • Wenn der Benutzer in einer gemischten Sprache schreibt, der dominanten Sprache der Anfrage für primäre Inhalte folgen und das gemischte Muster beibehalten, wo es natürlich ist (z. B. Produktnamen, technische Begriffe).
  • Diese Regel gilt für alle Szenarien: Landingpages, Portfolios, Decks, Inhaltsseiten, Prototypen, Web-Tools und jedes zukünftige Szenario.
  • <html lang> muss mit der Inhaltssprache übereinstimmen (zh-CN, en, ja usw.).
  • Bei der Anpassung einer voreingestellten Vorlage den Platzhaltertext der Vorlage durch Inhalt in der korrekten Sprache ersetzen. Die ursprünglichen englischen Platzhalter der Vorlage nicht beibehalten, wenn die Inhaltssprache nicht Englisch ist.
  • Wenn chinesischer / CJK-Inhalt erkannt wird (durch diese Regel oder durch Benutzeranforderung), auch horizontal-craft/chinese-typography.md als gemeinsame Referenz laden. Schriftart-Eiserne-Regel (gilt auch vor dem Lesen dieser Datei): jede nicht-systemeigene Schriftart, die in font-family genannt wird, muss tatsächlich geladen werden (<link> oder @font-face), und eine Seite mit chinesischem Text muss einen CJK-Schriftartnamen in ihrem font-family haben – niemals eine lateinische Schriftart direkt auf system-ui durchfallen lassen, sonst wird das Chinesische in einem unkontrollierten Fallback gerendert. Details zur Schriftartauswahl/-ladung: horizontal-craft/fonts.md.

Den Benutzer nicht bitten, die Inhaltssprache zu bestätigen, es sei denn, die Konversation ist wirklich mehrdeutig (z. B. sendet der Benutzer eine zweisprachige Zusammenfassung ohne klare dominante Sprache).


Kernprinzip

Standardmäßig handeln, aber nicht blind entwerfen.

Fragen gezielt einsetzen. Nicht standardmäßig einen langen Fragebogen stellen, aber prägnante klärende Fragen stellen, wenn sie das Ergebnis wesentlich verbessern würden. Ansonsten vernünftige Annahmen ableiten aus:

  • der Anfrage des Benutzers
  • vorhandenem Arbeitsbereichskontext
  • bereitgestelltem Inhalt
  • bereitgestellten Referenzen
  • ausgewählter HTML-Vorlage, falls vorhanden
  • vorhandenem Artefaktzustand
  • hochgeladener DESIGN.md, falls vorhanden
  • gängigen Mustern für das Ziel-Szenario

Klärende Fragen stellen, wenn fehlende Informationen das Ergebnis machen würden:

  • unbrauchbar
  • unmöglich zu generieren
  • rechtlich oder markenrechtlich riskant
  • klar nicht mit der Absicht des Benutzers übereinstimmend

Wenn genügend Informationen vorhanden sind, eine vernünftige erste Version generieren und den Benutzer sie durch Kommentare zu ausgewählten Bereichen, lokale Parameterbearbeitungen, Folgeanfragen oder Export verfeinern lassen.


Kreative Kontextvervollständigung

Für offene Generierung vor dem Erstellen stillschweigend einen kurzen kreativen Kontext vervollständigen (ein Satz pro Punkt; den des Benutzers verwenden, wenn gegeben, sonst aus Szenario/Zielgruppe/Inhalt/Referenzen ableiten; nicht anzeigen, es sei denn, es ist nützlich):

Kreativer Kontext
1. creative_positioning:  worum es hier wirklich geht, über die wörtliche Anfrage hinaus
2. first_impression:      was der Betrachter in den ersten 3 Sekunden fühlen soll
3. anti_default:          welcher generische Standard zu vermeiden ist

Das Artefakt muss dies sichtbar widerspiegeln.

Einzeiligen Design Read vor dem Generieren angeben

Sich dann auf eine explizite Zeile festlegen, die benennt, wie die Anfrage gelesen wird:

Form: „Gelesen als: für , <Charakter/Stimmung>, tendierend zu <Designrichtung / System / Referenz>.“

  • „Gelesen als: ein SaaS-Landing für technische Käufer, ruhig und präzise, tendierend zu einem zurückhaltenden Linear-ähnlichen System.“
  • „Gelesen als: eine 国潮-Tee-Markenkampagne für junge Verbraucher, mutig und festlich, tendierend zu übergroßer Schrift + kräftiger Farbe, ausdrucksstark."
  • „Gelesen als: ein internes Admin-Dashboard, zurückhaltend und lesbar, tendierend zu einer ausgereiften Designsystem-Basis."

Kann dem Benutzer gezeigt werden. Wenn eine Achse wirklich mehrdeutig ist, die einzige gezielte Frage hier stellen, anstatt zu raten.

Der Design Read muss mit einer Stilquellen-Klausel enden – erforderlich, eine auswählen, niemals leer:

  • Schnittstellenszene (Prototyp, Info-interaktiv, Web-Tool, Dashboard/Admin): ein System nennen – "tendierend zu <style-skill> (aus Stimmungs-Tags abgeglichen)" oder "tendierend zu <Marke> aus brand-inspiration", wenn eine Marke genannt wurde. Standardmäßig auf ein ausgereiftes System zurückgreifen; UI nicht von Grund auf erfinden.
  • Kreative Szene (Landing, Portfolio, Kampagne, Karte, Inhalt): entweder "unter Bezugnahme auf <Charakter> von <System>, originelles Layout" oder "originelle Richtung: <eine Zeile>". Beides gültig – „originell“ ist eine legitime Quelle; der Punkt ist, dass die Bibliothek in Betracht gezogen wurde.
  • Beliebige Szene + benannte Marke → "tendierend zu <Marke> aus brand-inspiration".

Dann die Szene klassifizieren; für expressive Szenen einen konkreten visuellen Plan festlegen

  • Expressive (Markenseite, Kampagne/Promo, Portfolio, Produkt-Landing-Hero, redaktionelles/kulturelles Feature, Social-Cover): visuelle Wirkung ist Teil der Aufgabe; eine korrekte, aber sichere zentrierte Seite ist ein Fehlschlag.
  • Zurückhaltend (Dashboard, Admin, internes Tool, Formular, behördlicher Hinweis, Bericht, Datentabelle, Spezifikation): Klarheit und Ruhe sind die Aufgabe; Bewegung minimal halten, Layout regelmäßig und die folgende visuelle Festlegung überspringen.

Für expressive Szenen vor dem Codieren stillschweigend festlegen – jedes Element eine spezifische Aktion + Element, niemals ein Adjektiv („mutig/hochwertig/überraschend/dynamisch“ sind verboten, sie schränken nichts ein):

Visuelle Festlegung (nur expressive Szenen)
1. hero_subject:   das EINE Element, das groß/dominant gemacht wird  (z. B. Produktname '桂花酪酪' bei 1/3 Viewport, gold+zinnoberrot)
2. entrance:       welche Elemente wie einanimieren       (z. B. Titel-Buchstaben gestaffelt einblenden + Blütenblätter von oben fallen)
3. break_symmetry: wo das Layout die Mitte/das Grid bricht      (z. B. Preisschild schräg unten rechts; Siegel ragt über den Rand)
4. focal_contrast: was das Auge zuerst landen lässt         (Größensprung / Farbblock / Weißraum um den Helden)

Eine vollständig zentrierte, symmetrische, statische Seite ohne dominantes Element ist das Standard-平庸-Ergebnis – für expressive Szenen bedeutet es, dass die Festlegung nicht eingehalten wurde. Jedes festgelegte Element ausführen. Bewegungsspezifikationen → horizontal-craft/animation-discipline.md.

Beispiel (inline)

„Ein GLM-5.1-Modell-Vorstellungswebsite erstellen“ → Positionierung: Reasoning/Execution-Infrastruktur, keine generische KI-Seite; first_impression: ruhig, präzise, technisch; anti_default: die generische KI-SaaS-Hero + Feature-Card-Vorlage vermeiden. Szene: expressiv → hero_subject: „GLM-5.1“ übergroß mit einem einzelnen Akzent; entrance: Titel + Slogan gestaffelt einblenden; break_symmetry: Spezifikationsnummern auf eine Seite versetzt; focal_contrast: große Schrift gegen tiefen Negativraum.

Annahmen zum Erstauslieferungsprodukt

Annehmen, dass die meisten Benutzer keinen fortgeschrittenen Designkontext geben – keine Figma-Datei/MCP, ausgereiftes Designsystem, Token, Komponentenbibliothek, Markenrichtlinie

…

[gekürzt für die Übersetzung]

Individual skills in this repo

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

Verwandte Skills