pbakaus avatar

Impeccable Skill by Paul Bakaus

  • 363k installs
  • 65.8k repo stars
  • Updated September 5, 2026

Impeccable skill is a Claude Code frontend design skill for refining polished frontend interfaces through deliberate typography, color, spacing, hierarchy, interaction, and visual-detail choices.

npx skills add https://github.com/pbakaus/impeccable --skill impeccable

Install if

Full-lifecycle UI design; brand consistency enforcement; design system development; UX/UI audit and improvement.

Skip if

Logo design (use brandkit); illustration; non-UI design; backend-only tasks.

On this page
  1. What impeccable covers
  2. impeccable by the numbers
  3. What does the Impeccable skill produce?
  4. Impeccable deep dive
  5. What files ship with impeccable?
  6. Which skills are related to impeccable?
  7. Impeccable skill FAQ

What impeccable covers

  • Covers full interface lifecycle: craft, shape, audit, polish, bolder, quieter, distill, harden, animate, colorize
  • Context-driven design via PRODUCT.md and DESIGN.md with register (brand vs product) routing
  • Anti-patterns and shared design laws enforced: no side-stripe borders, no gradient text, no glassmorphism as default

impeccable by the numbers

All-time installs362,885 (363k)skills.sh registry
Repo stars★ 65.8kGitHub
Security audit1 / 3 scanners passedskills.sh audit
Repo last updatedSeptember 5, 2026GitHub
Repositorypbakaus/impeccable ↗

Data as of Oct 27, 2026 (Skillselion catalog sync)

At a glance

What can the impeccable skill do in Claude Code?

Capabilities
craft components · shape ux · audit accessibility · optimize performance · polish visuals · add animations
Use cases
ui design · web design · frontend

What does the Impeccable skill produce?

Redesigned components, accessibility fixes, design tokens, motion polish, and launch-ready frontend code with corrected hierarchy.

  • Production-grade HTML/CSS/React code
  • Component documentation
  • Design system tokens

Deep dive: how does impeccable actually work?

Deep dive · last updated August 20, 2026 · every quote verified against pbakaus/impeccable on August 20, 2026 · How we write these

impeccable is Paul Bakaus's agent skill that hands your coding agent a design director's judgment and twenty-three named commands to apply it with. It has 362,885 installs as of October 27, 2026 (Skillselion catalog) and is one of the fastest-trending skills in search. It also has a second life: a licensed rebrand of its playbooks, published under a different name, currently out-installs the original in our own catalog.

We read the skill at commit f88b283 of pbakaus/impeccable. A sourcing note: this skill ships its SKILL.md into seventeen runtime directories, sixteen of them dot-prefixed, and our catalog's bundle holds 64 of the repository's files without the SKILL.md itself, so the walkthrough quotes the repository directly.

impeccable at a glance

  1. It gives the agent permission, not just instructions, opening with a mandate to stop hedging.
  2. It caps its own perfectionism, banning the open-ended self-QA loop that burns your money.
  3. Twenty-three commands route to twenty-three playbooks, loaded one at a time.
  4. Mode is chosen by surface, not by product, which is the distinction most design prompts miss.
  5. The brief outranks the skill's own taste, stated as a failure condition.
  6. A licensed rebrand of it out-installs it, declared inside its own bundle and invisible on both listing pages.

1. It gives the agent permission, not just instructions

Most design skills are rule lists. This one opens by changing the agent's self-image:

This skill gives you the tools and permission to create design that earns to be called out-of-distribution craft: Whereas before, your design work would have been safe, timid and measured, you now approach every design task as a award-winning design director

Source: SKILL.md, opening

"Safe, timid and measured" is an accurate diagnosis of default model output, and the fix here is a role rather than a checklist. The first core principle follows through: "Go all out. No hedging, no shortcuts."

2. It caps its own perfectionism

The third core principle is the one we would keep if we could keep only one, because it is the rule nobody writes:

Verify in bounded passes, not a loop [...] Build fully, inspect once with a batched round (desktop and mobile together on the web; the shipped device classes on a native platform), fix everything it shows in one batch, confirm with at most one more round, and stop polishing. Open-ended self-QA burns the user's money doing worse what the finish handoffs do better.

Source: SKILL.md, core principles

A skill that tells the agent to be maximally ambitious has to also tell it when to stop, or you pay for twenty screenshot rounds of diminishing returns. Naming the user's money in the file is the sort of thing you write after watching a bill.

3. Twenty-three commands route to twenty-three playbooks

