Communitygithub.com

Craft

Erstellt und überprüft UI-Elemente und -Seiten auf Basis der Projektvorgaben – vom Entwurf bis zur fertigen, selbstgeprüften Umsetzung.

Was ist Craft?

Craft ist die zentrale Fähigkeit für alle visuellen Designaufgaben in KI-Agenten-Workflows. Sie wandelt eine Anforderung wie „Gestalte die Preisseite“ in ein vollständiges, überprüftes Design um. Dabei arbeitet sie strikt nach dem Projekt-Brief, deckt alle Zustände ab, bietet Optionen nur bei offener Ausrichtung an, verwendet ausschließlich Bausteine des Designsystems und prüft ihre Arbeit vor der Präsentation. Die Fähigkeit orchestriert mehrere Sub-Fähigkeiten (craft-setup, craft-states, craft-explore, craft-system, craft-sync, craft-critique) an festgelegten Punkten, ersetzt sie aber nicht. Sie ist für jede KI-gestützte Design- oder Entwicklungsumgebung geeignet, die Markdown-basierte Anweisungen verarbeitet (z. B. Claude Code, Cursor, Codex) und stellt sicher, dass alle Designentscheidungen protokolliert und nachvollziehbar bleiben.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Craft?

Überblick

Die erste Tür für alles Visuelle. Aus „Gestalte die Preisseite“ wird ein fertiges, überprüftes Design. Sie arbeitet nach dem Projekt-Brief, deckt jeden Zustand ab, bietet Optionen nur bei offener Ausrichtung, verwendet nur Bausteine des Designsystems und prüft ihre Arbeit vor der Präsentation. Sie ruft die anderen Designfähigkeiten an festgelegten Punkten auf; sie ersetzt sie nicht.

Wann verwenden

  • „Entwerfen / Erstellen / Mockup / Neugestalten der <Seite, des Bildschirms, des Flows, des Elements>“, /craft (/craft:craft im Claude Code Plugin).
  • Mehrere Seiten auf einmal („Gestalte das Onboarding: Begrüßung, Registrierung, Verifizierung“).

Wann NICHT verwenden

  • Eine kleine Änderung, die genau beschrieben wurde (ein Wert, ein Label, eine Größe): gleich ausführen.
  • Nur eine Überprüfung („Was stimmt hier nicht?“): craft-critique. Nur Optionen: craft-explore.

Vorbereitung

  • Wenn kein Adapter in references/adapters/ zu deinem Werkzeug passt, führe die gleichen Aktionen in deinem Werkzeug aus und gib an, welche du manuell zugeordnet hast. Gibt es überhaupt kein Designtool, erstelle in HTML (html.md). Hast du nur ein Bild, weise darauf hin, dass daraus abgelesene Werte Schätzungen sind.

Stopps sind real

Ein Stopp bedeutet: Beende deinen Zug mit der Frage und warte. Das kannst du immer tun, auch in einer Einzelsitzung oder ohne Bildschirm, wo deine letzte Nachricht die Frage ist. Entscheide niemals einen Stopp für die Person, weil die Sitzung „nicht warten kann“ oder „um einen Hin-und-her zu sparen“. Wenn du selbst entscheidest, wird aus einer Fünf-Sekunden-Antwort stundenlange Nacharbeit.

Schritte

  1. Kontext.
    • Lies DESIGN.md im Projektstammverzeichnis. Fehlt sie oder hat sie keinen Produktabschnitt (eine reine Sync-Aufzeichnung) → ERFORDERLICHE SUB-FÄHIGKEIT: craft-setup, dann hierher zurückkehren.
    • Lies das Designsystem (Tokens, Komponenten, Leitfaden) und die mit dieser Seite verwandten Bildschirme.
    • Wenn der Brief und der Code widersprüchlich sind (der Brief sagt Türkis, die Tokens sagen Blau): Folge dem Code, nenne es in einem Satz, füge den Konflikt zu DESIGN.md › Offene Fragen hinzu und biete an, das Falsche zu aktualisieren. Überschreibe niemals Tokens innerhalb des CSS einer Seite.
    • Wenn der Leitfaden des Designtools und der Code unterschiedlich sind und eine design-sync.json existiert, erkläre den Leitfaden nicht für veraltet. Ordne ihn zu: Code geändert → biete an, den Leitfaden vor dem Zeichnen zu aktualisieren; Leitfaden geändert → es ist die Änderung der Person, die auf einen Export wartet, also zeichne damit und erwähne den ausstehenden Export.
  2. Umfang in Worten. Liste jede zu erstellende Seite oder jedes Element auf, jeweils mit seiner Aufgabe und seinem nächsten Schritt.
    • Mehrdeutige Begriffe erhalten eine klare Interpretation („Preisseite = die Preisliste der Bäckerei, nicht die Abonnementpläne“).
    • Stopp und bestätige die Liste, wenn es mehr als ein Element gibt oder die Anfrage vage ist. Bei einem klaren Element: weitermachen.
  3. Für jedes Element, der Reihe nach:
    1. ERFORDERLICHE SUB-FÄHIGKEIT: craft-states. Ihre geschriebene Zustandsliste und ihr Stopp kommen zuerst.
    2. Offene Ausrichtung? Nur wenn die Person nach Ideen gefragt hat oder wenn zwei strukturell unterschiedliche Layouts plausibel sind und weder der Brief noch das System zwischen ihnen wählt → ERFORDERLICHE SUB-FÄHIGKEIT: craft-explore vor dem Zeichnen der Zustände. Frage bei mehreren Seiten beim Umfangsstopp, welche Seite (falls überhaupt) Optionen erhält; führe niemals standardmäßig eine Optionsrunde pro Seite durch. Die Zustände werden dann in der gewählten Richtung gezeichnet. Ein Bildschirm, der einem bestehenden Muster folgt, geht direkt zum Zeichnen.
    3. Zeichne den Hauptzustand, dann die anderen Zustände, nur mit den Bausteinen und Tokens des Systems. Etwas Neues (eine Komponente, eine Farbe, eine Größe, die die Skala nicht hat) → ERFORDERLICHE SUB-FÄHIGKEIT: craft-system (Hinzufügen-Modus) vor der Verwendung. Eine Komponente, die im Code existiert, aber im Tool nicht gezeichnet ist („nur im Code“ im Index) → ERFORDERLICHE SUB-FÄHIGKEIT: craft-sync (Import einer Komponente), zuerst nur diese Komponente zeichnen. Wenn die Person den Import abgelehnt hat (siehe DESIGN.md), frage einmal vor dem Import; wenn sie immer noch nein sagt, baue aus den Werten des Codes direkt auf der Tafel und notiere es. Zeichne niemals ein Nachahmungsstück und codiere niemals einen neuen Wert in einer Seite fest.
    4. ERFORDERLICHE SUB-FÄHIGKEIT: craft-critique im Selbstprüfmodus für jede Tafel: rendere sie, behebe, was innerhalb des Aufgabenumfangs gefunden wird, und rendere erneut.
  4. Abschluss.
    • Zeige das Ergebnis mit der Zusammenfassung unten.
    • Füge die Entscheidungen zu DESIGN.md › Entscheidungsprotokoll hinzu (Datum, Entscheidung, Grund).
    • Verschiebe jede beantwortete Frage aus den Offenen Fragen.

