# Impeccable

Source: https://trendhub.net/skills/pbakaus-impeccable
Repository: https://github.com/pbakaus/impeccable
Author: Paul Bakaus (https://github.com/pbakaus)
License: Apache-2.0
GitHub stars: 111,453

Impeccable is Paul Bakaus's design skill that gives a coding agent named commands for frontend work, such as bolder, quieter, polish, critique and audit, each backed by its own playbook. It keeps product and design context in PRODUCT.md and DESIGN.md and ships a rule-based detector for common AI design tells. It suits developers iterating on existing web or native app interfaces.

## What problems it solves

- **Vague requests like make it pop**: Named commands such as bolder, quieter, typeset and layout each load a dedicated playbook aimed at one target.
- **No honest review of a design**: critique scores a UI against usability heuristics and audit ranks accessibility, performance, theming and responsive issues from P0 to P3.
- **The same AI tells keep appearing**: A detector with 62 deterministic rules runs after each agent edit, in CI or from the terminal, without an LLM or API key.
- **Agents forget the product's context**: init writes PRODUCT.md and document writes DESIGN.md, and every later command reads both before editing.

## Install

### Claude Code, Cursor, Codex CLI, Copilot, Gemini CLI, OpenCode, Devin, Kiro and o

Detects your tools, asks for project or global scope and offers the design hook where supported; update later with npx impeccable update.

```
npx impeccable install
```

### Claude Code (plugin)

After adding the marketplace, open /plugin and install Impeccable.

```
/plugin marketplace add pbakaus/impeccable
```

### GitHub Copilot in VS Code

Needs VS Code 1.109.3 or later and Copilot Chat; it installs the skill without the hook.

```
code --install-extension renaissance-geek.impeccable
```

### Grok Build

Installs the skill, its agents and the hook.

```
grok plugin install pbakaus/impeccable#plugin --trust
```

### Team-pinned git submodule

Pins one version for the team; linking installs skills but not hooks.

```
git submodule add https://github.com/pbakaus/impeccable vendor/impeccable
npx impeccable link --source=vendor/impeccable --providers=claude,cursor
```

Run npx impeccable install from the project root and accept the design hook, then reload your tool and run /impeccable init once per project. Node is required only to run the installer; on first use the skill fetches a standalone engine binary into ~/.impeccable/bin.

## Skills

Skill names are shown as /name. Depending on the agent, a skill runs when it is relevant or when you call it by name; plugin installs may add a prefix.

- `/impeccable`: Routes design requests to command playbooks for planning, critique, audit, refinement, motion, copy and live variants. (https://trendhub.net/skills/pbakaus-impeccable/impeccable.markdown)

## Questions

### Is Impeccable free, and where did it come from?

It is released under Apache 2.0 and, according to the README, began from Anthropic's frontend-design skill.

### Does it work for native apps?

Yes. When PRODUCT.md names the platform as ios, android or adaptive, the commands follow Apple's HIG or Material 3, though the detector, live mode and edit hook remain web-only.

### Does it send my code anywhere?

No project files or code are sent. Starting a new design fetches visual directions from impeccable.style, and an anonymous record of the chosen direction is sent unless you turn telemetry off.

### Can I use the detector without an agent?

Yes. npx impeccable detect scans source folders or a rendered URL, outputs JSON or GitHub annotations, and exits with code 2 when it finds issues.

## Before you install

The skill edits UI files and writes PRODUCT.md, DESIGN.md and an .impeccable/ folder, runs a downloaded engine binary, and installs an edit hook that runs outside model approval in Claude Code. Live mode serves an overlay on your dev server and, if no chat agent is polling, can run the codex or claude CLI with approvals and sandboxing turned off; new designs fetch directions from impeccable.style with optional telemetry.