The heart of the file is a command table: shape, critique, audit, polish, bolder, quieter, distill, harden, onboard, animate, colorize, typeset, layout, delight, overdrive, clarify, adapt, optimize, live, plus init, document, extract and a deprecated craft. Each row points at its own reference file, and the routing rule keeps the load small:

Explicit or clearly implied command: load its reference (native variant on native platforms) and follow it. Ask once if two commands fit.

Source: SKILL.md, "Routing"

Thin index, deep references, one playbook per task: the same architecture we found in vercel-react-best-practices and microsoft-foundry, applied to design verbs. The vocabulary is the product here. "Make it bolder" and "make it quieter" are things people actually say, and each one now has a documented procedure behind it.

4. Mode is chosen by surface, not by product

Four modes, defined by what success looks like for the visitor: Persuade, Operate, Read, Experience. The instruction that makes them work is the one about scope:

Choose the mode from the requested surface, not the product, and persist it only in that surface brief. A tool's landing page is still Persuade; a fashion house's documentation is still Read; a docs index is Read, not Persuade.

Source: SKILL.md, "Modes"

Every generic design prompt gets this wrong by inheriting the company's vibe onto every page it touches. Two examples in one sentence settle it, and the "docs index is Read, not Persuade" clause pre-empts the exact mistake an eager agent makes on a documentation homepage.

5. The brief outranks the skill's own taste

For a skill this opinionated, the deference rule matters more than the opinions:

The brief wins. Honor pinned aesthetics, eras, materials, fonts, and palettes even when they conflict with a saturated-pattern warning. Redirecting a clear brief toward your taste is failure.

Source: SKILL.md, "How to design"

Calling it "failure" rather than "discouraged" is deliberate. An agent primed to act like an award-winning director is exactly the agent most likely to override a client, and this line is the leash. The neighbouring rule draws the other hard line: refinement preserves the incumbent identity, redesign replaces it, and you never "split the difference into polish on the discarded look."

6. A licensed rebrand of it out-installs it

Here is the part you cannot see from either listing page. The skill anti-ui-slop, published under the domain uizze.com, is impeccable's playbook library under a different name. It carried 370,344 installs to impeccable's 238,573 when we checked (Skillselion catalog, August 20, 2026).

The derivation is not something we inferred. uizze declares it, in its own bundled MODIFICATIONS.md:

The Uizze skill contains renamed and product-integrated modifications of the design stack pinned at version 4.1.1, commit 5a149f3fdb1b5793f10567233b1dcab98fc305fd.

Source: anti-ui-slop MODIFICATIONS.md, shipped in the skill bundle, verified 2026-08-20

That pinned commit resolves in pbakaus/impeccable to a commit titled "Release: skill v4.1.1", and impeccable's own frontmatter reads version: 4.1.1. Direction is settled by dates too: the impeccable repository was created in November 2025, roughly nine months before the release uizze pins.

The bundled MANIFEST.json says the same in machine-readable form:

"designStack": { "version": "4.1.1", "commit": "5a149f3fdb1b5793f10567233b1dcab98fc305fd", "license": "Apache-2.0" }

Source: anti-ui-slop MANIFEST.json, shipped in the skill bundle, verified 2026-08-20

We then compared the bundles file by file, matching on exact relative path against the skill/ tree at that commit, which is the tree uizze forked. Of the 126 files uizze's manifest lists, 121 exist there at the same path. The remaining five are one-for-one renames of impeccable-prefixed filenames, keeping the extension each had upstream: four agent definitions under agents/, plus scripts/lib/uizze-paths.mjs, which is a script library rather than an agent definition. Across the 72 files our catalog now holds for both, median similarity is 99.64% and 56 are at least 99% identical. The representative case is reference/adapt.md: 312 lines on each side, with exactly one line differing. It is line 191, and the three copies read differently: the skill/ source leaves an unresolved command_prefix template in double braces ahead of impeccable polish, the built copy under plugin/ renders it as /impeccable polish, and uizze ships /uizze polish.

The front door is the real exception. uizze's own SKILL.md is substantially rewritten rather than renamed, carrying its own product policy and no Bash tooling, so "renamed" describes the playbook library behind it, not the entry point.

