Paul BakausandClaude Opus 4.6
da8a59e981
New `impeccable skills` CLI with three subcommands: - `skills help`: fetches and displays all 20 commands from the API - `skills install`: delegates to `npx skills add pbakaus/impeccable` - `skills update`: tries `npx skills update` first; if skills aren't managed by the skills CLI, downloads the universal bundle from impeccable.style and overwrites provider folders directly, with git-based modification detection and confirmation prompt Also fixes npm metadata: homepage -> impeccable.style, license -> Apache-2.0 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.3 KiB
Impeccable CLI
Detect 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.
Quick Start
# Install skills into your AI harness (Claude, Cursor, Gemini, etc.)
npx impeccable skills install
# Update skills to the latest version
npx impeccable skills update
# List all available commands
npx impeccable skills help
# Scan files or directories for anti-patterns
npx impeccable detect src/
# Scan a live URL (requires Puppeteer)
npx impeccable detect https://example.com
# JSON output for CI/tooling
npx impeccable detect --json src/
# Regex-only mode (faster, no jsdom)
npx impeccable detect --fast src/
What It Detects
AI Slop Tells -- patterns that scream "AI generated this":
- Side-tab accent borders, gradient text on headings
- Purple/violet gradients and cyan-on-dark palettes
- Dark mode with glowing accents, border + border-radius clashes
Typography Issues -- overused fonts (Inter, Roboto), flat type hierarchy, single font families
Color & Contrast -- WCAG AA violations, gray text on colored backgrounds, pure black/white
Layout & Composition -- nested cards, monotonous spacing, everything-centered layouts
Motion -- bounce/elastic easing, layout property transitions
Quality -- tiny body text, cramped padding, long line lengths, small touch targets
25 detections in total. See the full list at impeccable.style.
Exit Codes
0-- no issues found2-- anti-patterns detected
Options
impeccable detect [options] [file-or-dir-or-url...]
--fast Regex-only mode (skip jsdom, faster but less accurate)
--json Output findings as JSON
--help Show help
Requirements
- Node.js 18+
jsdom(included as dependency, used for HTML scanning)puppeteer(optional, only needed for URL scanning)
Part of Impeccable
This CLI is part of Impeccable, a cross-provider design skill pack for AI-powered development tools. The full suite includes 20 steering commands for Claude, Cursor, Gemini, Codex, and more.
License
See LICENSE file.