mrkeyoor.com_
Sat 31 Oct 02:49 UTC
AI Toolsevaluationupdated 02 Oct 2026

impeccable review

Impeccable is a design skill and command set for AI coding tools such as Claude Code, Codex, Cursor, and Gemini CLI. It gives an agent a shared design vocabulary, stores product context in project files, and can check rendered interfaces for recurring visual and accessibility mistakes.

+9,361stars / 7d
Verdict

Our Impeccable run built in 11 seconds, but 1 of 449 tests failed, so I would use its design guidance while keeping live edits behind Git review. Its 24 commands and 61 detector rules give agent-heavy frontend work a much better vocabulary than a loose request to make a page look good. Skip live mode on a dirty worktree, and verify important detector findings in the browser.

We ran it

Lab card: what happened when we ran impeccableScreenshot of impeccable (impeccable.style)
Install✓ · 56s229 packages · 616 MB
Build✓ · 11s
Tests✗ · 13s448 passed · 1 failed of 449 (bun test)
Repo3287 files~489,024 lines of source · 68.3 MB · 4 CI workflows · tests dir

Answers from our run

Does impeccable build from source?

Dependencies installed in 56 seconds (229 packages), and the build succeeded in 11 seconds. We cloned commit c74755d into a clean Debian container with 3 CPUs and no project-specific setup.

Do impeccable's tests pass?

No. The project's own test command finished in 13 seconds and reported 448 passed, 1 failed (bun test).

Who should not use impeccable?

Teams that need a clean test gate before adoption: our run ended with 448 passing tests and 1 failure.

What are the alternatives to impeccable?

Anthropic Skills, UI UX Pro Max Skill, Stitch Skills. Our Impeccable run built in 11 seconds, but 1 of 449 tests failed, so I would use its design guidance while keeping live edits behind Git review.

Setup4/556-second install, clear setup, but hooks need host-specific trust
Docs5/5Detailed paths for agents, hooks, live mode, and detector use
Community5/573,792 stars and active issue and pull request work on October 2
Maturity4/5Broad tooling and releases, with 1 failed test in our run

Who it’s for

Developers who use an AI coding agent to build or revise production interfaces.
Product teams that want design intent stored in PRODUCT.md and DESIGN.md instead of repeated in every prompt.
Frontend engineers willing to review generated edits and treat detector output as one input, not a final approval.
Claude Code, Codex, Cursor, Gemini CLI, or Copilot users who want one design workflow across several agents.

Who it’s NOT for

Teams that need a clean test gate before adoption: our run ended with 448 passing tests and 1 failure.
Windows Codex users expecting hooks to work without inspection: open issue 848 reports that PowerShell cannot parse the installed cmd.exe hook syntax.
Anyone planning to let live mode edit an uncommitted worktree: issue 875 reports a discard path deleting the original JSX element after a manual wrapper fallback.
Teams that will read a zero-result source scan as proof of quality: issue 884 shows several rules missing byte-identical markup in Astro, JSX, Svelte, and Vue files that fired for HTML.
Designers looking for a visual authority they do not have to supervise: the README says a clean detector run is evidence, not proof, and tells users to inspect relevant viewports.

Setup reality

Our sandbox installed commit c74755d with Bun in 56 seconds, adding 229 packages and using 616 MB. The build passed in 11 seconds. The test command failed after 13 seconds: 448 tests passed and 1 failed out of 449, while the supplied log tail did not name the failing case.

The usual installer is npx impeccable install, followed by /impeccable init inside a supported coding tool. The detector itself needs no API key, but hooks require workspace trust or approval in several hosts, and live mode needs a local development server.

The launcher may download a pinned engine binary on first run. Codex users must approve the project hook, framework source scans can have reduced coverage, and the README limits live editing to trusted local projects rather than deployed production sites.

One skill turns 24 design actions into a shared workflow

Impeccable gives an AI coding agent 24 named design actions, including shape, critique, audit, polish, harden, and adapt. That naming matters. Asking an agent to "improve the UI" leaves composition, accessibility, copy, and resilience tangled together. A command such as /impeccable harden checkout puts the work inside a narrower box: error states, text overflow, localization, and edge cases. The agent still makes judgments, but you can tell which kind it is supposed to make.

The first command, /impeccable init, records durable product facts in PRODUCT.md. An existing visual system can live in DESIGN.md, while individual surfaces get their own direction. This is the strongest part of the project. It separates who the product serves from how one screen should look, so a later polish pass has more than the current DOM and a vague prompt to work from.

The detector has 61 rules, but zero findings is not a guarantee

