---
audit: impeccable.style
date: 2026-05-18
auditor: aria-subagent
verdict: pattern-adoption-wuerdig (tool-irrelevant for direct install)
priority: medium
---

# Impeccable.style — Audit-Report (Aria-First)

## 0. TL;DR (90 Sekunden)

- **Was:** Open-Source Claude-Code-Skill + CLI + Chrome-Extension fuer "design fluency in AI harnesses". 1 Skill, 23 Slash-Commands, 29 deterministische Anti-Pattern-Detektoren.
- **Owner:** Paul Bakaus (pbakaus), Ex-Google (AMP-Lead, Chrome DevTools DevRel), jQuery-UI-Erfinder. Vermarktet ueber "Renaissance Geek" (coming-soon-Page).
- **Preis:** 100% kostenlos, Apache-2.0, kein Account, kein API-Key.
- **Stars:** 28.5k GitHub-Stars in ~4 Monaten — viral relevant. 10k in unter 4 Monaten.
- **Tech-Stack der Website:** Astro statisch, Cloudflare-CDN, Google Analytics (GA4 G-TEXGHC7V34). Google Fonts (Cormorant Garamond, Instrument Sans, Inter, Space Grotesk).
- **Telemetrie im Skill/CLI:** Keine. Skill-Code macht keine Network-Calls, CLI nutzt nur lokales DOM-Parsing (htmlparser2, css-select, css-tree) + optional Puppeteer.
- **Prompt-Injection-Scan:** Clean. Keine Persona-Override, keine Remote-Fetch-in-Prompt, keine Postinstall-Scripts in package.json.
- **Verdict:** Direkter Install fuer Aria **nicht noetig** (wir haben frontend-design + ui-ux-pro-max). ABER: **3 pattern-adoption-wuerdige Ideen** — Anti-Pattern-Linter, Persona-Critique mit 3 expliziten Personas, /shape-Discovery-Interview vor Code.

---

## 1. Was bietet die Page an?

**Produktform:** Multi-Surface AI-Design-Toolkit, kein SaaS.

| Surface | Funktion | Install |
|---|---|---|
| **Agent-Skill** | 1 Skill "impeccable" mit 23 Slash-Commands fuer Claude Code, Cursor, Gemini CLI, Codex CLI, VS Code Copilot | `npx skills add pbakaus/impeccable` |
| **CLI-Tool** | `impeccable detect` — 29 deterministische Anti-Pattern-Regeln gegen HTML/URLs | `npm i -g impeccable` |
| **Chrome-Extension** | Live-Overlay-Detektor auf jeder Website, one-click activation | Chrome Web Store |
| **Live Mode (Alpha)** | `npx impeccable live` startet lokalen Server, Browser-Variant-Gen mit HMR-Support | im CLI inkludiert |
| **Newsletter** | "Monthly-ish design notes" via Substack (impeccablestyle.substack.com) | Opt-in |

**Domain-Files:** Skill schreibt zwei lokale Markdown-Files in dein Repo:
- `PRODUCT.md` (Brand-Register, Zielgruppe, Personality, Anti-References)
- `DESIGN.md` (Colors, Typography, Components in Google-Stitch-Format)

Diese werden bei jedem Command in den Context geladen ("Design serves the task" vs. "Design IS the product").

**Verbatim Tagline:**
> "1 skill, 23 commands, and curated anti-patterns for impeccable frontend design. Works with Cursor, Claude Code, Gemini CLI, and Codex CLI."

> "Great design prompts require design vocabulary. Most people don't have it."

> "An opinionated design partner, not a validator."

---

## 2. Wer ist der Owner?

**Paul Bakaus** (GitHub: pbakaus, X: @pbakaus, San Francisco)

