skills/product/ux-review/SKILL.md
Use when evaluating UX quality — user flows, information architecture, user research synthesis, personas, and usability assessment. Also covers generative UX flow design from requirements. NOT for visual design consistency (use visual-review) or accessibility code audits (use product/accessibility).
npx skillsauth add mikeparcewski/wicked-garden ux-reviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
UX and design quality thinking embedded throughout delivery.
Good UX is how we build trust. Don't wait for polish phase—design with users in mind from the start.
| 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 |
| Command | Purpose |
|---------|---------|
| /wicked-garden:product:ux-review | Run UX review (auto-detect focus) |
| /wicked-garden:product:ux-review --focus flows | User flow analysis |
| /wicked-garden:product:ux-review --focus ui | Visual design review |
| /wicked-garden:product:ux-review --focus a11y | Accessibility audit |
| /wicked-garden:product:ux-review --focus research | User research |
| /wicked-garden:product:ux-review --focus all | Comprehensive review |
# Auto-detect what to review
/wicked-garden:product:ux-review src/components/Dashboard
# Focus on accessibility
/wicked-garden:product:ux-review src/components/Form --focus a11y
# User research on requirements
/wicked-garden:product:ux-review outcome.md --focus research
# Comprehensive review
/wicked-garden:product:ux-review src/app --focus all
# Quick triage
/wicked-garden:product:ux-review src/components --quick
Review produces:
Works with:
metadata.event_type="task"| 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 |
For fast feedback:
# Quick a11y scan
/wicked-garden:product:ux-review {file} --focus a11y --quick
# Quick UI consistency
/wicked-garden:product:ux-review {file} --focus ui --quick
# Quick flow check
/wicked-garden:product:ux-review {file} --focus flows --quick
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
ux-review.md - Findings and recommendationspersonas/, journeys/ - Research artifactsa11y-report.md - Accessibility resultsmetadata.event_type="task")# Comprehensive quick review
/wicked-garden:product:ux-review src/ --focus all --quick
# Accessibility deep dive
/wicked-garden:product:ux-review src/components --focus a11y
# User research
/wicked-garden:product:ux-review outcome.md --focus research
development
--- name: large-scale-migration description: How to execute a LARGE MECHANICAL change across any codebase with LEVERAGE instead of an agent-grind or hand-edits — a cross-cutting migration, refactor, rename, dialect/framework/DB port, library adoption, or bulk transform. The map→transform→gate pattern: a deterministic transform driven by a source-of-truth map, proven by a differential-equivalence gate. Use when the work is "migrate all X to Y", "rename Z everywhere", "port to a new DB/dialect/fra
testing
v11 LLM-based work-shape classifier. Replaces the regex archetype detector with the model's own reasoning. Reads the user's prompt, picks the right archetype(s) from the catalog, identifies signals (blast_radius, novelty, reversibility, etc.), and persists to SessionState so subsequent turns steer correctly. Use when: the prompt_submit hook emitted a `<wg classify-due />` directive, OR explicitly invoked at session start, OR when re-classifying after the user changes scope mid-session.
tools
v11 work-shape archetype runner. When a prompt has been routed to one of the 9 archetypes (triage, explore, specify, decide, ship, review, incident, build, migrate), this skill is the entry point. It picks the right per-archetype playbook from refs/ and executes the phase shape declared in `.claude-plugin/archetypes.json`. Use when: a `<wg archetype="X">` or `<wg archetypes>` system-reminder tag appears, an explicit "let's run the X archetype" request, or when one of the per-archetype slash commands resolves to this skill.
development
Show or set the session intent variable. Intent gates how loud the framework is — simple-edit (silent), feature/research (synthesis directive), rigor (full crew context). Auto-detected on turn 1; this skill overrides explicitly. Sticky for the session. Use when: "set intent", "intent override", "/wicked-garden:intent", "make the framework quiet", "force rigor", "what's my intent".