Impeccable

Description

Impeccable is an open source design vocabulary for AI coding agents. It ships as a single skill with a set of commands and curated anti-patterns that give agents the missing language for high-quality frontend design, so generated interfaces respect your design system and real product context rather than shipping generic AI slop.

It works across popular AI harnesses including Cursor, Claude Code, GitHub Copilot, Gemini CLI, and Codex CLI. The skill is recompiled per target, and builds for models with known tells carry extra rules that ban that model's habits, such as killing image-on-hover motion or refusing ghost-cards and over-rounding. Context travels as DESIGN.md and PRODUCT.md files, which are never overwritten on update.

Instead of picking a command, you can simply describe what you want and Impeccable works out the kind of job, such as a blank slate, a new page in an existing product, an addition, a redesign, or a scoped refinement, and gives each the right amount of freedom. In an attended session it can open a decision page in the browser to choose a direction and iterate.

Installation is simple via npx impeccable install, with project or global scope, and updates run through npx impeccable update. Everything, including the skills, commands, CLI, and detection engine, is Apache 2.0 licensed and free for everyone.

Impeccable's Core Features

• One skill with a set of design commands

• Curated anti-patterns to block AI slop

• Works with Cursor, Claude Code, Copilot, Gemini CLI, and Codex CLI

• Per-target builds with model-specific slop rules

• Design context that travels as DESIGN.md and PRODUCT.md

• Automatic job-type detection from your description

• In-browser decision and iteration for attended sessions

• Fully open source under Apache 2.0

How to use Impeccable?

1. 1

   Install: Run npx impeccable install and choose project or global scope.

2. 2

   Initialize: Run init and create your design context files.

3. 3

   Describe the work: Say what you want and let Impeccable pick the right job type.

4. 4

   Iterate: Refine the design in your harness or in the browser decision page.

5. 5

   Update: Run npx impeccable update to get the latest skills and commands.

Impeccable's Use Cases

• Polished frontend generation
• Blocking AI slop
• Redesigns and additions
• Cross-tool design consistency

FAQ from Impeccable

• Is Impeccable free?

  Yes. Everything is Apache 2.0: the skills, commands, CLI, and detection engine. It is fully open source and free for everyone.

• Which AI harnesses does it support?

  Impeccable works with Cursor, Claude Code, GitHub Copilot, Gemini CLI, and Codex CLI, installing hidden folders for each supported tool.

• How do I install it?

  The easiest way is npx impeccable install, which detects your harness folders and lets you install in the current project or globally. You can also extract the universal ZIP to your project root.

• How do I update to the latest version?

  Run npx impeccable update from your project root. Your PRODUCT.md and DESIGN.md context files are never overwritten.

• Can I bring back a specific command shortcut?

  Yes. Pinning is built in. For example, npx impeccable pin critique makes /critique a standalone shortcut again, and you can unpin it later.

• What does it do about model-specific design flaws?

  Builds for models with known tells carry extra slop rules banning that model's habits, such as removing image-on-hover motion or refusing ghost-cards and over-rounding.