The standalone detector checks 61 deterministic rules without sending code to an LLM or requiring an API key. It can scan a source directory, one file, or a rendered URL. The rules cover familiar AI-made patterns, such as gradient text and nested cards, along with smaller touch targets, cramped padding, skipped headings, and long lines. A JSON mode makes the result usable in CI.

Coverage depends on the input. Open issue 884 feeds byte-identical markup to HTML, Astro, JSX, Svelte, and Vue files. Three rules fire on the HTML file, while only the gradient rule fires on the other four. The report also describes an Astro source scan returning zero findings before a browser scan caught small text. Impeccable's own README gives the right interpretation: a clean scan is evidence, not proof. Scan source for fast feedback, then scan the built page and inspect it yourself.

What happened when we ran it

Our sandbox installed commit c74755d in 56 seconds with Bun. The checkout held 3,287 files, roughly 489,024 lines of source, and occupied 68.3 MB. Installation added 229 packages and expanded the environment to 616 MB. The build then completed successfully in 11 seconds on 3 CPUs with 8 GB of RAM, without secrets or elevated privileges.

The test command failed after 13 seconds. Bun reported 448 passed and 1 failed out of 449 tests across 17 files. The log tail lists a series of passing Test Provider cases, then says one test failed. It does not name that test or show its assertion, so the failure is real but its cause is not available in the supplied evidence. The repository has 4 CI workflow files and a tests directory, but no Dockerfile.

Those results put the setup in an awkward middle. The install and build are straightforward, and nearly the whole suite passed. A team with a strict green-suite rule still has to stop at the same place we did, reproduce the failure, and identify it before pinning commit c74755d. Calling 448 passes good enough would quietly change the release standard.

Live mode can change source files, so use a clean commit

Live mode lets you pick an element in the browser, generate variants, and accept an edit back into the source. That is more useful than a static prompt when spacing or visual weight needs several rounds. It also crosses a serious boundary: the design assistant can write to the checkout. The README limits this feature to trusted local projects and says its optional validation command runs with your user permissions.

Issue 875 gives that warning a concrete shape. In the reported React case, live mode could not locate a multiline JSX input. After the user applied the documented manual wrapper fallback, discarding the variant removed the original input block instead of restoring it. The issue's workaround is sensible: begin with a clean committed tree and inspect the diff after a discard. I would add live mode only after the instruction-only workflow proves useful.

Agent support is broad, while hook trust stays host-specific

The installer targets Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Grok Build, Hermes, and several other agents. It can install per project or globally, and the repository also documents manual copies and a Git submodule route. The launcher runs a self-contained engine binary, downloading the pinned build once when it is absent. Node is needed for the npx installer, not for every hook run.

Each host still has its own approval model. Codex asks you to approve the project hook after installation or an update. Cursor can run checks before edits land, while several other hosts report findings afterward. Windows deserves extra caution: issue 848 reports that Codex sessions using PowerShell cannot parse the installed cmd.exe hook command, so both edit and stop hooks fail on every trigger in that environment.

An October 2 push and release show fast maintenance

GitHub recorded a push on October 2, 2026, the same date as release skill-v4.5.0. The release addressed linked-worktree ignore placement, live-mode checkpoint order, an unresolved CSS padding false positive, and image handling inside SVG definitions. GitHub also listed 52 combined issues and pull requests and 73,792 stars that day. That is an active project with a busy defect queue, not a settled utility.

Impeccable is most convincing as a shared language and review layer for developers already using coding agents. Its files make design intent persistent, and its commands turn an open-ended visual request into work you can inspect. The detector and live editor need human checks for different reasons: one can miss framework-source problems, while the other can alter source. Keep those boundaries, and the project earns a place beside your agent rather than authority over your interface.

Alternatives

ProjectWhat it isPick it when
Anthropic Skills gh↗Anthropic's public collection includes the frontend-design skill that Impeccable started from.pick this instead when you want a smaller, instruction-led starting point without Impeccable's live editor and detector engine.
UI UX Pro Max Skill gh↗A design-reference skill with searchable guidance for interfaces across several frameworks.pick this instead when you mainly want design patterns and framework guidance inside an agent.
Stitch Skills gh↗Agent skills that connect supported coding tools to Google's Stitch MCP design workflow.pick this instead when Stitch-generated screens and its MCP server are already part of your process.

What people are saying

  1. [github-trending] pbakaus/impeccable

Sources

  1. Impeccable repository
  2. Impeccable README
  3. Impeccable Skill 4.5.0 release
  4. Framework source scan coverage issue
  5. Live mode restore issue
  6. Windows Codex hook issue

More ai tools reviews

KiroCrew · Orkas · hypit · Paradev · see-through · Resume-Matcher · the whole board →