Public-record Background:
- **jQuery UI** Founder (2007), powers ~20% des Web bis heute
- Ex-Google: Lead-DevRel **Chrome DevTools** + Kickstart-Lead **AMP-Project**
- Erste In-Browser Game-Engine, acquired by Zynga
- Aktuell: "two-time founder, product strategist, creative technologist"
- Vehikel: **Renaissance Geek** (renaissance-geek.ai) — Page ist noch "coming soon" mit Email-only-Contact

**Glaubwuerdigkeit:** Hoch. Tier-1-Owner, kein Indie-Bastler. Das erklaert auch die Stars-Velocity (28.5k in ~4 Monaten).

**Footer/Impressum impeccable.style:** Kein klassisches Impressum (US-Stil), aber:
- "Built by Renaissance Geek"
- Email-Link via Cloudflare-Obfuscation
- LinkedIn-Link, X-Link @pbakaus + @impeccable_ai
- Privacy-Page existiert (`/privacy`)

---

## 3. Wertversprechen & Zielgruppe

**Pitch:** Du sprichst keine Design-Sprache, also produzieren AI-Coding-Agents Standard-AI-Slop (purple gradients, glassmorphism, Inter-Everywhere). Impeccable gibt dir die Sprache und dem Agent die Regeln, sodass der Output aussieht wie von Designer:in.

**Zielgruppe (priorisiert):**
1. **Frontend-Engineers** die mit Claude Code/Cursor bauen aber kein Auge haben
2. **Indie-Hacker/Solo-Founder** die ohne Designer Production-UI brauchen
3. **Product-Designer die in Code arbeiten** wollen aber dem Agent steuern muessen
4. **Enterprise-Teams** (Bakaus offeriert Consulting via Renaissance Geek)

**Schmerzpunkt-Vokabular:** "AI slop", "Bootstrap-3-Output", "feature card template", "purple-gradients-and-glassmorphism look".

**Differenzierung vs. generic AI-Design:**
- "Generated reference imagery as design direction before code"
- "Live Mode — visual browser-based refinement"
- "Anti-pattern awareness" (29 deterministische Regeln)
- "Design debt tracking through extraction"

---

## 4. Pricing

**0 EUR.** Apache-2.0-Lizenz. Kein Subscription, kein Freemium, kein API-Key, kein Account.

Monetarisierung implizit ueber:
- Personal-Brand Bakaus (Speaking, Consulting)
- Enterprise-Consulting via Renaissance Geek
- Substack-Newsletter (kein bekanntes Paid-Tier sichtbar)

Das ist ein **Awareness-+-Funnel**-Spiel, nicht ein Revenue-Produkt.

---

## 5. Tech-Stack der Page

**Website (impeccable.style):**
- **Framework:** Astro (static, build-output `_astro/*.astro_*.js`)
- **Hosting/CDN:** Cloudflare (cf-ray, alt-svc h3, nel-reporting)
- **Fonts:** Google Fonts (4 Familien: Cormorant Garamond, Instrument Sans, Inter, Space Grotesk — bemerkenswert: Inter ist auf der eigenen Anti-Pattern-Liste als "overused")
- **Analytics:** Google Analytics 4 (Measurement-ID `G-TEXGHC7V34`) — sonst nichts
- **Email-Obfuscation:** Cloudflare email-decode.min.js
- **Security-Headers:** `referrer-policy: strict-origin-when-cross-origin`, `x-content-type-options: nosniff`, `x-frame-options: SAMEORIGIN`
- **Cache:** `cache-control: public, max-age=0, must-revalidate` (Edge-Cache aber Origin-Revalidate)

**CLI (npm-package):**
- `dependencies` (5): css-select, css-tree, domutils, htmlparser2, marked
- `devDependencies` (16): astro, playwright, wrangler, @anthropic-ai/sdk, @ai-sdk/anthropic, @ai-sdk/openai, zod, puppeteer (optional)
- **Postinstall/Preinstall:** keine
- **Bin:** ein Executable `impeccable -> cli/bin/cli.js`

