pbakaus /
impeccable
A design skill for AI coding agents that steers them away from generic frontend looks
- 85k stars
- 11.2k stars since 3 Oct
- Rust
- Updated today
- Beginner friendly
- Agent skills & plugins
AI models trained on similar SaaS templates tend to produce the same frontend look: Inter for every font, purple-to-blue gradients, cards nested in cards, gray text on colored backgrounds. Impeccable gives your coding agent explicit design guidance so it avoids these habits.
It installs as a single skill called /impeccable. You run /impeccable init once, and it inspects your project and writes a PRODUCT.md file with lasting facts about your audience, purpose and constraints. After that, you run commands like /impeccable audit or /impeccable polish on a page or component, and the agent follows the guidance.
It started from Anthropic's frontend-design skill for Claude and extends it with a shared command vocabulary and a detector. The CLI and browser extension run 61 deterministic rules without an LLM or API key. Other checks are done by the LLM as part of critique.
What it does
One skill, 24 commands
Commands include craft, shape, critique, audit, polish, distill, harden, animate, typeset and layout. All run through /impeccable, and you can pin one as its own shortcut, such as /audit.
Project setup with PRODUCT.md
/impeccable init inspects the project, asks only about missing facts, and records audience, purpose, voice and constraints in PRODUCT.md. DESIGN.md can be generated from existing code with /impeccable document.
Deterministic detector rules
61 rules flag common AI design tells. The CLI and browser extension run them with no LLM and no API key.
Live browser iteration
The live and generate commands let you iterate on a named element in the browser and compare variants.
Wide tool support
The installer detects tools such as Claude Code, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, Grok Build and Hermes Agent. It also offers submodule, plugin and manual copy installs.
What you could build
- Audit an existing page for accessibility, performance and responsive problems.
- Run a critique on a landing page to review hierarchy and clarity before launch.
- Plan and build a new interface with the shape and craft flow instead of prompting from scratch.
- Harden a checkout form against edge cases, text overflow and error states.
- Check AI-generated frontend code for common design clichés using the detector rules.
Get started
From your project root, run the installer and pick your AI tool and whether to install per project or globally. Reload your tool, then run /impeccable init to create PRODUCT.md and try a command like /impeccable audit.
npx impeccable install/impeccable initnpx impeccable updateCommands are copied from the project's README. Read it on GitHub for the full setup.
Anything better than impeccable?
Impeccable is a strong pick for fixing generic AI frontends, with the most active command set (audit, critique, polish) and deterministic detector rules. Look at taste-skill or hallmark if you prefer a different design philosophy or per-brief theming.
-
taste-skillAlternative
Choose it if you want plain design rules for layout, type and motion plus image-generation skills for reference boards, rather than a command-driven workflow.
Trade-off: You get no deterministic detector rules or audit/critique commands, so enforcement relies on the agent following the guidance.
-
hallmarkAlternative
Choose it if you want the agent to pick a page structure and theme per brief, then check the result against 57 anti-pattern gates.
Trade-off: It is aimed at generating web pages and sites, with fewer commands for iterating on an existing interface, and it has a smaller community.
-
awesome-design-skillsUse alongside
Pair it with Impeccable to give the agent a concrete visual style from 67 ready-made systems, while Impeccable catches generic tells.
Trade-off: Each system is a fixed starting style that you must choose and maintain, and the registry is much smaller and less active.
-
awesome-design-mdUse alongside
Use it with Impeccable to copy a known site's DESIGN.md as the style target while Impeccable audits and polishes the output.
Trade-off: These are static style references that imitate existing brands, with no checks or commands, and copying a brand's look can raise originality concerns.
More in Agent skills & plugins
superpowers
A set of skills that makes coding agents plan, test and review before they write code
mattpocock/skills
Small, editable agent skills for planning, testing and reviewing code with AI
ECC
Agents, skills, hooks and memory that add an engineering workflow to coding agents
andrej-karpathy-skills
A CLAUDE.md file that tells Claude Code to ask first, keep code small, edit narrowly
anthropics/skills
Anthropic's example Agent Skills: folders of instructions Claude loads per task
ponytail
A skill that makes AI coding agents write the least code that works
gstack
Slash-command skills that give Claude Code roles like reviewer, QA and release engineer
addyosmani/agent-skills
A pack of 25 Markdown skills that guide AI coding agents from spec to ship
taste-skill
Agent skills that steer AI coding tools toward better layout, type and motion
archify
Agent skill that turns a description or a codebase into an interactive HTML diagram