And the compliance is careful, more so than the word "rebrand" usually implies. The bundle ships four artifacts for it: the Apache 2.0 licence with "Copyright 2025 Paul Bakaus" intact, impeccable's own third-party NOTICE passed through unaltered, whose subject is ehmo's MIT-licensed platform-design-skills and in which "Impeccable" appears once, in a subordinate clause, the modifications notice quoted above, and a CHECKSUMS.sha256 hashing every file. Apache 2.0 permits redistribution, modification and rebranding provided the notices travel, and here they travel with room to spare. This is a lawful, attributed redistribution, and calling it theft would be wrong.

What is worth your attention is narrower. All four artifacts sit inside the downloaded bundle, where someone browsing a listing never goes, and neither product's page mentions the other. So the practical situation is simple: the rebrand out-installs the original in our catalog, the playbooks are the same, and if you already run one, installing the other buys a second copy of what you have.

Tools it drives: its own bundled scripts via npx impeccable and node .claude/skills/impeccable/scripts/*, scoped in frontmatter, including a context loader, a pin helper, and an optional post-edit design detector hook.

Behavior change, before and after:

You askWithout impeccableWith impeccable
"Make this landing page better"A safe pass over spacing and colorsA named command with a playbook, a mode chosen from the surface, and a bounded verification round
"Tone this down"Guessworkquieter, with its own reference file and a defined finish

The fine print worth knowing:

  • It runs a setup script once per session and loads a craft-floor reference before editing UI. That is real context and one shell call before any design work starts.
  • Seventeen copies of the SKILL.md ship in the repo, one per agent runtime. Convenient for compatibility, and a reason to check which copy your tool actually loaded.

Should you install impeccable?

Install it if you want an agent that argues for a point of view instead of averaging toward the middle, and the command vocabulary alone is worth it: "bolder", "quieter", "distill" and "harden" turn vague design feedback into routed procedures. Skip it if you need a fast, minimal pass on an existing look, since the setup and craft-floor loads assume real design work is about to happen. And check what you already have installed first, because you may be running a copy of it under another name.

npx skills add https://github.com/pbakaus/impeccable --skill impeccable

Quick answers

Is anti-ui-slop the same skill as impeccable?

Its playbooks are. anti-ui-slop's own MODIFICATIONS.md declares that it bundles impeccable's design stack pinned at v4.1.1, 121 of the 126 files in its manifest exist at the same paths in impeccable's skill/ tree at that commit, the other five are one-for-one renames of impeccable-prefixed filenames, and the 72 shared files our catalog holds for both run at 99.64% median similarity. Its entry-point SKILL.md is rewritten, and it ships the Apache 2.0 licence, impeccable's own third-party NOTICE passed through unaltered, a modifications notice and per-file checksums. Lawful and attributed, but installing both gets you the same playbooks twice.

What are the impeccable commands?

Twenty-three, grouped as Build (shape, init, document, extract), Evaluate (critique, audit), Refine (polish, bolder, quieter, distill, harden, onboard), Enhance (animate, colorize, typeset, layout, delight, overdrive), Fix (clarify, adapt, optimize) and Iterate (live), plus the deprecated craft alias. Each loads its own reference file on demand.

What files ship with impeccable?

SKILL.mdMarkdownGitHub ↗

name = "impeccable_asset_producer" description = "Produces clean reusable raster assets from approved Impeccable mock references without redesigning the direction." model_reasoning_effort = "medium" nickname_candidates = ["Asset Plate", "Clean Plate", "Re-Render"] developer_instructions = '''

Impeccable Asset Producer

You are the asset production agent for Impeccable craft. Your job is production cleanup, not new art direction. Work only from the approved mock, assigned crops, contact sheets, and constraints the parent gives you. Every raster you create is a raw ingredient that HTML, CSS, SVG, canvas, and component code will compose.

Core Rule

Do not redesign. Preserve the reference's visual role, silhouette, palette, lighting, material, texture, camera angle, and composition unless the parent explicitly asks for a change. Preserve perspective only when it belongs to the object or scene itself; when CSS should create the card transform, shadow, rounded clipping, border, or layout, remove that presentation chrome from the raster.

Decision Comps

Excerpt - the deep dive above quotes and explains the load-bearing lines; the full file is one click away on GitHub.

Which skills are related to impeccable?

What are the Impeccable skill forks?

Impeccable has 1 known copy in the catalog totaling 11 installs. They canonicalize to this original listing.

How does impeccable compare?

Use impeccable for full UI critique and code-level polish; use taste-only skills when you only need generation-time metric defaults.

Impeccable skill FAQ

Who is the Impeccable skill for?

Full-lifecycle UI design; brand consistency enforcement; design system development; UX/UI audit and improvement. Skip if: Logo design (use brandkit); illustration; non-UI design; backend-only tasks.

When should I use impeccable?

User needs to design, redesign, audit, or polish a frontend interface or design system.

How do I install the Impeccable skill?

Run npx skills add https://github.com/pbakaus/impeccable --skill impeccable in the project, then invoke /impeccable. If the project has no PRODUCT.md or DESIGN.md yet, the skill runs its teach pass first and writes those files before any design work.

What does the Impeccable design skill change in a project?

The Impeccable design skill edits the frontend itself - components, layout, type, colour and motion - through whichever of its ten passes you invoke: craft, shape, audit, polish, bolder, quieter, distill, harden, animate or colorize. It works from PRODUCT.md and DESIGN.md rather than a generic house style, so two projects running the same pass do not converge on the same look.

How does Impeccable know what my product should look like?

It loads PRODUCT.md and DESIGN.md from your project root, falling back to .agents/context/ and docs/, and reads the register field to decide whether design is the product (marketing, landing, portfolio) or serves it (app UI, admin, dashboards). If PRODUCT.md is missing or still holds TODO markers, it runs its teach command first and then resumes your original task.

When should I not use Impeccable?

Skip it for logo design, illustration, other non-UI design work and backend-only tasks. It covers websites, landing pages, dashboards, product UI, app shells, forms, settings, onboarding and empty states, and it expects a PRODUCT.md before it starts.

What surfaces does impeccable cover?

impeccable handles websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. It critiques and rewrites real frontend code, not slide-only mocks.

Add a impeccable badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Get the embed code

More in this repo

pbakausPolishApplies final visual and interaction refinements to a screen so a solo builder can ship a more finished look.85.2k59.7kpbakausCritiqueCritiques a user interface for hierarchy, clarity, accessibility, and polish, with concrete fixes a builder can apply.82.6k59.7kpbakausAuditAudits a user interface for visual, UX, and accessibility problems before release so a solo builder can fix them first.81.9k59.7kpbakausAnimateHelps a solo builder add purposeful motion and micro-interactions to a web interface so state changes are easier to follow.81.7k59.7kpbakausAdaptMakes an existing design work across phone, tablet, and desktop with breakpoints, fluid layouts, and touch targets.81.7k59.7kpbakausClarifyRewrites confusing UI text, error messages and labels so users know what to do next.81.2k59.7kpbakausOptimizeFinds and fixes slow load, janky animation, heavy images and large bundles in a web UI.81.1k59.7kpbakausColorizeIntroduces strategic color into a gray or monochrome interface to add warmth and energy.80.9k59.7kpbakausBolderAdds visual impact and personality to a page that looks bland, generic or too safe.80k59.7kpbakausDelightAdds micro-interactions and small moments of personality to make a functional UI enjoyable.79.8k59.7kpbakausDistillRemoves clutter from a screen so the main user goal is clear, with fewer elements and options.79.5k59.7kpbakausQuieterCalms a loud or overwhelming UI by reducing color intensity, contrast, and visual noise without losing clarity.78.7k59.7kpbakausTypesetFixes font choice, type scale, and line length so text reads clearly and looks intentional.64.7k59.7kpbakausOverdriveHelps a solo builder push a web interface toward a bolder, more striking visual result for a landing page or hero section.62.8k59.7kpbakausNormalizeBrings inconsistent spacing, type, and colors in a UI back in line with the project's design system for a solo builder.54.3k59.7kpbakausExtractHelps a solo builder pull repeated colors, spacing, and components out of an interface into reusable design tokens and components.53.2k59.7kpbakausFrontend DesignLegacy redirect skill: use /impeccable instead for all design functionality and improvements.53.2k59.7kpbakausOnboardImproves onboarding, empty states, and first-run screens so new users reach their first useful result sooner.53.1k59.7kpbakausHardenMakes a web interface sturdier by adding handling for edge cases, errors, and long or empty content a solo builder would otherwise miss.53k59.7kpbakausTeach ImpeccableDeprecated shim: redirects users to /impeccable teach command for design context gathering.50k59.7kpbakausArrangeHelps a solo builder fix spacing, alignment, and grouping in an existing interface so it reads more clearly.39.1k59.7kpbakausShapeHelps a solo builder plan the structure and layout of a screen before writing UI code, so the first version is clearer.30k59.7kpbakausLayoutFix layout, spacing, and visual hierarchy problems in frontend designs before shipping.26.4k59.7k

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.