Impeccable erklärt: Design-Befehle wie critique und polish für Coding-Agenten

Was ist Impeccable? Impeccable ist ein Skill, der einem Coding-Agenten Wörter für Gestaltungsentscheide gibt: Statt «mach es schöner» sagt man /impeccable critique für eine Bewertung oder /impeccable polish für den letzten Schliff vor der Veröffentlichung. Jeder Befehl lädt eine eigene, ausführliche Anleitung.

Das README stellt das Problem so dar: Ohne weitere Vorgaben greifen Agenten immer wieder zu Inter, violett-blauen Verläufen, verschachtelten Karten und einer abgerundeten Icon-Kachel über jeder Überschrift.

Warum Impeccable gerade so gefragt ist

Das Repository pbakaus/impeccable existiert seit dem 16.11.2025 und hatte am 04.11.2026 102'078 Sterne und 6'020 Forks. Im Oktober kamen laut GitHub-Trends rund 27'000 Sterne dazu, in der letzten Woche vor unserem Test rund 11'400 (Stand 04.11.2026, Quelle: GitHub). Laut Release-Liste erschienen am 26.10.2026 Skill 4.8.0, CLI 4.8.0 und eine neue Engine-Version. Das Projekt unterstützt inzwischen rund 20 Agenten-Umgebungen, von Claude Code über Cursor bis Gemini CLI.

So funktioniert es

Die Befehle sind in Gruppen geordnet:

• Steuern: bolder, quieter, distill, colorize, typeset, layout, animate, delight, overdrive.
• Bewerten: critique (UX-Bericht mit Punkten) und audit (Barrierefreiheit, Performance, Responsive, P0 bis P3).
• Fertigstellen: polish, harden, clarify, adapt, optimize, onboard.
• Live iterieren: live und generate, Varianten direkt im Browser.
• Planen: shape, init (schreibt PRODUCT.md), document (schreibt DESIGN.md), extract.

Jede Oberfläche wird einem Modus zugeordnet: Persuade (überzeugen, etwa Landingpages), Operate (bedienen, etwa Dashboards), Read (lesen) und Experience (erleben). Vor jeder Änderung lädt der Agent eine Datei mit Mindestanforderungen und Verboten, zum Beispiel: kein Label über Überschriften, kein Verlaufstext, keine gleich grossen Karten mit Icon als Seitengerüst.

Installation

Laut README im Projektordner:

npx impeccable install

Danach das Werkzeug neu laden und einmal /impeccable init ausführen. Als Claude-Code-Plugin nennt das README /plugin marketplace add pbakaus/impeccable. Den Detektor gibt es auch ohne Agent, etwa als npx impeccable detect src/. Wer keinen Node-basierten Installer will, kann laut README den Ordner .claude/skills/impeccable aus dem Repository von Hand kopieren, verzichtet dann aber auf Hook und Subagenten.

Unser Test

Skill-Dateien von GitHub (Commit 695cea5, Skill 4.8.0), angewendet von Claude Opus 5.5 am 04.11.2026, Ergebnis eine Stichprobe von eins. Ausgangslage war die gemeinsame generische LandingpageEine Landingpage ist eine eigenständige Webseite, die auf genau ein Ziel ausgerichtet ist — eine Anfrage, eine Buchung, einen Download oder einen Kauf — und…Mehr erfahren → der fiktiven «Schreinerei Holzwerk Muster, Winterthur». Den Launcher, die Engine und den Detektor haben wir nicht ausgeführt; der Skill sieht dafür einen Fallback vor, bei dem der Agent die Projektdateien direkt liest.

Schritt 1, critique. Der Bericht folgt der Vorlage aus critique.md. Weil der Detektor nicht lief und die Designprüfung nicht in einem isolierten Subagenten stattfand, trägt er den vorgeschriebenen Hinweis «DEGRADED». Ergebnis: 13 von 24 Punkten (vier Heuristiken als nicht anwendbar markiert), Urteil zur Eigenständigkeit «kategorie-austauschbar». Die fünf Probleme: überladener Hero (P1), nicht belegte Kennzahlen (P1), TypografieTypografie ist die Gestaltung mit Schrift: die Wahl der Schriftarten und ihre Anordnung in Grösse, Zeilenabstand, Zeilenlänge, Gewicht und Hierarchie. Im…Mehr erfahren → ohne Rollen (P2), Vorlagen-Gerüst mit Eyebrows und Emoji (P2), monotone Abstände (P3).

