ux-review

Validate UX design documents for completeness, accessibility, and implementation readiness.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill ux-review-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ux-review
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/ux-review
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill ux-review-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The ux-review skill prevents UX documents from becoming brittle, incomplete, or inaccessible by validating UX specs, HUD designs, and interaction patterns against required completeness, accessibility, GDD alignment, and implementation readiness.

Core Features & Use Cases

  • UX spec completeness & quality gate: Checks required sections (states, transitions, data mapping, events, acceptance criteria) and flags missing or inconsistent content.
  • Cross-reference validation: Loads authoritative platform/input configuration and checks input method coverage, accessibility tier alignment, and player-journey context.
  • HUD and pattern library validation: Verifies HUD information architecture, visual/state rules, and consistency with the interaction pattern library.
  • Actionable verdict output: Produces APPROVED, NEEDS REVISION, or MAJOR REVISION NEEDED with specific gaps, blocking/advisory labeling, and where to fix.

Quick Start

Run ux-review to validate /design/ux/inventory/ux-spec.md and return an approval or revision verdict with the missing sections.

Frequently Asked Questions about ux-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate UX spec completeness before implementation?

To validate UX spec completeness, check required sections like states, transitions, data mapping, events, and acceptance criteria. This process flags missing or inconsistent content, ensuring your UX documents are ready for implementation and preventing brittle or incomplete designs.

What is a UX review quality gate for HUD design documents?

A UX review quality gate for HUD design verifies information architecture, visual rules, and state consistency. It enforces required section coverage and cross-references interaction patterns to ensure HUD layouts align with platform targets and accessibility tiers.

How do I check accessibility compliance in a UX design document?

Check accessibility compliance by validating UX specs against required accessibility tiers and input method coverage. Loading authoritative platform configurations ensures player-journey context and multi-platform targets meet compliance before implementation begins.

Can I verify interaction pattern library consistency with GDD alignment?

Yes, you can verify interaction pattern library consistency by validating UX specs against Game Design Document (GDD) alignment. This cross-reference validation checks input method coverage and ensures interaction patterns match the intended player journey.

Does UX spec validation work for multiple input methods and platform targets?

Yes, UX spec validation works across multiple input methods and platform targets. It loads authoritative platform configurations to verify accessibility tier alignment and input method coverage within the player-journey context.

What verdicts are produced when checking UX implementation readiness?

Checking UX implementation readiness produces APPROVED, NEEDS REVISION, or MAJOR REVISION NEEDED verdicts. These actionable outputs label specific blocking and advisory gaps, providing clear guidance on where to fix missing sections.