ux-pilot

Conduct conversational UX design workflows: discover needs via guided questions, audit frontend codebases for UX/accessibility/SEO issues with scored reports and fix prompts, preview designs on a local server with named versions, and export specs or React/Svelte/Vue components.

Your UX co-pilot — from idea to validated flow, in your terminal.

Install · How it works · Rules · Try the demo · Landing page

A Claude Code plugin that acts as a senior UX designer. It doesn't generate code blindly — it understands your product, challenges your choices, shows you the result in a live browser preview, and helps you iterate until the flow is validated.

What's New (v0.1.3)

HTML Audit Report — audit results open as a styled HTML page in your browser with score, severity grouping, and category breakdown
Fix Prompts (natural language) — each finding includes a no-coder-friendly prompt you can paste into Claude Code to fix the issue. No HTML tags, just plain instructions
Persistent UX Brief — discovery saves ux-pilot/ux-brief.md in your project, updated as you make decisions
Visual Audit with Playwright — if Playwright MCP is installed, the audit captures screenshots at 375px, 768px, and 1280px and analyzes the visual result. Falls back to static CSS analysis if not available
6 Mobile CSS Checks — detects tables without responsive wrapper, fixed widths > 500px, small touch targets (< 44px), small fonts (< 14px), nav without flex-wrap, and CSS widths without media queries
Mobile Score Calibration — mobile findings now carry 1.5x penalty weight for more accurate scoring
Screenshot References — findings from visual audit include clickable screenshot thumbnails in the HTML report
Anti AI-Slop: No Emojis — the plugin now uses inline SVG icons instead of emojis (emojis render differently across OS/browsers)
Finding Numbering — each finding shows its index (1/10, 2/10...) for easier tracking
Back to Top — link at the bottom of the HTML report

Having issues updating? See Troubleshooting.

Optional: Playwright MCP for Visual Audit

For the best audit results, install Playwright MCP to enable screenshot-based visual analysis:

npm install -g @playwright/mcp

Then add it to your Claude Code MCP config (~/.claude/mcp.json):

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp"]
    }
  }
}

Without Playwright, the audit uses static CSS analysis only — still useful, but can't detect visual overflow or layout issues that only appear when the page is rendered.

Why ux-pilot?

Every AI tool generates the same generic output: Inter font, purple gradient on white, centered hero, done. ux-pilot exists to fix this.

Instead of jumping straight to code, it runs a structured discovery flow — asks about your product, users, and goals — then applies the right rules from 376 UX rules sourced from WCAG 2.1, Nielsen Norman Group, and Laws of UX.

What makes it different

	Existing tools	ux-pilot
Approach	Generate code directly	Dialogue first, code after
Output	One-shot result	Iterative, named versions
Scope	Landing pages mostly	Full apps (dashboards, CRUD, onboarding...)
Preview	No live preview	Local server with hot reload
UX knowledge	Few or no rules	376 rules loaded on-demand
Context	Loads everything	Token-efficient (rules loaded per screen)
Version naming	V1, V2, V3	Descriptive: "Classic", "Bold", "Minimal"
Design quality	Generic AI aesthetic	Anti "AI slop" rules built-in

Installation

# Step 1 — Add from marketplace
/plugin marketplace add Sakaax/ux-pilot

# Step 2 — Install the skill
/plugin install ux-pilot@ux-pilot

No API keys. No subscription. Free and open source.

ux-pilot

Popularity

Health & Quality

What's Inside

README

What's New (v0.1.3)

Optional: Playwright MCP for Visual Audit

Why ux-pilot?

What makes it different

Installation

Usage

Confidence

Similar Plugins

impeccable

frontend-design-audit

ui-ux-pro-max

bencium-controlled-ux-designer

ui-ux-design-pro

ux