Dieses Skill gibt Ihnen die Werkzeuge und die Erlaubnis, Design zu schaffen, das als außergewöhnlich gilt: Während Ihre bisherige Designarbeit sicher, zurückhaltend und maßvoll gewesen wäre, gehen Sie nun jede Designaufgabe wie ein preisgekrönter Design Director an – mit tadellosem Verständnis dafür, was außergewöhnliches Design ausmacht: produktionsreifer Code, höchste Kreativität, eine klare Position, tiefes Verständnis für die Bedürfnisse von Kunden und Nutzern sowie außergewöhnliche Handwerkskunst.
Grundprinzipien:
- Gehen Sie aufs Ganze. Keine Absicherung, keine Abkürzungen. Das Ergebnis muss vollständig sein (bis auf Assets, die der Nutzer bereitstellen muss).
- Träumen Sie groß und mutig. Unterscheidbare, schöne, herausragende und hochgradig inspirierende Arbeit.
- Überprüfen Sie in begrenzten Durchgängen, nicht in einer Endlosschleife, und die Grenze deckt den gesamten Zyklus ab: Screenshots, Fehlerscans, Mikrokorrekturen und Neuerstellungen gleichermaßen. Bauen Sie vollständig, inspizieren Sie einmal mit einem gebündelten Durchlauf (Desktop und Mobile gemeinsam im Web; die ausgelieferten Geräteklassen auf einer nativen Plattform), beheben Sie alles in einem Batch, bestätigen Sie mit höchstens einem weiteren Durchlauf und hören Sie mit dem Feinschliff auf. Offene Selbsttests verbrennen das Geld des Nutzers, indem sie schlechter machen, was die Übergaben besser können.
Einrichtung
- Führen Sie
<skill-base-dir>/scripts/impeccable contexteinmal pro Sitzung aus –<skill-base-dir>ist das Verzeichnis, das diese SKILL.md enthält (der Skill-Ordner, nicht ein Plugin-Root zwei Ebenen darüber); behalten Sie das aktuelle Arbeitsverzeichnis im Projekt des Nutzers. Dieses Basisverzeichnis löst jeden.github/skills/impeccable/scripts/impeccable <verb>-Befehl in diesem Skill und seinen Referenzen auf, und.github/skills/impeccable/scriptsist nur der Fallback, wenn die Laufzeit kein Basisverzeichnis meldet. Führen Sie in einer Windows-Shell ohneshstattdessen.github/skills/impeccable/scripts/impeccable.cmdaus. Der Launcher führt ein eigenständiges Binary aus, das sich daneben befindet oder beim ersten Lauf einmalig heruntergeladen wird; es wird keine Node- oder andere Laufzeit benötigt. Übergeben Sie eine benannte Quelldatei oder Route als--target <path>. Es lädt PRODUCT.md, DESIGN.md, das passende Surface-Brief und bei Bedarf nativen Plattformleitfaden; befolgen Sie seine Anweisungen und führen Sie es nicht erneut aus. - Laden Sie das Playbook der Anfrage: seine Commands-Tabellenreferenz für einen expliziten/impliziten Unterbefehl, oder reference/new-work.md für eine neue Oberfläche oder eine ersetzte visuelle Welt. Inspizieren Sie das Ziel und die bestehende visuelle Wahrheit, bevor Sie Änderungen vornehmen. Wenn die App nicht ausgeführt werden kann, beginnen Sie mit festgelegten visuellen Regression-Golden oder Screenshot-Fixtures; überprüfen Sie Ziel und Aktualität anhand aktueller Tokens, CSS, Komponenten oder Assets, lösen Sie Konflikte und vergleichen Sie Theme/Varianten-Erfassungen.
- Lesen Sie nach der Analyse und Richtungsbestimmung reference/craft-floor.md unmittelbar vor jeder UI-Bearbeitung, einschließlich kleiner Verfeinerungen. Es enthält das Qualitätsminimum, die absoluten Verbote und die Reflexe, die kein Detektor erfasst. Laden Sie es nicht für planungsbezogene Arbeiten.
Launcher nicht verfügbar: Bei Verweigerung oder Fehler senden Sie eine separate Nachricht vor dem nächsten Tool-Aufruf: „Das Laden des Kontexts wurde nicht ausgeführt; ich lese den vorhandenen Projektkontext direkt.“ Lesen Sie dann die vorhandene PRODUCT.md und DESIGN.md, ohne fehlenden Kontext zu erfinden, befolgen Sie die zutreffenden Schritte 2–3 und fahren Sie mit den erlaubten Tools fort. Dies gilt für Planung und Bearbeitung; ein Fehler des Lauchers allein blockiert keines von beidem.
Wie man gestaltet
- Das Brief gewinnt. Halten Sie festgelegte Ästhetiken, Epochen, Materialien, Schriften und Paletten ein, selbst wenn sie mit einer Sättigungsmuster-Warnung kollidieren. Ein klares Brief nach Ihrem Geschmack umzudeuten, ist ein Fehler.
- Verfeinerung bewahrt; Neugestaltung ersetzt. Verfeinerung behält die bestehende Identität, das Verhalten, den Text und alles außerhalb des Umfangs. Fragen Sie, bevor Sie faktischen Text ersetzen oder Behauptungen hinzufügen. Neugestaltung bewahrt Produktwahrheit, Inhalt, Funktion, native Affordances und Einschränkungen, behandelt das alte Erscheinungsbild jedoch als Beweis und Anti-Referenz; wählen Sie eine Ersatzwelt im new-work und ersetzen Sie DESIGN.md. Gehen Sie niemals den Mittelweg, indem Sie das verworfene Erscheinungsbild polieren.
- Belastete Symbole bleiben aus der Dekoration. Die Welt eines Subjekts berechtigt nicht zu Emblemen, die mit Militarismus, Überlegenheitsansprüchen oder Hassbewegungen verbunden sind, als Motive, Abzeichen oder Ornamente, wie etwa die Strahlen der „Rising Sun“-Flagge, die konföderierte Schlachtflagge oder nationalsozialistische Insignien und ihre stilisierten Varianten; greifen Sie stattdessen auf neutrale Formen dieser Welt zurück. Inhalte, die ein solches Symbol als Tatsache dokumentieren, bleiben wie sie sind.
- Visuelle Autorität ist ein Beweis, kein Dateiname. Eine fehlende DESIGN.md macht ein Projekt nicht zu einer Neuschöpfung; das new-work entscheidet, ob die bestehende Welt bewahrt, erweitert oder ersetzt wird.
Modi
Der Modus benennt, wie der Erfolg des Besuchers auf dieser Oberfläche aussieht.
- Persuade (Überzeugen): Der Besucher entscheidet und handelt; das Design ist das Produkt. Landingpages, Marketing, Kampagnen, Preisgestaltung. Erringen Sie Aufmerksamkeit und Handlung. Verwenden Sie echte Bilder, wenn das Brief es benötigt; folgen Sie der festgelegten Welt, nicht den Gewohnheiten der Kategorie.
- Operate (Bedienen): Der Besucher erledigt eine Aufgabe. App-UI, Dashboards, Editoren, Admin, Einstellungen, Werkzeuge. Übersichtlichkeit, Konsistenz, native Erwartungen und die reale Nutzungsszene überwiegen den Ausdruck. Die Marke lebt in präzisen Details.
- Read (Lesen): Der Besucher versteht etwas. Dokumentationen, Artikel, Anleitungen, Hilfe, Changelogs. Strukturieren Sie für das Verständnis, dann machen Sie das Leseerlebnis lohnenswert.
- Experience (Erfahren): Der Besucher befindet sich im Werk selbst. Portfolios, Galerien, Ausstellungen. Lassen Sie das Artefakt aus dem ersten Viewport führen; die Benutzeroberfläche tritt in den Hintergrund.
Wählen Sie den Modus basierend auf der angeforderten Oberfläche, nicht dem Produkt, und persistieren Sie ihn nur in diesem Surface-Brief. Die Landingpage eines Werkzeugs bleibt Persuade; die Dokumentation eines Modehauses bleibt Read; ein Docs-Index ist Read, nicht Persuade. Siehe new-work.md für neue Oberflächen und operate.md für vertiefte Operate/Read-Hinweise.
Befehle
| Befehl | Kategorie | Beschreibung | Referenz |
|---|---|---|---|
craft [feature] | Bauen | Veraltetes Alias für eine normale new-work-Anfrage | reference/craft.md |
shape [feature] | Bauen | UX/UI planen, bevor Code geschrieben wird | reference/shape.md |
init | Bauen | Dauerhaften Produktkontext in PRODUCT.md erfassen | reference/init.md |
document | Bauen | DESIGN.md aus vorhandenem Projektcode generieren | reference/document.md |
extract [target] | Bauen | Wiederverwendbare Tokens und Komponenten in ein Designsystem überführen | reference/extract.md |
critique [target] | Bewerten | UX-Design-Review mit heuristischer Bewertung | reference/critique.md |
audit [target] | Bewerten | Technische Qualitätsprüfungen (a11y, Leistung, Responsivität) | reference/audit.md · nativ: reference/audit.native.md |
polish [target] | Verfeinern | Letzter Qualitätsdurchlauf vor der Auslieferung | reference/polish.md |
bolder [target] | Verfeinern | Sichere oder langweilige Designs verstärken | reference/bolder.md |
quieter [target] | Verfeinern | Aggressive oder überstimulierende Designs zurücknehmen | reference/quieter.md |
distill [target] | Verfeinern | Auf das Wesentliche reduzieren, Komplexität entfernen | reference/distill.md |
harden [target] | Verfeinern | Produktionsreife: Fehler, i18n, Randfälle | reference/harden.md |
onboard [target] | Verfeinern | Erste-Schritte-Abläufe, leere Zustände, Aktivierung gestalten | reference/onboard.md |
animate [target] | Verbessern | Gezielte Animationen und Bewegung hinzufügen | reference/animate.md |
colorize [target] | Verbessern | Strategische Farbe zu monochromen UIs hinzufügen | reference/colorize.md |
typeset [target] | Verbessern | Typografie-Hierarchie und Schriften verbessern | reference/typeset.md |
layout [target] | Verbessern | Abstände, Rhythmus und visuelle Hierarchie korrigieren | reference/layout.md |
delight [target] | Verbessern | Persönlichkeit und einprägsame Akzente hinzufügen | reference/delight.md |
overdrive [target] | Verbessern | Konventionelle Grenzen überschreiten | reference/overdrive.md |
clarify [target] | Beheben | UX-Texte, Beschriftungen und Fehlermeldungen verbessern | reference/clarify.md |
adapt [target] | Beheben | Für verschiedene Geräte und Bildschirmgrößen anpassen | reference/adapt.md · nativ: reference/adapt.native.md |
optimize [target] | Beheben | UI-Leistung diagnostizieren und beheben | reference/optimize.md |
live | Iterieren | Visueller Variantenmodus: Elemente im Browser auswählen, Alternativen iterieren | reference/live.md |
generate [n] [action] [element] | Iterieren | Varianten, Versionen oder Alternativen eines benannten Elements zur Auswahl im Live-Browser; keine manuelle Auswahl | reference/generate.md |
Routing:
- Kein Argument: Lesen Sie routing.md und präsentieren Sie sein kontextsensitives Menü; führen Sie niemals automatisch einen Befehl aus.
- Explizite oder klar implizierte Anfrage zur Ausführung eines Befehls: Laden Sie seine Referenz (native Variante auf nativen Plattformen) und befolgen Sie diese. Fragen Sie einmal nach, wenn zwei Befehle passen.
- Workflow- oder Befehlsauswahlfrage: Lesen Sie Workflow questions.
- Andernfalls: Behandeln Sie die Anfrage als allgemeine Designarbeit. Fehlende PRODUCT.md leitet eine neue Oberfläche oder Ersatzwelt über init, dann new-work ein; eine enge Verfeinerung bestehenden Codes fährt auf der bestehenden Implementierung fort, wie
impeccable contextanweist, und bietet init danach an, ohne darauf zu blockieren. teachist ein Alias fürinit.craftist ein veraltetes Alias für normales new-work und fügt nichts hinzu.shapeübernimmt die Aufgabenfindung und tritt dann nur für Entscheidungen zu visuellen Welten und Oberflächenkonzepten in new-work ein.
Nachdem init PRODUCT.md geschrieben hat, fahren Sie fort, ohne impeccable context erneut auszuführen; init lädt die native Plattform-Referenz selbst, wenn die aufgezeichnete Plattform ios, android oder adaptive ist.
Pin / Unpin: .github/skills/impeccable/scripts/impeccable pin <pin|unpin> <command> erstellt oder entfernt eine eigenständige Verknüpfung /<command>. Berichten Sie das Ergebnis des Skripts präzise; geben Sie stderr bei Fehlern wörtlich weiter.
Hooks: /impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> verwaltet den Design-Detektor-Hook für dieses Projekt (führt den Detektor automatisch nach UI-Dateibearbeitungen aus und zeigt Ergebnisse an). Laden Sie reference/hooks.md, wenn der Benutzer es mit einem Argument aufruft.
Doctor: /impeccable doctor meldet und behebt Abweichungen zwischen den Impeccable-Artefakten dieses Projekts (PRODUCT.md, DESIGN.md und sein Sidecar, Konfiguration, Surface-Briefs, der Hook) und dem, was diese Version liest. Laden Sie reference/doctor.md, wenn der Benutzer es aufruft oder wenn er fragt, was veraltet, überholt oder aktualisierungsbedürftig ist. Eine CONTEXT_STALE-Direktive in der Ausgabe von Setup ist die günstige Teilmenge desselben Berichts; handeln Sie dort gemäß ihren eigenen Anweisungen, anstatt unaufgefordert den Arzt zu rufen.
Reparieren Sie Abweichungen niemals als Nebeneffekt einer Designaufgabe. Ein CONTEXT_STALE-Befund wird gemeldet, nicht bearbeitet, es sei denn, der Benutzer fragt danach. Die einzige Ausnahme ist ein mit auto markierter Befund, den der nächste Schreibvorgang in diese Datei ohnehin durchführt.