About impeccable
impeccable is an agent skill for UI/UX design work, aimed at product and design teams planning, reviewing, and refining interfaces. Its commands cover design critique, accessibility, performance, and responsive checks, while PRODUCT.md provides persistent product context.
Key features
- 01Plan UX/UI and capture product context
- 02Review designs with heuristic scoring
- 03Audit accessibility, performance, and responsiveness
- 04Refine interface design by focus area
- 05Detect design anti-patterns
Use cases
- 01Plan an interface before UI implementation
- 02Check design and technical quality of an existing interface
- 03Generate design documentation for a product
- 04Iterate on specific interface elements
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/impeccablein Claude Code to confirm it loaded.
Bundled filesstub.yaml
Details
From the project READMEimpeccable
Catalogue stub — full skill: pbakaus/impeccable
Decision tree
-
Is the full skill already installed?
- Global:
f=~/.agents/skills/impeccable/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer" - Project:
f=.agents/skills/impeccable/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer" installed→ the skill is installed asimpeccable, invoke it and proceedpointer→ go to step 2
- Global:
-
Detect scope, then install:
[ -e ~/.agents/skills/impeccable ] && echo "global" || echo "project"Global:
npx skills add pbakaus/impeccable --skill impeccable -g -yProject:
npx skills add pbakaus/impeccable --skill impeccable -yClaude Code: send a command as a chat message starting with
!to run it without leaving the conversation.
Claude Code plugin route:
/plugin marketplace add pbakaus/impeccable
/plugin install impeccable@impeccable
Heads-up
- Requires: the skill's launcher (scripts/impeccable) downloads a native engine binary to ~/.impeccable/bin on first run; anonymous usage telemetry is on by default (opt out with IMPECCABLE_NO_TELEMETRY=1 or DO_NOT_TRACK=1)
- License: Apache-2.0
- Large download (~854 MB): the skills CLI gives up cloning after 300 s; if it times out, retry with
SKILLS_CLONE_TIMEOUT_MS=900000.
Invoke after install
- Skill name:
impeccable - Run
/impeccable <command> <target>, and/impeccable initonce per project to capture PRODUCT.md - Restart your agent session after installing so the skill and commands load
npx skills add installs the skill only. Upstream's own installer (npx impeccable install) also registers edit hooks that run the design detector after UI file edits; review those hooks before using it.
What it does
A single skill whose commands are invoked as /impeccable <command>:
| Command | Purpose |
|---|---|
shape | Plan UX/UI before writing code |
init / document | Capture product context (PRODUCT.md) and generate DESIGN.md from existing code |
critique | UX design review with heuristic scoring |
audit | Technical quality checks (accessibility, performance, responsive) |
polish | Final quality pass before shipping |
bolder / quieter / distill | Amplify, calm down, or simplify a design |
animate / colorize / typeset / layout / delight | Targeted enhancement passes |
harden / onboard / clarify / adapt / optimize | Edge cases, first-run flows, UX copy, responsiveness, performance |
live / generate | Pick elements in the browser and iterate on variants |
| + more | See the upstream README and the skill's command table |
It also ships a detector for design anti-patterns that can run from the command line. Commands read PRODUCT.md for durable product context; missing it, the skill runs init for a new surface rather than guessing.
When NOT to use
- Backend, API, or data-pipeline work
- Non-UI tasks (routing, auth, database)
- Deep color-science work such as OKLCH palette generation (use
color-expert)