Skip to content
Impeccable

Impeccable Skill

Paul Bakaus' frontend design skill: one entry point with over 20 commands to shape, critique, audit, polish, animate and harden websites, app UI and design systems, guided by product context in PRODUCT.md and DESIGN.md.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from pbakaus/impeccable.

$ npx skills add pbakaus/impeccable --skill impeccable

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

Copy the whole skill folder — SKILL.md and any scripts or references beside it — into ~/.claude/skills/impeccable/, where Claude Code picks it up in every project. Only git is needed.

tmp=$(mktemp -d) && \
  git clone --depth 1 --branch main https://github.com/pbakaus/impeccable.git "$tmp" && \
  mkdir -p ~/.claude/skills && \
  cp -R "$tmp"/.claude/skills/impeccable ~/.claude/skills/impeccable

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/impeccable/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Over 20 sub-commands across build, evaluate, refine, enhance, fix and iterate
  • Four surface modes (Persuade, Operate, Read, Experience) that set the level of ambition
  • Loads PRODUCT.md, DESIGN.md and surface briefs through a bundled launcher
  • Live browser mode for picking elements and generating variants
  • Optional design-detector hook that flags issues after UI edits

Impeccable is a frontend design skill by Paul Bakaus that asks the agent to work like an award-winning design director: production-grade code, a clear point of view and a finished deliverable rather than a hedge. It covers websites, landing pages, dashboards, app UI, components, native iOS and Android screens, and design systems documented in a DESIGN.md.

Everything routes through a single /impeccable command with more than twenty sub-commands, each backed by its own reference file. Build commands include shape (plan the UX before coding), init (capture product context in PRODUCT.md), document (generate DESIGN.md from existing code) and extract (pull out reusable tokens and components). critique and audit evaluate a target with heuristic scoring or technical checks for accessibility, performance and responsiveness. Refinement and enhancement commands such as polish, bolder, quieter, distill, harden, animate, colorize, typeset, layout and delight each change one dimension, while clarify, adapt and optimize fix copy, device fit and performance. live and generate iterate on variants in the browser. Called with no argument, it shows a context-aware menu instead of guessing.

Two ideas set it apart. First, it scales ambition to the surface: Persuade (marketing and pricing) and Experience (portfolios) get bold, committed work, while Operate (app UI and dashboards) and Read (docs and articles) show craft through precision and restraint. The mode comes from the surface, not the product, so a developer tool's landing page is still Persuade. Second, it separates refinement from redesign: refinement preserves the existing identity and copy, and redesign replaces the look wholesale rather than polishing a discarded one. Before any UI edit it reads a craft-floor reference of quality minimums and absolute bans, and it checks results by looking at the rendered output at real sizes.

A bundled launcher, a self-contained binary that needs no Node runtime, loads the project's context once per session. Optional hooks run a design detector after UI file edits. Apache-2.0.

SKILL.md

The instructions your agent loads, as published by Paul Bakaus.

SKILL.md
name
impeccable
description
Use to design, redesign, critique, audit, polish or animate a frontend: websites, landing pages, dashboards, app UI, components, native iOS/Android screens, or a design system (DESIGN.md).
version
4.8.2
user-invocable
true
argument-hint
[shape · audit|critique · animate|bolder|colorize|delight|layout|overdrive|quieter|typeset · adapt|clarify|distill · harden|onboard|optimize|polish · init|document|extract|live|generate] [target]
license
Apache 2.0

This skill gives you the tools and permission to make design that earns the name out-of-distribution craft. Work as an award-winning design director would: production-grade code, a clear POV, a deep grasp of what the client and its users need, and exceptional craft.

Core principles:

  • Finish the job. No hedging, no shortcuts: the deliverable is complete, except assets the user must provide.
  • Scale ambition to the surface's mode (see Modes). Persuade and Experience get full commitment: bold, distinct work with a point of view. On Operate and Read, ambition shows as precision and restraint, and patterns the visitor already knows earn their place.
  • Verify by looking at the rendered result at the sizes it ships at, and batch the checks: fix what one look shows before looking again, rather than screenshotting after every tweak.
