UX Review Skill

UX and design quality thinking embedded throughout delivery.

Core Concept

Good UX is how we build trust. Don't wait for polish phase—design with users in mind from the start.

Four Focus Areas

Area	Expert	Focus
User Flows	UX Designer	Experience design, interactions, IA
Visual Design	UI Reviewer	Consistency, components, design system
Accessibility	A11y Expert	WCAG, keyboard, screen readers
User Research	User Researcher	Needs, personas, journeys

Commands

Command	Purpose
`/wicked-product:ux-review`	Run UX review (auto-detect focus)
`/wicked-product:ux-review --focus flows`	User flow analysis
`/wicked-product:ux-review --focus ui`	Visual design review
`/wicked-product:ux-review --focus a11y`	Accessibility audit
`/wicked-product:ux-review --focus research`	User research
`/wicked-product:ux-review --focus all`	Comprehensive review

Usage

bash

# Auto-detect what to review
/wicked-product:ux-review src/components/Dashboard

# Focus on accessibility
/wicked-product:ux-review src/components/Form --focus a11y

# User research on requirements
/wicked-product:ux-review outcome.md --focus research

# Comprehensive review
/wicked-product:ux-review src/app --focus all

# Quick triage
/wicked-product:ux-review src/components --quick

Output

Review produces:

•Issues: Critical / Major / Minor findings
•Recommendations: Specific, actionable improvements
•Evidence: Screenshots, code snippets, WCAG citations
•Kanban: Issues tracked for follow-up

Review Types

User Flow Review

•Happy path clarity
•Error handling
•User mental models
•Interaction patterns
•Information architecture

Visual Design Review

•Color consistency
•Typography scale
•Spacing system
•Component patterns
•Responsive design
•Visual polish

Accessibility Audit

•WCAG 2.1 Level AA compliance
•Keyboard navigation
•Screen reader support
•Semantic HTML
•ARIA patterns
•Color contrast

User Research

•User needs discovery
•Persona creation
•Journey mapping
•Problem validation
•Jobs to Be Done

Integration

Works with:

•wicked-crew: Auto-suggested after phases
•wicked-browse: Screenshot capture, a11y testing
•wicked-kanban: Issue tracking
•wicked-mem: Design system memory
•wicked-search: Pattern discovery

Phase Integration

Phase	Suggested Review	Expert
Clarify	User research	User Researcher
Design	User flows + IA	UX Designer
Build	A11y + UI consistency	A11y Expert + UI Reviewer
Review	Comprehensive review	All experts

When to Use

Use wicked-product when:

•Designing user-facing features
•Implementing UI components
•Need accessibility compliance
•Want to validate user needs
•Reviewing visual design
•Auditing existing interfaces

Skip wicked-product when:

•Pure backend/API work
•Infrastructure changes
•No user interaction
•Internal tooling (unless specifically requested)

Quick Checks

For fast feedback:

bash

# Quick a11y scan
/wicked-product:ux-review {file} --focus a11y --quick

# Quick UI consistency
/wicked-product:ux-review {file} --focus ui --quick

# Quick flow check
/wicked-product:ux-review {file} --focus flows --quick

Common Findings

UX: Unclear flows, missing error states, confusing navigation UI: Color/typography/spacing inconsistencies, missing states A11y: Missing alt text, poor contrast, no keyboard access Research: Assumed needs, missing personas, unmapped journeys

Output Artifacts

•ux-review.md - Findings and recommendations
•personas/, journeys/ - Research artifacts
•a11y-report.md - Accessibility results
•Kanban tasks for tracking

Best Practices

•Review early - catch issues in design phase
•Focus on users - always ask "how does this help?"
•Be specific - give actionable recommendations
•Cite standards - reference WCAG, design system
•Track issues - use kanban for follow-through

Getting Started

bash

# Comprehensive quick review
/wicked-product:ux-review src/ --focus all --quick

# Accessibility deep dive
/wicked-product:ux-review src/components --focus a11y

# User research
/wicked-product:ux-review outcome.md --focus research