Impeccable: A Design Skill for AI Coding Agents
AICodeKinggo watch the original →
the gist
Impeccable is an open-source design skill that provides AI coding agents with a structured design vocabulary, project-specific context files, and 41 deterministic linting rules to eliminate common AI-generated UI clichés.
Design Context and Workflow
Impeccable functions as a design-focused skill for AI coding agents, moving beyond generic prompt-based instructions by establishing a formal design system for the project. The initialization process creates two reference files, PRODUCT.md and DESIGN.md, which store brand positioning, target audience, typography, and color palette definitions. AI agents read these files before executing design tasks, ensuring that outputs align with project-specific requirements rather than defaulting to common model-trained patterns.
Command-Based Design Operations
The tool provides 23 slash commands that act as a design vocabulary for the agent. The core workflow is managed through /impeccable craft, which handles UX planning and visual iteration. Review and refinement are supported by commands such as /impeccable critique for hierarchy and clarity, /impeccable audit for accessibility and responsiveness, and /impeccable polish for final adjustments. Specific adjustment commands like /impeccable bolder, /impeccable quieter, and /impeccable distill allow for iterative tuning of the UI aesthetic.
Deterministic Design Detection
To reduce token usage and improve quality, Impeccable includes 41 deterministic detector rules that identify common AI design patterns without LLM intervention. These rules flag issues such as purple-to-blue gradients, nested cards, overused fonts like Inter, and poor touch target sizing. Developers can run these checks via npx impeccable detect on source folders or live URLs, and the tool supports a --json flag to integrate these checks into CI pipelines for automated quality enforcement.