Impeccable CLI

Detect UI anti-patterns and design quality issues from the command line. Scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 44 deterministic rules, 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 fk-skills skills install

# Non-interactive install for a specific scope
npx fk-skills skills install -y --providers=claude,codex --scope=project

# First command to run inside your AI harness
/fk init

# Update skills to the latest version
npx fk-skills skills update

# Install or update skills without hook manifests
npx fk-skills skills install --no-hooks

# Link skills from a Git submodule checkout
npx fk-skills skills link --source=.impeccable --providers=claude,cursor

# List all available commands
npx fk-skills skills help

# Scan files or directories for anti-patterns
npx fk-skills detect src/

# Scan a live URL (requires Puppeteer)
npx fk-skills detect https://example.com

# JSON output for CI/tooling
npx fk-skills detect --json src/

# Deprecated compatibility flag; full scan still runs
npx fk-skills detect --fast src/

Tool UI

A local browser UI that scans any URL and runs an AI review using your installed CLI (Claude or Codex).

# Start the tool UI (opens http://localhost:4444 automatically)
npx fk-skills tool

# Use Codex CLI instead of Claude
npx fk-skills tool --llm codex

# Auto-detect whichever CLI is installed
npx fk-skills tool --llm auto

# Custom ports
npx fk-skills tool --port 4444 --scan-port 3001

What it does:

• Fetches and scans any URL with 44 deterministic rules
• Auto-renders SPAs via headless Chromium if needed
• Queues an AI review via your CLI after every scan (no API key needed)
• AI review covers 5 dimensions: Accessibility, Performance, Responsive Design, Theming, Anti-Patterns — scored 0-4 each (/20 total)
• Results include dimension table, per-issue location/category/WCAG, systemic issues, and recommended /fk commands

Requirements:

• claude CLI: npm install -g @anthropic-ai/claude-code
• OR codex CLI: npm install -g @openai/codex

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

44 deterministic detector rules in total.

Exit Codes

• 0: no issues found
• 2: anti-patterns detected

Options

fk 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 24+
• jsdom (included as dependency, used for HTML scanning)
• puppeteer (optional, only needed for URL scanning)

Part of fk-skills

This CLI is part of fk-skills, a cross-provider design skill pack for AI-powered development tools. The full suite includes 23 commands for Claude, Cursor, Gemini, Codex, and more.

License

Apache 2.0