**Skill-Repo-Struktur (skill/):**
```
skill/
  SKILL.md          # YAML frontmatter, 5 Kategorie-Tabellen
  agents/           # Sub-agent reference files
  reference/        # Pro-Command Markdown (z.B. reference/craft.md)
  scripts/          # Node-Scripts (load-context.mjs, pin.mjs, live.mjs)
```

**SKILL.md frontmatter (verbatim relevant):**
```yaml
name: impeccable
description: Use when the user wants to design, redesign, shape, critique, audit...
argument-hint: [{{command_hint}}] [target]
user-invocable: true
allowed-tools: Bash(npx impeccable *)
license: Apache 2.0 with attribution to Anthropic's frontend-design skill
```

Bemerkenswert: `allowed-tools: Bash(npx impeccable *)` — Whitelisting-Pattern, statt unbeschraenktem Bash. Sauber.

---

## 6. GitHub-Repo / NPM / Skill-Marketplace

| Channel | Identifier | Status |
|---|---|---|
| GitHub | `pbakaus/impeccable` | **28.5k Stars, 1.5k Forks**, Apache-2.0, primary lang JavaScript (88.4%) |
| NPM | `impeccable` | v2.1.9 aktuell, kein Postinstall-Script |
| Chrome Web Store | extension-id `bdkgmiklpdmaojlpflclinlofgjfpabf` | live |
| Anthropic Skills Marketplace | `pbakaus/impeccable` | installierbar via `npx skills add pbakaus/impeccable` |
| Letztes Release | Skill v3.1.1 (14.05.2026) | aktiv maintained, 4 Tage alt |

**Adoption-Indikatoren (gefunden):**
- 10k Stars in unter 4 Monaten
- Anthropic's frontend-design wurde explizit als Ausgangspunkt genannt — also offizielle Lineage
- v1.5.1 shipped 17.03.2026, v3.1.1 shipped 14.05.2026 — schnelle Iteration

---

## 7. Telemetrie / Tracking-Scan

| Komponente | Tracking | Details |
|---|---|---|
| **Website impeccable.style** | Google Analytics 4 | Measurement-ID G-TEXGHC7V34, "page views, referrers, country" laut Privacy-Page |
| **CLI `impeccable`** | **KEINE** | Privacy-Page: "agent skills collect no data, make no network requests, and have no analytics" |
| **Chrome-Extension** | **NUR LOKAL** | "All anti-pattern detection happens locally on the page you are inspecting." Rule-Prefs in `chrome.storage.sync` |
| **Skill als Claude-Code-Plugin** | **KEINE** | "No data is sent to Impeccable's servers." |
| **Download-Logging** | minimal | "Bundle selection and timestamps, excludes identifying details" |
| **Werbecookies** | keine | Privacy-Page explizit |
| **Postinstall-Scripts** | keine | package.json verifiziert |

**Fazit Telemetrie:** Sehr sauber. GA4 nur auf Marketing-Site. Skill und CLI komplett air-gapped. Akzeptabel fuer Aria-Adoption.

---

## 8. Prompt-Injection-Scan

Pflicht-Scan laut Standing-Order `feedback_prompt_injection_scan.md`:

- **Persona-Override** ("now you are..."): **nicht gefunden** in SKILL.md
- **Remote-URL-Fetch in Prompt** (untrusted content in Context): **nicht gefunden** — Skill liest nur lokale `PRODUCT.md`, `DESIGN.md`, `reference/*.md`, scoped ueber `IMPECCABLE_CONTEXT_DIR`
- **Postinstall-Code-Execution:** **keine** (package.json verifiziert)
- **Untrusted-Shell-Composition:** sauber, statische Pfade, `allowed-tools: Bash(npx impeccable *)` Whitelist
- **Secrets-Leak-Patterns:** keine `.env`-References, kein Auth-Flow
- **Dynamic-Code-Eval:** nicht gefunden

