# Impeccable

Impeccable is a skill by Paul Bakaus that gives coding agents design vocabulary and audit commands for polishing an interface.

Skill · Picked · by Paul Bakaus · Works with Claude Code, Cursor, Codex, Gemini CLI · Updated 2026-10-21

Made by [Paul Bakaus](https://github.com/pbakaus). Source: [github.com/pbakaus/impeccable](https://github.com/pbakaus/impeccable) · Apache-2.0 license. The text below is Lior's notes on why and how he uses it; the original files live at the source.

## Install

```sh
npx impeccable install
```

## Verdict

Score: 7/10 · Tested 2026-10-21 · v4.2.0

The one design skill in my tests that checks its own work: it removed template habits and fixed what its checker flagged. It also takes longer, and it needs its own program to run.

### Pros

- Ran its checker on the page, fixed what it found, and ran it again to confirm.
- Removed template habits instead of adding effects: gradient text, labels above headings, emoji used as icons.
- Reorganized the main body well: the three icon cards became alternating rows, each feature's text beside a picture of it working (widgets, a 20-week heatmap, two notifications).
- Kept the existing look, copy and prices. It polished the page, it didn't replace it.
- Works across Claude Code, Cursor, Codex, Gemini CLI and more, and is free under the Apache-2.0 license.

### Cons

- Took 3.8 minutes and $0.86, against 2.4 minutes and $0.68 without it.
- Needs its own engine program, downloaded on first run. With that blocked it fell back to instructions only and produced a very different, full redesign.
- Results vary between runs more than with the other skills I tested.

Best for: The last pass on a page that works but looks generic.

Skip it if: You can't let your agent run downloaded programs.

## The test

Task (same for both runs): Improve the design of the landing page in index.html. Edit the file in place. Both runs started from the same page: the one built without a skill in the ui-ux-pro-max review.

### Without the skill

2.4 min · $0.68

![Streak page polished without the skill: dark theme with added glows, avatar row, and floating cards beside the phone, one covering the date](https://www.liorpesoa.com/library/reviews/impeccable/without-desktop.webp)

![Streak page polished without the skill: dark theme with added glows, avatar row, and floating cards beside the phone, one covering the date (phone)](https://www.liorpesoa.com/library/reviews/impeccable/without-mobile.webp)

Page: https://www.liorpesoa.com/library/reviews/impeccable/without.html

### With impeccable

3.8 min · $0.86

![Streak page polished with the skill: same dark theme, solid orange headline in a new typeface, no floating cards, a clean phone mockup](https://www.liorpesoa.com/library/reviews/impeccable/with-desktop.webp)

![Streak page polished with the skill: same dark theme, solid orange headline in a new typeface, no floating cards, a clean phone mockup (phone)](https://www.liorpesoa.com/library/reviews/impeccable/with-mobile.webp)

Page: https://www.liorpesoa.com/library/reviews/impeccable/with.html

### What I found

- Without the skill, "improve the design" meant adding effects: glows, a grid, floating cards and an avatar row. One floating card covers the date on the phone mockup.
- With it, the agent ran the skill's checker, removed template habits, changed the type and fixed every flagged issue except four it explained.
- The main body is where it helped most: the features moved from three identical cards to alternating rows of text and a working example, which reads far better.
- In an earlier run where the skill's engine was blocked, it instead rebuilt the page as a light wall-calendar design, so the engine matters.

_How I ran it: Claude Code 2.1.306 with Claude Opus, run headless twice with only Claude Code's built-in skills loaded (no user skills, plugins or MCP servers). The second run had impeccable installed in the project and its prompt started with "Use the impeccable skill." The run with the skill was also allowed to run the skill's own engine. Screenshots taken in Chrome at 1440×900 and 390×844._

## Questions

### Who made impeccable?

Paul Bakaus. It's published at github.com/pbakaus/impeccable under the Apache-2.0 license.

### How do I install impeccable?

From your project root, run:

```sh
npx impeccable install
```

Then, inside your coding agent, run:

```sh
/impeccable init
```

### Does impeccable download anything?

Yes. Its launcher downloads the Impeccable engine once, on first run, unless the engine already sits next to it.

## Related

- [Frontend Design](https://www.liorpesoa.com/library/frontend-design.md)
- [UI UX Pro Max](https://www.liorpesoa.com/library/ui-ux-pro-max.md)
- [Design Crit](https://www.liorpesoa.com/library/design-crit.md)

## Credit

Paul Bakaus · [github.com/pbakaus/impeccable](https://github.com/pbakaus/impeccable) · Apache-2.0 license

---

Page: https://www.liorpesoa.com/library/impeccable
Library: https://www.liorpesoa.com/library