Schritt 2, Verfeinerung. Weil keine echte Rückfrage möglich war, haben wir stellvertretend «Top 3, Farbwelt bleibt, Kennzahlen nicht ohne Rückfrage ändern» gewählt und die empfohlenen Befehle distill, typeset, layout und zuletzt polish ausgeführt.

Was sich geändert hat:

• Typografie: Inter bleibt, aber mit 600 statt 800, klarer Rollen-Skala und ausgeglichenen Zeilenumbrüchen.
• Abstände: 4er-Raster, Hero linksbündig mit der Neuheit als eigenem Block rechts, Leistungen ohne Kästen unter einer Linie.
• Farben: der violette Verlauf bleibt im Hero, Verlaufstext, leuchtende Schatten und Farbflecken sind weg.
• Hierarchie: Badge und Statistiken raus aus dem Hero, ein Primärknopf, Kennzahlen und Sterne in den Abschnitt Kundenstimmen verschoben.

Ehrliche Bewertung: Das Ergebnis ist sauberer und ruhiger, wirkt aber immer noch wie eine Software-Seite und nicht wie eine Schreinerei. Genau das sagt die Anleitung voraus: polish verfeinert die bestehende Welt. Der critique-Bericht empfahl für dieses Konzept ein Redesign, das wir im Rahmen dieses Tests nicht mehr ausgeführt haben. Stark ist Impeccable bei der Diagnose: Der Bericht war präziser und besser priorisiert als eine freie Bewertung ohne Vorlage. Besonders nützlich waren die Persona-Prüfungen, die zum Beispiel festhielten, dass Erstbesucher die Adresse der Werkstatt erst im Footer finden und dass das pulsierende Badge ohne Rücksicht auf reduzierte Bewegung läuft. Solche Befunde lassen sich direkt in Aufgaben übersetzen.

Beispiele aus der Praxis

• Bestehende Web-AppEine Web-App ist eine Anwendung, die im Browser läuft und sich wie ein Programm bedienen lässt — mit Login, Eingaben, gespeicherten Daten und Abläufen. Anders…Mehr erfahren → eines KMU: critique auf einen einzelnen Bereich, etwa das Anmeldeformular, liefert eine priorisierte Liste, die sich direkt abarbeiten lässt.
• Agenturen vor der Abgabe: audit und polish als feste letzte Schritte vor dem Livegang, ergänzt durch den Detektor in der CI.
• Designsysteme: document hält das bestehende System in einer DESIGN.md fest, damit spätere Änderungen im Stil bleiben.

Grenzen, Risiken, Lizenz

Apache-2.0-Lizenz, kostenlos. Der Installer und die Engine sind ausführbarer Code, der laut README teils beim ersten Lauf nachgeladen wird. Das README nennt selbst eine Besonderheit des Live-Modus: Wenn kein Chat-Agent abfragt, wendet er Text-Änderungen über codex oder claude mit abgeschalteten Freigaben an. Mit IMPECCABLE_LIVE_COPY_AGENT=chat oder off lässt sich das verhindern. Wie man fremde Werkzeuge in einem abgeschotteten Projekt testet, beschreibt unser Beitrag zu sicherem Vibe-Coding.

Für wen lohnt sich Impeccable?

Für Teams mit bestehenden Oberflächen, die eine wiederholbare Bewertung und gezielte Verfeinerung brauchen. Wer eine neue Seite in eigener Gestaltung will, sollte die anderen Skills aus unserem Vergleich der Anti-Slop-Skills ansehen. Für Bedienoberflächen, die über Designbefehle hinausgehen, lohnt ein Blick auf unsere UX-Agentur in Zürich.

Weitere Projekte aus dieser Serie finden Sie in der Übersicht über alle 20 GitHub-Trends vom November 2026.