Setup
  1. Run <skill-base-dir>/scripts/impeccable context once per session, where <skill-base-dir> is the directory that contains this SKILL.md (the skill folder, not a plugin root two levels above it); keep cwd at the user's project. That base directory resolves every .claude/skills/impeccable/scripts/impeccable <verb> command in this skill and its references, and .claude/skills/impeccable/scripts is the fallback only when the runtime reports no base directory. On a Windows shell without sh, call .claude/skills/impeccable/scripts/impeccable.cmd instead. The launcher runs a self-contained binary that ships next to it or is downloaded once on first run; no Node or other runtime is required. Pass a named source file or route as --target <path>. It loads PRODUCT.md, DESIGN.md, the matching surface brief, and native-platform guidance when applicable; follow its directives and do not rerun it.
  2. Load the request's playbook: its Commands-table reference for an explicit/implied sub-command, or [reference/new-work.md](reference/new-work.md) for a new surface or replacement visual world. Inspect target and incumbent visual truth before editing. When the app cannot run, start with committed visual-regression goldens or screenshot fixtures; verify target and freshness against current tokens, CSS, components, or assets, resolve conflicts, and compare theme/variant captures.
  3. After resolving analysis and direction, read [reference/craft-floor.md](reference/craft-floor.md) immediately before any UI edit, including small refinements. It carries the quality floor, the absolute bans, and the reflexes no detector catches. Do not load it for planning-only work.

Launcher unavailable: On refusal or failure, send a separate message before the next tool call: “Context loading did not run; I’ll read the existing project context directly.” Then read existing PRODUCT.md and DESIGN.md without inventing missing context, follow applicable steps 2–3, including reading [reference/craft-floor.md](reference/craft-floor.md) immediately before any UI edit, and continue through permitted tools. This applies to planning and editing; launcher failure alone does not block either.

How to design
  • 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.
  • Refinement preserves; redesign replaces. Refinement keeps the incumbent identity, behavior, copy, and everything outside scope. Ask before replacing factual copy or adding claims. Redesign keeps product truth, content, function, native affordances, and constraints, but treats the old look as evidence and anti-reference; choose a replacement world in new-work and replace DESIGN.md. Never split the difference into polish on the discarded look.
  • Loaded symbols stay out of the decoration. A subject's world does not license emblems tied to militarism, supremacy, or hate movements as motifs, badges, or ornament, such as the Rising Sun flag's rays, the Confederate battle flag, or Nazi-era insignia and their stylised variants; reach for that world's neutral forms instead. Content that documents such a symbol as fact stays as it is.
  • Visual authority is evidence, not a filename. Missing DESIGN.md alone does not make a project greenfield; new-work decides whether to preserve, expand, or replace the incumbent world.
Modes

The mode names what the visitor's success looks like on this surface.

  • Persuade: the visitor decides and acts; design is the product. Landing pages, marketing, campaigns, pricing. Earn attention and action. Ship real imagery when the brief needs it; follow the committed world, not category habit.
  • Operate: the visitor completes a task. App UI, dashboards, editors, admin, settings, tools. Scanability, consistency, native expectations, and the real usage scene outrank expression. Brand lives in precise details.
  • Read: the visitor understands something. Docs, articles, guides, help, changelogs. Structure for comprehension, then make the reading experience worth staying in.
  • Experience: the visitor is inside the work itself. Portfolios, galleries, showcases. Let the artifact lead from the first viewport; the interface recedes.

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. See [new-work.md](reference/new-work.md) for new surfaces and [operate.md](reference/operate.md) for deeper Operate/Read guidance.

