Communitygithub.com

do-design

UI- und visuelles Design, das an eine verbindliche DESIGN.md gebunden ist, mit Skripten für alles Messbare. Verwenden Sie es, um Seiten und Komponenten zu entwerfen oder umzugestalten, UI-Änderungen zu überprüfen, eine UI zu auditieren und zu bewerten, eine Website neu zu gestalten, einen Markt vor dem Design zu recherchieren, eine mutige Richtung einzuschlagen oder eine Design-Guardrail in einem Repository zu installieren. Befehle: do-audit, do-design-new, do-design-review, do-design-renew, do-crazy.

Was ist do-design?

do-design ist ein KI-Agenten-Skill für UI- und visuelles Design, das an eine verbindliche DESIGN.md gebunden ist. Es stellt sicher, dass jedes Design-Element anhand eines einzigen, maßgeblichen Dokuments gemessen, überprüft und validiert werden kann – vergleichbar mit einer Blaupause. Der Skill bietet eine Reihe von Befehlen wie `do-audit` für eine vollständige UI-Bewertung, `do-design-review` für schnelle Übereinstimmungsprüfungen und `do-crazy`, um radikal neue Designrichtungen zu erkunden. Jeder Befehl lädt die erforderlichen Ebenen (Farbe, Typografie, Layout usw.) und Referenzen, um kontextbewusst zu handeln, ohne Überflüssiges. Skripte messen objektiv die Abweichung von der Design-Vorgabe, die Barrierefreiheit, den Kontrast und die Layout-Treue – Ideal für Entwicklerteams, die bei der visuellen Konsistenz auf einer sich ständig verändernden Codebasis diszipliniert bleiben wollen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht do-design?

Pfade sind relativ zum Ordner dieses Skills; P ist das Projektstammverzeichnis. Skripte sind stdlib Python 3.8+. Führen Sie das Skript aus, bevor Sie über etwas, das es misst, nachdenken, zitieren Sie seine Ausgabe und leiten Sie nie ab oder schätzen Sie, was es berichtet.

Modell

  1. Die DESIGN.md des Projekts (das Papier) ist bindend und überschreibt diesen Skill. Bei Konflikten gewinnt das Papier; sagen Sie das.
  2. Jede Regel trägt ihren Grund. Eine Regel ohne Grund wird beim ersten Mal gelöscht, wenn sie unbequem ist.
  3. Beweise vor Standardeinstellungen. Ein dünnes Briefing ("mach es neu" + ein Logo) ist ein Grund zu recherchieren, nicht auf das übliche Aussehen zurückzugreifen oder Tatsachen zu erfinden. Keine Quelle, keine Behauptung: markieren Sie die Lücke oder fragen Sie nach.
  4. Lade träge. Nur die Dateien, die die Befehlstabelle nennt. Zusätzliche Ebenen "der Vollständigkeit halber" sind ein Methodenfehler.
  5. Konvention ist der Standard, nicht das Scheitern. Der Modus entscheidet, wie weit abgewichen wird.

Modi: Geben Sie zu Beginn jedes Befehls eine Zeile an

ModusDer Besucher istDruck
ÜberzeugenEntscheidet und handeltstark: eine Vorlage ist ein Fehler
BedienenErledigt eine AufgabeZurückhaltung: Konvention ist ein Merkmal
LesenVersteht etwasMittel: Lesekomfort gewinnt
ErlebenIst im Werk selbststark: das Artefakt führt

Wählen Sie nach der Oberfläche, nicht nach dem Produkt: Die Landingpage eines Entwicklertools ist Überzeugen, sein Einstellungsbildschirm ist Bedienen.

Befehle: Laden Sie eine Befehlsklasse, plus das, was ihre Zeile nennt

