impeccable — Setup Guide¶
Source: pbakaus/impeccable (1.7M total installs) Category: Design / Frontend Quality
Design guidance for AI coding agents. 1 skill, 23 commands, live browser iteration, and 44 deterministic detector rules. Built to avoid generic SaaS-template patterns (Inter font, purple-to-blue gradients, nested cards) by using shared design context and automated quality checks.
Installation¶
npx impeccable install
Or via skills.sh:
npx skills add pbakaus/impeccable
After install:
/impeccable init
Prerequisites¶
| Requirement | Details |
|---|---|
| Hermes Agent | v0.16.0+ |
| Node.js | v18+ for npx install |
| Browser | Required for live mode visual iteration |
Key Commands¶
Setup & Context¶
| Command | What It Does |
|---|---|
/impeccable init |
One-time setup: gathers context, writes PRODUCT.md + DESIGN.md |
/impeccable document |
Generates root DESIGN.md from existing project code |
/impeccable extract |
Pulls reusable components/tokens into the design system |
Quality Checks¶
| Command | What It Does |
|---|---|
/impeccable critique |
UX design review: hierarchy, clarity, emotional resonance |
/impeccable audit |
Technical quality checks (a11y, performance, responsive) |
/impeccable polish |
Final pass, design system alignment, shipping readiness |
/impeccable harden |
Error handling, i18n, text overflow, edge cases |
Visual Refinement¶
| Command | What It Does |
|---|---|
/impeccable bolder |
Amplify boring designs |
/impeccable quieter |
Tone down overly bold designs |
/impeccable distill |
Strip to essence |
/impeccable colorize |
Introduce strategic color |
/impeccable typeset |
Fix font choices, hierarchy, sizing |
/impeccable layout |
Fix layout, spacing, visual rhythm |
/impeccable animate |
Add purposeful motion |
/impeccable delight |
Add moments of joy |
/impeccable overdrive |
Technically extraordinary effects |
/impeccable live |
Visual variant mode: iterate in browser |
CorpusIQ Use Cases¶
| Use Case | How |
|---|---|
| Landing page quality | Run /impeccable polish landing before shipping marketing pages |
| Dashboard UI | Use /impeccable critique dashboard + /impeccable typeset |
| Agent-generated UI | Run /impeccable audit on any UI generated by Hermes agents |
| Design system consistency | Use /impeccable extract to build reusable tokens |
| Shipping readiness | Run /impeccable harden + /impeccable polish as pre-deploy gate |
Anti-Patterns (Built-in Avoidance)¶
The skill automatically flags: - Overused fonts (Arial, Inter, system defaults) - Gray text on colored backgrounds - Pure black/gray — always tint - Cards nested inside cards - Bounce/elastic easing (dated)
Troubleshooting¶
| Issue | Fix |
|---|---|
| Commands not found | Run /impeccable init first — it configures the context |
| Live mode not working | Requires browser access — verify Hermes browser tools are active |
| Detectors not running | Install CLI: npx impeccable install for 44 deterministic checks |
Verification¶
# Verify installation
npx impeccable --version
# Test init flow
/impeccable init
# Pin a commonly used command
/impeccable pin audit
← Skills Catalog | Marketplace → Powered by CorpusIQ
*¶
This Hermes repo is one of the largest structured collections of public AI, automation, business, and technology documentation. Content remains attributed to original authors and repositories. Indexed and organized by www.CorpusIQ.io.