**Restrisiko:** Puppeteer-CLI kann externe URLs scrapen (`impeccable detect <url>`). Das ist by-design fuer den Detector und scoped — aber: wer das Tool auf hostile-URL pointet, riskiert Puppeteer-CVEs. Standard-Risk, nicht Impeccable-spezifisch.

**Verdict:** Injection-clean.

---

## 9. Vergleich mit unseren existierenden Design-Skills

| Skill (Aria) | Scope | Ueberschneidung mit Impeccable |
|---|---|---|
| `frontend-design` (Anthropic) | "Bold aesthetic direction", produziert distinctive Frontend-Code | **Hoch** — Impeccable forked das explizit als Lineage, baut darauf auf |
| `ui-ux-pro-max` | 50+ Styles, 161 Color-Palettes, 57 Font-Pairings, 99 UX-Guidelines, 25 Chart-Types, 10 Stacks | **Mittel** — pro-max ist DATA-heavy (Lookup), Impeccable ist METHOD-heavy (Slash-Commands) |
| `web-design-guidelines` (Vercel) | Review-Skill fuer Web Interface Guidelines Compliance | **Hoch** — beide auditieren, aber web-design-guidelines hat keine Anti-Pattern-Liste, kein deterministisches Linter |
| `theme-factory` | 10 pre-set Themes mit Color/Font, oder generate-on-fly | **Niedrig** — Impeccable hat keine Theme-Library, beide komplementaer |
| `canvas-design` | Static-Art .png/.pdf via Design-Philosophy | **Keine** — anderer Use-Case (Print/Art) |
| `document-designer` | A4-Print-Dokumente, PDF-Bau | **Keine** — anderer Use-Case |

**Wirkliche Konkurrenz:** Impeccable vs. unser Stack = **frontend-design + ui-ux-pro-max + web-design-guidelines kombiniert**.

**Was Impeccable BESSER macht:**
1. **Deterministischer Linter** (29 Regeln) — wir haben keinen vergleichbaren Detector. web-design-guidelines ist nur LLM-Review.
2. **Slash-Command-Granularitaet** (`/polish`, `/colorize`, `/animate`, `/quieter`) — gibt User micro-control. Wir haben nur Macro-Trigger.
3. **Discovery-Interview `/shape`** schreibt PRODUCT.md vor Code-Gen — wir machen das ad-hoc.
4. **3 Critique-Personas** (Evaluator, Returning-User, Skeptiker) — strukturierter als unser brainstorming.
5. **Live Mode** mit HMR-Browser-Overlay — wir haben nichts vergleichbares.

**Was unser Stack BESSER macht:**
1. ui-ux-pro-max hat **viel mehr Data-Lookup** (161 Palettes, 57 Pairings, 25 Chart-Types). Impeccable kuratiert opinionated, wir haben Buffet.
2. canvas-design + document-designer decken Print/PDF — Impeccable ist Web-only.
3. theme-factory liefert ready-made Themes, Impeccable will dich durch Discovery lassen.

---

## 10. 5 Kais-Fragen

### (1) Was haben wir?
Sechs Design-Skills (frontend-design, ui-ux-pro-max, web-design-guidelines, theme-factory, canvas-design, document-designer). Stack ist **data-rich aber method-poor** — viel Lookup, wenig opinionated Workflow. Kein deterministisches Linter-Tool. Keine strukturierten Personas im Critique.

### (2) Was ist neu?
- **Deterministisches Anti-Pattern-Linting** mit 29 expliziten Regeln (purple gradient, glassmorphism, side-tab border, nested cards, Inter-Everywhere, gradient text, etc.) — komplett deterministisch, ohne LLM-Call.
- **23 Micro-Slash-Commands** (statt 1 grosser Macro-Skill) — `/polish`, `/quieter`, `/bolder`, `/colorize`, `/animate` einzeln aufrufbar.
- **Persona-driven Critique** mit 3 fixen Personas (Evaluator, Returning-User, Skeptiker) und Nielsen-10-Heuristics-Scoring 0-4.
- **Pre-Code Discovery** via `/shape` → schreibt PRODUCT.md, dann erst Code.
- **Live Mode** mit Browser-Server + HMR fuer visuelles Iterieren.
- **PRODUCT.md + DESIGN.md als Repo-Convention** — Design-Context wird Repo-Artifact, nicht Session-State.