BefehlVerwendung wennZusätzlich ladenRisiko
do-design-review"Passt das zum Papier?" Günstigste, am häufigsten ausführendie DESIGN.md des Projekts-
do-audit"Wie gut ist das?" Bewertung + rangierte Ergebnissereferences/critique-rubric.md, references/slop-catalog.md, Ebenen 00-05, die der Umfang berührt-
do-design-new"Baue X": konventionell, kompetent, auf Papierlayers/00, die 1-3 Ebenen, die die Aufgabe berührt; layers/06, wenn das Briefing dünn oder kundenorientiert istniedrig
do-design-renew"Mach diesen Look neu": neue Welt, gleiche Produktwahrheitlayers/00, layers/06mittel
do-crazy"Etwas, das niemand in dieser Branche tun würde"layers/00, layers/06hoch, gewollt

Ebenen: 00-craft-floor (jeder Modus) · 01-color · 02-typography · 03-space-layout · 04-motion-states · 05-voice · 06-research. Schreiben eines Papiers: templates/DESIGN.md, examples/01-two-papers.md, references/interview.md.

Skripte (alle akzeptieren --json)

AusführenGibt
scripts/check-design.py --root PAbweichung vom Token-Block des Papiers. Exit 0 sauber, 1 Abweichung, 2 kein Papier/Token. --init erstellt Token aus dem Code
scripts/audit.py scan PQuell-Hinweise (IDs wie im Slop-Katalog), a11y- und Browser-Oberflächenlücken, Wertinventar
scripts/audit.py copy PProsa- und Mikrokopier-Hinweise, Satzrhythmus, nicht gefüllte Lückenmarkierungen
scripts/audit.py contrast FG BG / --paper P/DESIGN.mdWCAG-Verhältnisse
scripts/audit.py score H L S C T U DGewichtete Bewertung, Band, Arbeitsliste
scripts/render-audit.py URL-oder-Datei [--shots VERZ] [--inject-css DATEI]Die gemalte Seite bei 1280/768/390: Überlappung, seitliches Scrollen, Beschneidung, gemalter Kontrast, Berührungsziele, Fokussichtbarkeit. --inject-css misst einen CSS-Fix gegen die bereitgestellte Seite vor dem Bereitstellen. Benötigt Chrome/Chromium
scripts/research.py suggest|profile|logo|arenaEchte Suchphrasen, Fakten zu Mitbewerberseiten, Logofarben, Referenzkanäle
bash scripts/install-guardrails.sh PDESIGN.md aus der Vorlage, den AGENTS.md/CLAUDE.md-Block, den Checker

Screenshots kosten weit mehr Kontext als Skriptausgaben: machen Sie sie nur für das, was Augen braucht (Hierarchie, Unterscheidung, Komposition), nur Viewport, zuerst 390. Skripte können auch falsch sein: Bevor Sie einen P0 melden, der unglaublich erscheint, bestätigen Sie ihn einmal (ein gezielter Screenshot oder die Geometrie des Elements) und reparieren Sie das Skript, wenn es ein falscher Positiver war.

Gemeinsame Definitionen

Austauschtest. Ersetzen Sie den Produktnamen durch den eines Mitbewerbers. Wenn nichts kaputt geht, sagt die Seite nichts über dieses Produkt aus: nicht gewählt, nicht hässlich. Beheben Sie es im Text, im Visuellen und einem signifikanten Detail, niemals durch Hinzufügen von Dekoration.

Richtung, fünf Zeilen. Geschrieben vor dem Bauen, gezeigt, dann auf ein Ja warten (wenn gesagt wird "mach es einfach", geben Sie die Annahme in einer Zeile an und los):

Produkt:    was es tut, für wen, ein einfacher Satz
Charakter:  2-3 konkrete Wörter (niemals sauber, modern, schlank, minimalistisch, hochwertig)
Welt:       der Ort oder das Material, zu dem es gehört; setzt neutralen Farbton, Akzent, Bildsprache
Momente:    1-2 Orte, an denen der Bildschirm reichhaltig wird
Signatur:   nur ein Detail, das nur dieses Produkt hat, konsequent verwendet

Lückenmarker. [Anzahl benötigt], [Quelle benötigt], [Foto benötigt] wo eine Tatsache oder Ressource fehlt. audit.py copy listet die noch offenen auf; keine darf ausgeliefert werden.

Bewertung: Jeder bewertende Befehl endet damit

