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
  1. What Impeccable is
  2. Impeccable commands
  3. How to install Impeccable in Claude Code
  4. The detector and what to watch out for

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.

GroupCommands
Steerbolder, quieter, distill, colorize, typeset, layout, animate, delight, overdrive
Reviewcritique, audit
Finishpolish, harden, clarify, adapt, optimize, onboard
Iterate livelive, generate
Plan and set upshape, 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.

bash
npx impeccable install

The 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/impeccable

The 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.

bash
npx impeccable detect src/
npx impeccable detect http://localhost:5173

A 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.

When is the best time to call?
Controller: Oleksandr Bondarenko (BondSoft)Privacy PolicyTerms of Service
Legal details

The data controller is Oleksandr Bondarenko, trading as Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, Poland, NIP 5833576264, e-mail: office@bondsoft.pl.

We process your data solely to contact you about your enquiry and to present an offer — on the basis of your consent (Art. 6(1)(a) GDPR and Art. 398 of the Polish Electronic Communications Law) and our legitimate interest in handling the enquiry (Art. 6(1)(f) GDPR).

Providing the data is voluntary but necessary for us to reply. You may withdraw your consent at any time by writing to office@bondsoft.pl — this does not affect the lawfulness of processing before the withdrawal.

You have the right to access your data, rectify it, erase it, restrict its processing, transfer it, and lodge a complaint with the President of the Polish Personal Data Protection Office.

Full information: Privacy Policy.

Send us an email

The service this text is about

Automation and AI / OCR

Automation of document re-typing, OCR and checking rules, and your data stays with you.