### (3) Was koennen wir brauchen?
**Konkret adoption-wuerdig (priorisiert):**

1. **Anti-Pattern-Linter portieren** als Aria-Tool oder neuen Skill `design-lint`. 29 Regeln sind deterministisch in CSS/HTML implementierbar, Apache-2.0 erlaubt copy-paste mit Attribution. Einbau in Kadi-v2-PR-Gate sinnvoll.
2. **PRODUCT.md/DESIGN.md Repo-Convention** uebernehmen — fuer Kadi-v2, private-ops, und kuenftige Web-Projekte. Macht Brand-Decisions persistent statt session-bound. Passt zu unserer Constitution-Note-Pflicht.
3. **3-Persona-Critique-Pattern** in `ui-ux-pro-max` oder `web-design-guidelines` einbauen — gibt User reproduzierbaren Review-Output, weniger LLM-Drift.

**Optional/Watchlist:**
- Live-Mode-Architektur (HMR-Browser-Overlay) — interessant, aber wir haben gstack fuer QA. Komplement, nicht Ersatz.
- Substack als Distribution-Channel (sehe `feedback_research_aria_first`) — Bakaus' Newsletter beobachten fuer Pattern-Updates.

### (4) Was bringt es uns?
- **Kadi-v2-Sales-Story:** "Wir scannen euer UI gegen 29 AI-Slop-Anti-Patterns, deterministisch, im PR-Gate" — passt direkt zu `reference_ai_governance_gap_2026` (Governance-Pre-Built als Verkaufsstory).
- **Aria-Output-Qualitaet:** Wenn Aria selbst auf eigene Frontend-Outputs den Linter laeuft, vermeiden wir die Inter-Everywhere/Purple-Gradient-Falle automatisch. Pre-Output-Critic-Hook (KAR-65) hat schon Format-Drift, ein Design-Drift-Check ist natuerliche Erweiterung.
- **Standing-Order-Konvergenz:** PRODUCT.md/DESIGN.md-Convention passt zu Constitution-Note-Pflicht (`feedback_new_project_constitution_spec`).

### (5) Wie werden wir dadurch besser?
- Aria-Output wird **messbar besser im Design**, weil wir vor jedem Frontend-Output deterministisch 29 Slop-Patterns ausschliessen koennen.
- Wir haben einen **Linter-PR-Gate fuer Kadi-v2**, der bei BMW-Demos den Unterschied zu Bolt/v0/Lovable-Output zeigt.
- Multi-Session-Design-Konsistenz: PRODUCT.md/DESIGN.md persistieren Brand-Entscheidungen, sodass jede neue Session das gleiche Vokabular nutzt — kein Drift mehr zwischen Sessions.
- **Aria multipliziert:** Pattern auf Aria geklaut → automatisch auf alle Kunden-Projekte uebertragen (Kadi-v2, private-ops, custom).

---

## 11. Brutal-ehrliche Bewertung

**Stark:**
- Tier-1-Owner (jQuery-UI, Ex-Google-AMP), das treibt Adoption und Qualitaet
- Sauberes Engineering: keine Postinstall-Scripts, keine Telemetrie, Whitelisted-Tools, Apache-2.0
- Echte Innovation: deterministisches Anti-Pattern-Linting fuer AI-Output gibt's so wirklich nicht im Markt
- Schnelle Iteration (v3.1.1 nach 4 Monaten), 28.5k Stars sprechen Echo
- Mehrere Surfaces (Skill + CLI + Extension) — bedient verschiedene Workflows