#FeldFrageW
1HierarchieKann das Wichtigste in 2 Sekunden genannt werden?3
2LesbarkeitKontrast, Größe, Maß, echter Text bei jeder Breite3
3SystemEine Palette, eine Skala, eine Radiuslogik, eine Bewegungssprache2
4HandwerkAusrichtung, Abstandsrhythmus, Zustände, Browseroberflächen2
5InhaltswahrheitEchte Daten, spezifischer Text, keine erfundenen Behauptungen3
6BenutzbarkeitAufgabe erledigt; Affordanzen offensichtlich; Fehler behebbar3
7UnterscheidungBesteht es den Austauschtest?2

Bewerten Sie jedes 0-4 (4 = wirklich hervorragend, nicht "in Ordnung") und berechnen Sie mit audit.py score. Bänder: 85+ Stark, ausliefern und nur P0 beheben · 70-84 Solide, ausliefern nach den genannten P1s · 50-69 Schwach, einen echten Durchlauf zuerst · <50 Durchgefallen, die Richtung ist falsch: neu bauen (do-design-renew). Bewerten Sie das Rendering, nicht die Quelle. Ein Feld, das Sie nicht prüfen konnten, ist u: es erzielt 0 und liest unverified, niemals eine Schätzung. Unterscheidung erhält 4 nur, wenn Sie benennen können, was es zu diesem Produkt macht. Die drei schlechtesten Felder sind die Arbeitsliste, je eine Aktion.

Schweregrad: P0 blockiert die Auslieferung (kaputt, unlesbar, hartes Verbot), alle melden · P1 beschädigt Vertrauen, Top 5 · P2 Handwerk, Top 5 · P3 Politur, nur auflisten. Findungsformat: [Pn] Ort - was falsch ist - Behebung; Skript-Ergebnisse behalten ihre ID.

Kein Papier

Sagen Sie "Keine DESIGN.md: die Guardrail hat nichts durchzusetzen." Bieten Sie an, es zu schreiben (Vorlage + Interview) oder eine Nachrüstung aus dem Code (check-design.py --init + Interview §Nachrüstung): v1.0 ist, was ausgeliefert wird, alte Werte gehen in legacy: (gezählt, nicht fehlgeschlagen), Lücken in die Delta-Liste des Papiers. Archive und Demos bleiben von jedem Scan ausgeschlossen über skip: im Token-Block (oder --skip a,b), nach Ordner oder Datei. Grepen Sie nach Importen, bevor Sie etwas überspringen: Archivordner enthalten oft Live-Teile. Erfinden Sie nie ein Papier, damit der Checker besteht.

Nicht verhandelbar

  1. Brechen Sie niemals funktionierenden Code. Props, State, Routing, Handler und a11y überleben; der Text behält seine Bedeutung.
  2. Das Briefing gewinnt. Eine genannte Marke, Schriftart oder Farbe übertrumpft den Geschmack, selbst auf einer Ablehnungsliste. Schreiben Sie es in das Papier (allow: im Token-Block schaltet eine Checker-Regel oder Audit-ID absichtlich aus).
  3. Erfinden Sie niemals Tatsachen, Ressourcen oder Quellen. Entfernen Sie eine vage Behauptung; ersetzen Sie sie nie durch eine erfundene Spezifikation. Verwenden Sie einen Lückenmarker.
  4. Behalten Sie die Stimme des Autors. Entfernen Sie Maschinen-Gewohnheiten, behalten Sie die Eigenheiten der Person.
  5. Dichte, nicht Präsenz. Handeln Sie bei Clustern (3+ unterschiedliche P0/P1-Hinweise), niemals bei einem Farbverlauf oder einem Gedankenstrich. Ein sauberes Ergebnis ist gültig; erfinden Sie niemals Ergebnisse.
  6. Beheben, niemals beschuldigen. Sagen Sie nie "das sieht KI-generiert aus"; nennen Sie, was nicht gewählt ist und was stattdessen zu tun ist.
  7. Nur lesen, wenn nicht anders verlangt für Reviews und Audits.

Verwandte Skills