impeccable
CLI Toolpbakaus/impeccable
Design language and command set for AI-assisted frontend design.
Overview
Impeccable provides a shared design vocabulary, domain references, and anti-pattern rules to enhance AI model outputs for frontend design. It includes 23 commands and works as a skill for multiple coding assistants.
README Preview
# Impeccable\n\nThe vocabulary you didn't know you needed. 1 skill, 23 commands, and curated anti-patterns for impeccable frontend design.\n\n> **Quick start:** Visit [impeccable.style](https://impeccable.style) to download ready-to-use bundles.\n\n## Why Impeccable?\n\nAnthropic's [frontend-design](https://github.com/anthropics/skills/tree/main/skills/frontend-design) was the first widely-used design skill for Claude. Impeccable started from there.\n\nEvery model trained on the same SaaS templates. Skip the guidance and you get the same handful of tells on every project: Inter for everything, purple-to-blue gradients, cards nested in cards, gray text on colored backgrounds, the rounded-square icon tile above every heading.\n\nImpeccable adds:\n- **7 domain reference files** ([view source](skill/)). Typography, color, motion, spatial, interaction, responsive, UX writing. Load on every command, alongside a brand-vs-product register that adjusts the defaults.\n- **23 commands.** A shared design vocabulary with your AI: `polish`, `audit`, `critique`, `distill`, `animate`, `bolder`, `quieter`, and more.\n- **27 deterministic anti-pattern rules** plus a 12-rule LLM critique pass. CLI and browser extension run the deterministic ones with no LLM and no API key. Each is tied to specific design guidance the skill teaches against.\n\n## What's Included\n\n### The Skill: impeccable\n\nA comprehensive design skill with 7 domain-specific references ([view skill](skill/SKILL.src.md)):\n\n| Reference | Covers |\n|-----------|--------|\n| [typography](skill/reference/typography.md) | Type systems, font pairing, modular scales, OpenType |\n| [color-and-contrast](skill/reference/color-and-contrast.md) | OKLCH, tinted neutrals, dark mode, accessibility |\n| [spatial-design](skill/reference/spatial-design.md) | Spacing systems, grids, visual hierarchy |\n| [motion-design](skill/reference/motion-design.md) | Easing curves, staggering, reduced motion |\n| [interaction-design](skill/refer
FAQ (3)
TroubleshootingWhy does 'bundled detector not found' error occur when running impeccable's detect.mjs?
This error happened because the npx skills installer only shipped the skill subtree, missing the detector engine. The issue is resolved in the latest release—update the skill. If updating isn't possible, use this workaround: mkdir -p .agents/skills/impeccable/scripts/detector && ln -sf "$(pwd)/node_modules/impeccable/cli/engine/detect-antipatterns.mjs" .agents/skills/impeccable/scripts/detector/detect-antipatterns.mjs. This symlinks the engine from the impeccable npm package into the expected location.
TroubleshootingWhy does the critique-storage.mjs script return no output on Windows?
The script's entry-point guard compared import.meta.url (which uses forward slashes on Windows) with file://${process.argv[1]} (backslashes), so the equality check failed and main() was never called. This bug was fixed in v3.1.1 by switching to pathToFileURL(process.argv[1]).href which normalizes separators. Update the skill with: npx skills add pbakaus/impeccable
How-toHow to persist Impeccable critique results across sessions to avoid re-raising resolved issues?
Create a manual CRITIQUE.md file to store previous critique output. Before running a new /impeccable critique, instruct the agent to read CRITIQUE.md for context and update it after review. This workaround mimics the proposed feature until built-in persistence lands.