102.7K+Download
Skip to the usage guide
impeccableby Paul Bakaus

Impeccable Skill.

A Claude Code and Codex skill for design review: one skill to design, critique, audit, polish, animate, and refine interfaces.

  • Design Review & Accessibility
  • UI code
Download OpenDesignView usage guide
pbakaus/impeccable · plugin/skills/impeccable/SKILL.mdSKILL.md
--- name: impeccable description: Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, … --- ## Setup ## How to design ## Modes ## Commands
Front matter and section headings read from the upstream file on 2026-09-14 · 11,912 characters in full

01 What it does

What the impeccable Skill Does in Claude Code and Codex

Summary, workflow and outputs, all read from the skill's SKILL.md.

From the SKILL.mdRead 2026-09-14 · not a recorded run

In the Skill's Own Terms

Impeccable transforms frontend interfaces through design, critique, audit, polish, animation, and refinement. It covers websites, landing pages, dashboards, product UI, components, forms, settings, onboarding, and empty states—handling UX review, visual hierarchy, accessibility, performance, responsive behavior, theming, typography, spacing, layout, color, motion, micro-interactions, and design systems.

The command workflow uses project context to guide UI creation, review and refinement. Refinement preserves the current design direction; a redesign can replace it. The source prescribes a bounded visual verification pass, not a guarantee of production quality.

What it produces

  • UI changes or review findings for the selected command and target.
  • Command-specific artifacts: PRODUCT.md through init, DESIGN.md through document, or extracted design tokens through extract—not all of these on every run.
See the example prompt ↗

How It Works

  1. 01
    Load Session Context Once

    Run the impeccable script with context argument once per session from the skill directory.

  2. 02
    Load the Request's Playbook

    For explicit or implied sub-commands, load the Commands table reference; for new surfaces or replacement visual worlds, load new-work.md.

  3. 03
    Read Craft Floor Before Editing

    After resolving analysis and direction, read craft-floor.md immediately before any UI edit, including small refinements.

  4. 04
    Choose Mode from Surface Type

    Select Persuade for landing pages and marketing where visitors decide and act. Choose Operate for app UI and dashboards where visitors complete tasks.

  5. 05
    Verify in Bounded Passes

    Build fully, inspect once with a batched round covering desktop and mobile together on web or shipped device classes on native.

02 Find your fit

When to Use the impeccable Skill

Use the impeccable skill in Claude Code or Codex when the job is design review of this kind. Fit and limits below are taken from the skill's own file.

Good Fit

  • User wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface
  • Bland designs that need to become bolder or more delightful
  • Loud designs that should become quieter
  • Live browser iteration on UI elements
  • Ambitious visual effects that should feel technically extraordinary

Know the Boundaries

  • Backend-only tasks

What to Provide

  • Target and Requested OperationIdentify the page or component and whether you want a review, a refinement or a redesign. Share existing product/design context when available; the initialization commands can help create missing context.
  • A Way to Inspect the ResultProvide a runnable project or screenshots of the relevant states when the page cannot run. Name the behaviors and design decisions that must be preserved.

03 Inside the skill

Rules the impeccable Skill Gives Claude Code and Codex

6 concrete instructions, defaults and limits the SKILL.md sets for the agent — the part of the file that changes the result.

  1. 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.

  2. Refinement Preserves; Redesign Replaces

    Refinement keeps the incumbent identity, behavior, copy, and everything outside scope.

  3. Visual Authority Is Evidence, Not a Filename

    Missing DESIGN.md alone does not make a project greenfield. The new-work playbook decides whether to preserve, expand, or replace the incumbent world based on visual evidence.

  4. Verify in Bounded Passes, Not a Loop

    The ceiling covers the whole cycle: screenshots, defect scans, micro-edits, and rebuilds.

  5. Never Repair Drift as Side Effect

    A CONTEXT_STALE directive is reported, not acted on, unless the user explicitly asks. The only exception is findings marked auto, which the next write to that file performs anyway.

  6. Launcher Failure Does Not Block Work

    On script refusal or failure, send a separate message, then read existing PRODUCT.md and DESIGN.md directly without inventing missing context.

04 Put it to work

Install impeccable in Claude Code or Codex

One npx skills add command, then a first task in your agent and a checklist for the result.

Add impeccable to Claude Code, Codex or Your Agent

Run in your project; the installer asks which agent to add it to.

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

Generic skills CLI form for plugin/skills/impeccable/SKILL.md; the repository may document its own path.

Give the Skill a First Design Review Task

Written in the skill's own terms; replace the bracketed parts with your material.

Starter prompt
Audit [src/components/SettingsPanel.tsx] for accessibility and responsive behavior, then polish the form layout and typeset the section headings to improve visual hierarchy. The panel should feel confident but scannable for users managing account preferences.

Editorial starter prompt based on the source instructions; not a recorded or tested run.

Check the First Result

What the SKILL.md itself says a correct result looks like:

  • The result addresses the named target and requested operation.
  • Refinement preserves the existing identity and copy rather than silently becoming a redesign.
  • The changed interface is inspected in its relevant states, with any unverified behavior stated explicitly.

In OpenDesign check the current skill library for impeccable. The catalog’s earlier bundling check is historical, not a guarantee that this version is preinstalled.

Download OpenDesignRead the quickstart

05 Open source, traceable

Source, License and Verification

Where this page's facts come from, and when they were last checked.

Author
Paul Bakaus
Repository
github.com/pbakaus/impeccable Branch main
Skill file
plugin/skills/impeccable/SKILL.md Content checksum recorded at verification; commit cb56ed6
License
Apache-2.0 From LICENSE; SKILL.md says “Apache 2.0”.
Repository stars
67,876 GitHub snapshot taken 2026-09-14 for the whole pbakaus/impeccable repository. Not a rating or usage count for impeccable.
Verified by OpenDesign
2026-09-14 Source file, path, license text and star count were checked. Bundled in OpenDesign main (checked 2026-08-28); a live run has not been recorded on this page.

Inside the SKILL.md

  1. SetupRun context script once per session, load playbook, read craft floor before editing
  2. How to designBrief wins, refinement preserves identity while redesign replaces, visual authority is evidence not filename
  3. ModesPersuade for landing pages, Operate for dashboards, Read for docs, Experience for portfolios
  4. CommandsTwenty-plus commands organized into Build, Evaluate, Refine, Enhance, Fix, and Iterate categories with reference files
The Skill's Own Description
“Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.”

Front-matter description from SKILL.md. The full file is about 11,912 characters. Read the full file on GitHub.

06 Before you install

Questions About the impeccable Skill

Answers come from the SKILL.md as read on 2026-09-14, not from a recorded run.

Which command should I use for my request?

If no argument is given, read routing.md and present its context-aware menu; never auto-run a command. For explicit or clearly implied requests, load the Commands table reference.

For workflow or command-selection questions, read the Workflow questions section in routing.md. Otherwise treat the request as general design work.

Impeccable

Run impeccable on a Real Design Review Task.

The impeccable skill ships inside OpenDesign. Download the app, pick the skill in Plugins → Skills, paste the prompt above, and read the plan before the result.

Download OpenDesignBrowse all skills
Terminal
npx skills add https://github.com/pbakaus/impeccable --skill impeccable