Commands
CommandCategoryDescriptionReference
craft [feature]BuildDeprecated alias for an ordinary new-work request[reference/craft.md](reference/craft.md)
shape [feature]BuildPlan UX/UI before writing code[reference/shape.md](reference/shape.md)
initBuildCapture durable product context in PRODUCT.md[reference/init.md](reference/init.md)
documentBuildGenerate DESIGN.md from existing project code[reference/document.md](reference/document.md)
extract [target]BuildPull reusable tokens and components into design system[reference/extract.md](reference/extract.md)
critique [target]EvaluateUX design review with heuristic scoring[reference/critique.md](reference/critique.md)
audit [target]EvaluateTechnical quality checks (a11y, perf, responsive)[reference/audit.md](reference/audit.md) · native: [reference/audit.native.md](reference/audit.native.md)
polish [target]RefineFinal quality pass before shipping[reference/polish.md](reference/polish.md)
bolder [target]RefineAmplify safe or bland designs[reference/bolder.md](reference/bolder.md)
quieter [target]RefineTone down aggressive or overstimulating designs[reference/quieter.md](reference/quieter.md)
distill [target]RefineStrip to essence, remove complexity[reference/distill.md](reference/distill.md)
harden [target]RefineProduction-ready: errors, i18n, edge cases[reference/harden.md](reference/harden.md)
onboard [target]RefineDesign first-run flows, empty states, activation[reference/onboard.md](reference/onboard.md)
animate [target]EnhanceAdd purposeful animations and motion[reference/animate.md](reference/animate.md)
colorize [target]EnhanceAdd strategic color to monochromatic UIs[reference/colorize.md](reference/colorize.md)
typeset [target]EnhanceImprove typography hierarchy and fonts[reference/typeset.md](reference/typeset.md)
layout [target]EnhanceFix spacing, rhythm, and visual hierarchy[reference/layout.md](reference/layout.md)
delight [target]EnhanceAdd personality and memorable touches[reference/delight.md](reference/delight.md)
overdrive [target]EnhancePush past conventional limits[reference/overdrive.md](reference/overdrive.md)
clarify [target]FixImprove UX copy, labels, and error messages[reference/clarify.md](reference/clarify.md)
adapt [target]FixAdapt for different devices and screen sizes[reference/adapt.md](reference/adapt.md) · native: [reference/adapt.native.md](reference/adapt.native.md)
optimize [target]FixDiagnose and fix UI performance[reference/optimize.md](reference/optimize.md)
liveIterateVisual variant mode: pick elements in the browser, iterate on alternatives[reference/live.md](reference/live.md)
generate [n] [action] [element]IterateVariants, versions, or alternatives of a named element to choose from in the live browser; no manual picking[reference/generate.md](reference/generate.md)

Routing:

  • No argument: read [routing.md](reference/routing.md) and present its context-aware menu; never auto-run a command.
  • Explicit or clearly implied request to run a command: load its reference (native variant on native platforms) and follow it. Ask once if two commands fit.
  • Workflow or command-selection question: read [Workflow questions](reference/routing.md#workflow-questions).
  • Otherwise: treat the request as general design work. Missing PRODUCT.md routes a new surface or replacement world through init, then new-work; a narrow refinement of existing code proceeds on the incumbent implementation as impeccable context directs, offering init afterward rather than blocking on it.
  • teach aliases init. craft is a deprecated alias for ordinary new-work and adds nothing. shape owns task discovery, then enters new-work only for visual-world and surface-concept decisions.

After init writes PRODUCT.md, resume without rerunning impeccable context; init loads the native platform reference itself when the platform it recorded is ios, android, or adaptive.

Pin / Unpin: .claude/skills/impeccable/scripts/impeccable pin <pin|unpin> <command> creates or removes a standalone /<command> shortcut. Report the script's result concisely; relay stderr verbatim on error.

Hooks: /impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> manages the design detector hook for this project (auto-runs the detector after UI file edits and surfaces findings). Load [reference/hooks.md](reference/hooks.md) when the user invokes it with any argument.

Doctor: /impeccable doctor reports and repairs drift between this project's Impeccable artifacts (PRODUCT.md, DESIGN.md and its sidecar, config, surface briefs, the hook) and what this version reads. Load [reference/doctor.md](reference/doctor.md) when the user invokes it, or when they ask what is out of date, stale, or needs refreshing. A CONTEXT_STALE directive in Setup's output is the cheap subset of the same report; act on it there per its own instructions rather than running doctor unasked.

Never repair drift as a side effect of a design task. A CONTEXT_STALE finding is reported, not acted on, unless the user asks. The one exception is a finding marked auto, which the next write to that file performs anyway.

Install

Skill: Review Animations

by Emil Kowalski

New

Emil Kowalski's animation review skill: audits motion code against ten non-negotiable standards (easing, sub-300ms UI, origin, interruptibility, GPU-only properties, reduced motion) and ends with Block or Approve.

Skill: Anti-Slop Design

by Ferousco-dev

Featured

Stops AI-generated UI from defaulting to purple gradients and templated hero sections by forcing a named design direction first.

155 views 30 copies
New

Addy Osmani's skill for building production-quality, accessible, responsive interfaces: component architecture, the simplest workable state, design-system adherence, a list of AI-aesthetic defaults to avoid, WCAG 2.1 AA and a verification checklist.

Browse all skills →