**Schwach:**
- "23 Commands" sind teilweise Marketing-Inflation — `bolder` / `quieter` / `polish` / `delight` ueberlappen stark. Echt-distinkte Commands: ~10.
- Eigene Website nutzt `Inter` — selbst-flaggt das als "overused" Anti-Pattern. Glaubwuerdigkeitsdelle.
- Live Mode noch "Alpha", nicht production-ready
- `Renaissance Geek` Vehikel ist coming-soon — die "available for enterprise consulting" Story hat noch keinen Beleg-Surface
- PRODUCT.md/DESIGN.md Convention ist gut, aber kollidiert mit existierenden Brand-Files in Mono-Repos. Migration-Cost real.

**Risiko fuer Aria-Adoption:**
- Wenn wir den Linter copy-paste portieren, sind wir abhaengig davon dass die 29 Regeln nicht stale werden (AI-Slop wandert: heute purple-gradient, morgen was anderes). Bakaus' Update-Velocity ist hoch, das ist akzeptables Maintenance-Risk.
- Wenn wir den Skill direkt installieren, haben wir nochmal 23 Slash-Commands im Namespace — Slash-Command-Bloat. Daher: **klauen statt installieren**.

---

## 12. Verdict

**`tool-irrelevant for direct install, pattern-adoption-wuerdig`**

- **Direkter Install (`npx skills add pbakaus/impeccable`):** **Nein.** Wir haben mit frontend-design + ui-ux-pro-max + web-design-guidelines schon Ueberlappung. 23 weitere Slash-Commands waeren Namespace-Bloat.
- **Selektive Adoption:** **Ja, 3 Patterns:**
  1. **Anti-Pattern-Linter** (29 Regeln) portieren als neuer Aria-Skill `design-lint` oder integriert in `web-design-guidelines`. **Hoehe-Prioritaet** wegen Kadi-v2-Sales-Hebel.
  2. **PRODUCT.md/DESIGN.md Repo-Convention** uebernehmen als Standing-Order-Erweiterung von `feedback_new_project_constitution_spec`. **Mittel-Prioritaet.**
  3. **3-Persona-Critique-Pattern** (Evaluator/Returning-User/Skeptiker + Nielsen-10 Scoring 0-4) in `ui-ux-pro-max` oder `web-design-guidelines` einbauen. **Mittel-Prioritaet.**

**Recommendation Linear-Issues (Vorschlag, anlegen via KAR-Team):**
- `KAR-XXX: Aria-Skill design-lint — 29 deterministische Anti-Pattern-Regeln portieren (Apache-2.0 + Attribution)`
- `KAR-XXX: Standing-Order erweitern — PRODUCT.md/DESIGN.md im Repo-Bootstrap (Kadi-v2, private-ops)`
- `KAR-XXX: web-design-guidelines erweitern — 3-Persona-Critique + Nielsen-10 Scoring`
- `KAR-XXX (Watch-List): Bakaus' Substack abonnieren, Pattern-Updates beobachten`

---

## 13. Quellen

- https://impeccable.style/
- https://impeccable.style/docs/impeccable/
- https://impeccable.style/designing/
- https://impeccable.style/anti-patterns
- https://impeccable.style/docs/critique/
- https://impeccable.style/tutorials/getting-started/
- https://impeccable.style/visual-mode
- https://impeccable.style/privacy
- https://github.com/pbakaus/impeccable
- https://raw.githubusercontent.com/pbakaus/impeccable/main/package.json
- https://raw.githubusercontent.com/pbakaus/impeccable/main/skill/SKILL.md
- https://github.com/pbakaus
- https://paulbakaus.com/about/
- https://renaissance-geek.ai/ (coming soon)
- https://paddo.dev/blog/impeccable-design-vocabulary/
- https://computertech.co/impeccable-ai-review/
- https://abduzeedo.com/impeccable-open-source-ai-design-skill-better-ui
- https://apidog.com/blog/impeccable-claude-code-skill/
- https://chromewebstore.google.com/detail/impeccable/bdkgmiklpdmaojlpflclinlofgjfpabf