Impeccable is a design language and skill system built for AI coding agents, specifically designed to help them generate higher-quality frontend designs. Written in JavaScript and hosted at impeccable.style, it addresses a core problem in AI-assisted design: models trained on the same templates tend to produce repetitive, formulaic outputs featuring identical design patterns like Inter typography, purple-to-blue gradients, nested card layouts, and gray text on colored backgrounds.
The project originated from Anthropic's frontend-design skill but evolved into a more comprehensive system. It provides a structured approach to AI-guided design through three main components: a one-time setup flow that captures design context, a vocabulary of 23 commands that create a shared language between developers and AI agents, and 46 deterministic detector rules that identify design anti-patterns without requiring API calls or LLM inference.
The setup process begins with the `/impeccable init` command, which distinguishes between brand surfaces (marketing sites, landing pages, portfolios) and product surfaces (application UIs, dashboards, tools). This initial configuration generates PRODUCT.md and DESIGN.md files that document the project's audience, brand positioning, voice, color palette, typography, components, and explicit anti-references. Every subsequent command reads this context to make informed design decisions.
The 23 commands cover the full design lifecycle. Early-stage commands like `/impeccable shape` plan UX and UI before code is written, while `/impeccable craft` provides a complete shape-then-build flow with visual iteration. Mid-process commands include `/impeccable audit` for technical quality checks covering accessibility, performance, and responsiveness, and `/impeccable critique` for UX design reviews examining hierarchy, clarity, and emotional resonance. Refinement commands like `/impeccable polish`, `/impeccable bolder`, `/impeccable quieter`, and `/impeccable distill` adjust designs based on specific needs. Specialized commands address particular concerns: `/impeccable harden` handles error states and edge cases, `/impeccable onboard` designs first-run experiences, `/impeccable animate` adds purposeful motion, and `/impeccable overdrive` implements technically sophisticated effects. The `/impeccable live` command enables visual iteration directly in the browser.
Installation supports multiple workflows. The recommended approach uses `npx impeccable install`, which auto-detects harness folders for Cursor, Claude Code, Codex, and other supported tools, then installs provider-native hook manifests. Alternative installation methods include Git submodules for teams wanting vendored updates, plugin installations through marketplace systems, direct downloads from the website, or manual copying to tool-specific directories. The system supports Cursor, Claude Code, Gemini CLI, Codex CLI, Grok Build, GitHub Copilot, OpenCode, Pi, Trae, Rovo Dev, and Qoder.
The design hook feature, installed on Claude Code, GitHub Copilot, Codex, and Cursor, runs the Impeccable detector on UI file edits and surfaces findings back into the agent workflow. On Cursor, it blocks problematic proposed writes before they land. The system generates working files in a `.impeccable/` directory, with most files being ephemeral but certain artifacts like config.json, live/config.json, design.json, and critique reports intended for version control.
The project includes explicit anti-pattern guidance covering typography choices, color combinations, layout structures, and animation styles. A case study of the Neo Mirai project demonstrates real-world transformation using Impeccable commands. Commands accept optional arguments to focus on specific areas, and frequently-used commands can be pinned as standalone shortcuts using `/impeccable pin`.
