1# Impeccable CLI
 2
 3Detect UI anti-patterns and design quality issues from the command line. Scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 25 specific patterns including AI-generated UI tells, accessibility violations, and general design quality problems.
 4
 5## Quick Start
 6
 7```bash
 8# Install skills into your AI harness (Claude, Cursor, Gemini, etc.)
 9npx impeccable skills install
10
11# Update skills to the latest version
12npx impeccable skills update
13
14# List all available commands
15npx impeccable skills help
16
17# Scan files or directories for anti-patterns
18npx impeccable detect src/
19
20# Scan a live URL (requires Puppeteer)
21npx impeccable detect https://example.com
22
23# JSON output for CI/tooling
24npx impeccable detect --json src/
25
26# Regex-only mode (faster, no jsdom)
27npx impeccable detect --fast src/
28```
29
30## What It Detects
31
32**AI Slop Tells**: patterns that scream "AI generated this":
33- Side-tab accent borders, gradient text on headings
34- Purple/violet gradients and cyan-on-dark palettes
35- Dark mode with glowing accents, border + border-radius clashes
36
37**Typography Issues**: overused fonts (Inter, Roboto), flat type hierarchy, single font families
38
39**Color & Contrast**: WCAG AA violations, gray text on colored backgrounds, pure black/white
40
41**Layout & Composition**: nested cards, monotonous spacing, everything-centered layouts
42
43**Motion**: bounce/elastic easing, layout property transitions
44
45**Quality**: tiny body text, cramped padding, long line lengths, small touch targets
46
4725 detections in total. See the full list at [impeccable.style](https://impeccable.style).
48
49## Exit Codes
50
51- `0`: no issues found
52- `2`: anti-patterns detected
53
54## Options
55
56```
57impeccable detect [options] [file-or-dir-or-url...]
58
59  --fast    Regex-only mode (skip jsdom, faster but less accurate)
60  --json    Output findings as JSON
61  --help    Show help
62```
63
64## Requirements
65
66- Node.js 18+
67- `jsdom` (included as dependency, used for HTML scanning)
68- `puppeteer` (optional, only needed for URL scanning)
69
70## Part of Impeccable
71
72This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 22 steering commands for Claude, Cursor, Gemini, Codex, and more.
73
74## License
75
76[Apache 2.0](https://github.com/pbakaus/impeccable/blob/main/LICENSE)