Impeccable skill for interface design. 24 commands and a detector for common AI design tells
Impeccable is a free skill by Paul Bakaus that gives an AI coding agent words for design work and catches the repeated tells of AI-made pages. We cover its commands, installing it in Claude Code and what to watch out for.
Part of the guideClaude Code, the complete guide. From installation to your own skills and plugins
In this article
In short
Impeccable is an open skill for interface work that gives an AI agent 24 commands, such as critique, audit and polish, and a detector with 62 rules that flags the typical tells of AI-made designs. In Claude Code you install it with npx impeccable install or as a plugin. It works best on a page that already exists.
Ask any AI agent for a page with no extra guidance and you often get the same thing. One typeface for everything, a purple to blue gradient, cards inside cards, grey text on a coloured background. The author of Impeccable lists exactly these patterns as the reason the skill exists. Impeccable gives the agent words for specific design moves and checks the result before it reaches your clients.
Everything below comes from the Impeccable repository on GitHub and the impeccable.style site, as of 10 November 2026. The project moves fast, so check the number of commands and rules at the source. The whole series is collected in our Claude Code guide.
What Impeccable is
Impeccable is one skill with many commands. Paul Bakaus created it, and the project is under the Apache 2.0 licence. The repository says Impeccable started from Anthropic's frontend-design skill, which we describe in official Claude skills.
It works in Claude Code, and also in Cursor, Codex CLI, GitHub Copilot, Gemini CLI, Google Antigravity and over a dozen other tools. That is possible because skills share an open format, which we explain in what is a Claude skill.
You work with it by naming a command and a target. For example /impeccable critique the pricing cards or /impeccable polish settings. You can also describe the job in plain words after /impeccable. The author advises narrow targets, because one section reviewed closely gives more than a whole page at a glance.
Impeccable commands
The README splits the commands into five groups. Typing /impeccable on its own shows the list in your tool.
| Group | Commands |
|---|---|
| Steer | bolder, quieter, distill, colorize, typeset, layout, animate, delight, overdrive |
| Review | critique, audit |
| Finish | polish, harden, clarify, adapt, optimize, onboard |
| Iterate live | live, generate |
| Plan and set up | shape, init, document, extract |
Two review commands help most at the start. critique scores the design against usability heuristics and ranks what to fix first. audit checks accessibility, performance, theming and behaviour across screen sizes, and ranks findings from P0, blocking, to P3, polish. The last of the 24 commands, craft, is deprecated.
Before the first job in a project you run /impeccable init. The skill reads your code, asks only what it cannot infer, such as who the product is for, and writes a PRODUCT.md file. The document command records your existing visual style in DESIGN.md, so later changes stay on brand. You can pin a command you use often. After /impeccable pin audit, plain /audit works.
How to install Impeccable in Claude Code
The author recommends the installer. In your project's root folder, type one command in a terminal. You need Node for it, because the command uses npx.
npx impeccable installThe installer detects your tools, asks whether to install for this project or globally, and offers a hook that checks every UI file the agent edits. Then reload Claude Code and run /impeccable init. To update, run npx impeccable update.
The second route is a plugin. In a Claude Code session type the command below, then open /plugin, go to the Discover tab and install Impeccable. How plugins work is explained in Claude Code plugins.
/plugin marketplace add pbakaus/impeccableThe third route needs no Node. Download the package from impeccable.style or clone the repository, and copy the .claude/skills/impeccable folder into .claude/skills/ in your project or into ~/.claude/skills/. A skill installed this way works, but without the hook and the helper subagents. General rules for copying skills are in installing Claude skills.
The detector and what to watch out for
The detector is 62 fixed rules that run without an AI model and without an API key. They look for the patterns above, and also for cramped padding or skipped heading levels. You can run it without an agent, in CI too.
npx impeccable detect src/
npx impeccable detect http://localhost:5173A scan of source files checks only code patterns. Rules that need a rendered page, such as low contrast, run when you scan a URL. Exit code 2 means findings, and 1 means something could not be scanned.
Three things are worth knowing before you install. Hooks in Claude Code run outside the approvals you give the model, so the first edited file can download Impeccable's engine. We explain how hooks work in Claude Code hooks. Live mode, when applying copy edits, can start claude with permission prompts turned off if no chat is waiting for the edits. Setting IMPECCABLE_LIVE_COPY_AGENT=chat keeps that in your own conversation. The skill also fetches visual directions from the impeccable.style catalog. The author says your project name, files and code are never sent, and npx impeccable telemetry off turns off the anonymous telemetry.
We have Impeccable installed in Claude Code, and it helps most where an interface already exists and needs work, which the author says too. If you do not code yourself, a good first step is to ask whoever builds your site to run critique on one section and talk through the result. If you want to see where AI can take work off your team, try our free AI audit.
Documentation for this topic
What would you like to change in your business?
Leave your number. We will talk about your process and see whether we can help. The first call is free.
The service this text is about
Automation and AI / OCRAutomation of document re-typing, OCR and checking rules, and your data stays with you.