Abschlusszusammenfassung (Form deiner letzten Nachricht)

Erstellt: <Seiten/Elemente> — <wo: Dateien oder Tafeln>
Entscheidungen: <jede, eine Zeile mit Grund> (auch in DESIGN.md › Entscheidungsprotokoll)
Systemänderungen: <hinzugefügte/geänderte Bausteine oder Tokens> — betrifft: <Bildschirme>
Selbstprüfung behoben: <was craft-critique geändert hat, bevor du es gesehen hast>
Offene Fragen: <was die Person noch entscheiden muss>

Regeln

RegelGrund
DESIGN.md zuerst, jedes MalOhne Brief erfindet jeder Bildschirm seinen eigenen Stil
Umfang vor der Arbeit bestätigt, wenn mehr als ein ElementDrei Seiten, die auf einem falschen Verständnis aufbauen, sind drei verschwendete Seiten
Zustandsliste vor dem Zeichnen (via craft-states)Der Happy Path ist nur einer von vielen Zuständen
Optionen nur, wenn die Ausrichtung offen istOptionen bei einem gelösten Muster verschwenden die Aufmerksamkeit der Person
Nur Systembausteine und -tokens; neue gehen über craft-systemHartcodierte Werte in Seiten sind der Anfang von Drift
Code schlägt einen veralteten Brief; notieren, nicht überschreibenDie Tokens sind das, was ausgeliefert wird; der Brief wird durch Entscheidungen aktualisiert, nicht stillschweigend
Selbstprüfung vor dem ZeigenDie Person sollte das Design überprüfen, nicht Fehler fangen
Entscheidungen gehen in DESIGN.mdDas nächste Session-Design beginnt damit, nicht aus dem Gedächtnis

Erledigt, wenn

Jedes Element im bestätigten Umfang seine gezeichneten und selbstgeprüften Zustände hat, jede Systemänderung über craft-system gelaufen ist, die Abschlusszusammenfassung gegeben wurde und das Entscheidungsprotokoll in DESIGN.md aktualisiert wurde.

Häufige Fehler

GedankeRealität
„Drei Seiten sind klar genug, ich baue sie einfach“Bestätige zuerst die Liste. Es kostet eine Nachricht.
„Ich mache Buttons hier 52px; der Token sagt 44, aber dieses Publikum braucht größere“Das ist eine Systementscheidung. Schlage sie über craft-system vor, dann verwende sie überall.
„Der Brief sagt Türkis, also überschreibe ich das Blau im CSS dieser Seite“Code gewinnt. Markiere den Konflikt und frage nach; patche Tokens niemals lokal.
„Ich zeige es, sie sagen mir dann, was falsch ist“Führe zuerst craft-critique im Selbstprüfmodus aus und sage, was es behoben hat.
„Die Entscheidungen stehen in meiner Nachricht, das reicht“Nachrichten scrollen weg. Füge sie zu DESIGN.md hinzu.
„Diese Sitzung kann nicht auf Antworten warten, also treffe ich die Entscheidungen selbst und liste sie auf“Deinen Zug mit der Frage zu beenden ist warten. Tu das; baue nichts über den ersten offenen Stopp hinaus.
„Um einen Hin-und-her zu sparen, gebe ich beide Stopps in eine Nachricht“In Ordnung, wenn du dann stoppst. Frage beides, baue nichts, warte.

Individual skills in this repo

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

Verwandte Skills