ux-review

Validate UX specifications and HUD designs for completeness and accessibility.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill ux-review-polsegu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ux-review
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/ux-review
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill ux-review-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures UX specifications, HUD designs, and interaction pattern libraries are complete, accessible, and aligned with the Game Design Document before handoff to visual design or implementation, reducing rework and implementation risk.

Core Features & Use Cases

  • Comprehensive Checklist Validation: Runs completeness checks for headers, player need, states, interaction maps, data requirements, transitions, localization, and acceptance criteria.
  • Cross-Reference Checks: Loads accessibility requirements, input & platform config, referenced GDD UI requirements, pattern library, and player journey to validate alignment and coverage.
  • Verdict & Guidance: Produces structured verdicts (APPROVED / NEEDS REVISION / MAJOR REVISION NEEDED) with blocking and advisory issues, remediation steps, and next-step recommendations.
  • Use Case: Run on a completed inventory UX spec to verify input method coverage, error/empty/loading states, accessibility tier compliance, and GDD alignment before implementation.

Quick Start

Run ux-review on the file design/ux/inventory.md to get a detailed verdict, checklist results, and actionable fixes.

Frequently Asked Questions about ux-review

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

FAQPage Schema
How do I validate a UX spec for implementation readiness?

Validate UX specs by running completeness checks for headers, states, interaction maps, data requirements, and acceptance criteria. Apply the review to individual spec files or the entire design directory to produce structured verdicts and identify blocking issues before handoff.

What is UX spec validation against a Game Design Document?

UX spec validation against a GDD cross-references accessibility requirements, input configurations, and player journey data to ensure alignment. It verifies that UX specifications, HUD designs, and pattern libraries match referenced GDD UI requirements before visual design implementation.

How do I check accessibility compliance in a UX specification?

Check accessibility compliance by loading accessibility requirements and validating input method coverage, error states, and tier compliance within the UX spec. The review produces advisory issues and remediation steps for any missing accessibility coverage.

Can I review an entire design directory for pattern library consistency?

Yes, you can apply the review to the entire design and UX directory. It loads the interaction pattern library to validate consistency and coverage, producing structured APPROVED or NEEDS REVISION verdicts with actionable next-step recommendations.

What does a UX handoff review verdict include?

A UX handoff review verdict includes a status of APPROVED, NEEDS REVISION, or MAJOR REVISION NEEDED. It details blocking and advisory issues, provides remediation steps, and gives next-step recommendations to reduce implementation risk.

When do I need to run a pre-implementation UX review?

Run a pre-implementation UX review when a UX spec or HUD design is completed and ready for visual design or engineering handoff. It ensures completeness, input method coverage, and GDD alignment, reducing rework and implementation risk.