Impeccable

Design

Design language for AI coding agents: 23 commands and 44 deterministic detectors that kill AI design tells and ship polished UI.

by Paul Bakauspbakaus/impeccable

Stars84.8k

Forks5.1k

Watchers198

Open issues48

LicenseApache-2.0

Last pushtoday

Install

install

$ npx impeccable install

Update

update

$ npx impeccable install

Re-running the installer fetches the latest version for your harness.

When to use it

You want AI-generated frontends to stop shipping the same tells (Inter everywhere, purple gradients, cards nested in cards, gray text on color)
You need a shared design vocabulary with your agent — craft, shape, audit, critique, polish, distill, harden, animate, and more
You want deterministic, no-API-key checks that catch design anti-patterns and a11y/perf/responsive issues on every UI edit
You run multiple AI harnesses (Claude Code, Cursor, Codex, Gemini CLI, Copilot…) and want one design workflow across all of them

Commands & flags

/impeccable init: Run once to write PRODUCT.md and DESIGN.md design context every command reads.
/impeccable <command> <target>: Single entry point for all 23 commands, e.g. /impeccable audit landing.
/impeccable critique: Critique the current UI against the captured design language.
/impeccable polish settings: Polish a specific surface (here, the settings screen).
/impeccable harden checkout: Harden a flow for edge cases, a11y, and error states.
/impeccable live: Iterate on UI variants in-browser.
/impeccable hooks on: Opt in the per-project hook so the 44 deterministic detectors run after every UI edit.
/impeccable pin <command>: Create a standalone shortcut, e.g. /audit.

How to use it

Install with the npx command (it detects your harness and asks project vs global), then run /impeccable init once to write PRODUCT.md and DESIGN.md design context that every later command reads.

npx impeccable install

Drive it with the single /impeccable <command> <target> entry point — e.g. /impeccable audit landing, /impeccable critique, /impeccable polish settings, /impeccable harden checkout. There are 23 commands plus /impeccable live for in-browser variant iteration. Opt the per-project design-detector hook in with /impeccable hooks on so the 44 deterministic rules run after every UI edit and surface findings inline. /impeccable pin <command> creates standalone shortcuts (e.g. /audit).

Why it earns its place

Every model trained on the same SaaS templates, so skipping design guidance yields the same handful of tells on every project. Impeccable started from Anthropic's frontend-design skill and goes further: one setup flow that captures audience, brand lane, voice, anti-references, color, and type; 23 commands that give you and your agent a shared design vocabulary; and 44 deterministic detector rules that run with no LLM and no API key (in the CLI and a browser extension) to catch anti-patterns before they ship. Apache-2.0, ~39k stars, by Paul Bakaus, and it installs across nine+ AI runtimes so the discipline travels with you.

Try it

claude

> /impeccable audit my landing page