Impeccable — Design Guidance for AI Coding Agents

Every model trained on the same SaaS templates. Skip the guidance and you get the same handful of tells on every project: Inter for everything, purple-to-blue gradients, cards nested in cards, gray text on colored backgrounds, the rounded-square icon tile above every heading. Impeccable fixes that.

What it adds

• One setup flow. /impeccable init writes PRODUCT.md and offers DESIGN.md, so later commands know the audience, brand/product lane, voice, anti-references, colors, type, and components.
• 23 commands. A shared design vocabulary with your AI: polish, audit, critique, distill, animate, bolder, quieter, and more.
• 45 deterministic detector rules plus LLM-only critique checks. The CLI and browser extension run the deterministic rules with no LLM and no API key.

The 23 Commands

All commands run through /impeccable:

| Command | What it does | |---------|--------------| | /impeccable craft | Full shape-then-build flow with visual iteration | | /impeccable init | One-time setup: gather design context, write PRODUCT.md and DESIGN.md, configure live mode | | /impeccable document | Generate root DESIGN.md from existing project code | | /impeccable extract | Pull reusable components and tokens into the design system | | /impeccable shape | Plan UX/UI before writing code | | /impeccable critique | UX design review: hierarchy, clarity, emotional resonance | | /impeccable audit | Run technical quality checks (a11y, performance, responsive) | | /impeccable polish | Final pass, design system alignment, shipping readiness | | /impeccable bolder | Amplify boring designs | | /impeccable quieter | Tone down overly bold designs | | /impeccable distill | Strip to essence | | /impeccable harden | Error handling, i18n, text overflow, edge cases | | /impeccable onboard | First-run flows, empty states, activation paths | | /impeccable animate | Add purposeful motion | | /impeccable colorize | Introduce strategic color | | /impeccable typeset | Fix font choices, hierarchy, sizing | | /impeccable layout | Fix layout, spacing, visual rhythm | | /impeccable delight | Add moments of joy | | /impeccable overdrive | Add technically extraordinary effects | | /impeccable clarify | Improve unclear UX copy | | /impeccable adapt | Adapt for different devices | | /impeccable optimize | Performance improvements | | /impeccable live | Visual variant mode: iterate on elements in the browser |

Use /impeccable pin <command> to create standalone shortcuts (e.g., pin audit creates /audit).

Usage Examples

/impeccable audit blog        # Audit blog hub + post pages
/impeccable critique landing  # UX design review
/impeccable polish settings   # Final pass before shipping
/impeccable harden checkout   # Add error handling + edge cases
/impeccable redo this hero section  # Or just describe what you want

Anti-Patterns (what to avoid)

• Don't use overused fonts (Arial, Inter, system defaults)
• Don't use gray text on colored backgrounds
• Don't use pure black/gray (always tint)
• Don't wrap everything in cards or nest cards inside cards
• Don't use bounce/elastic easing (feels dated)

Installation

Option 1: CLI installer (Recommended)

npx impeccable install

Detects your harness folders (e.g. ~/.claude, ~/.codex, project-local .cursor), lets you keep or customize providers, and asks whether to install project-local or globally. Use --providers=claude,codex,cursor and --scope=project|global to skip prompts. Works with Cursor, Claude Code, Gemini CLI, Codex CLI, and more. Reload your harness afterward.

To refresh an existing install:

npx impeccable update

Option 2: Git Submodule

git submodule add https://github.com/pbakaus/impeccable .impeccable
npx impeccable link --source=.impeccable --providers=claude,cursor
git add .gitmodules .impeccable .claude .cursor
git commit -m "Add Impeccable skills"

Option 3: Download from Website Visit impeccable.style, download the ZIP for your tool, and extract to your project.

Option 4: Copy from Repository Copy the relevant dist/<provider> folder into your project. Supported providers: Claude Code, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, OpenCode, Pi, Qoder, Trae, Rovo Dev.

Requirements

• An AI coding agent / harness (Claude Code, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, etc.)
• Node.js (for the CLI installer)
• No API key required for the 45 deterministic detector rules (LLM critique uses your existing agent)