ux-review

Validate UX design documents for completeness and accessibility compliance.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/easonlao/jiazi-game --skill ux-review-easonlao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ux-review
Source: https://github.com/easonlao/jiazi-game/tree/main/.claude/skills/ux-review
Command: npx skills add https://github.com/easonlao/jiazi-game --skill ux-review-easonlao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents UX designs from moving into implementation with missing sections, unclear player needs, or accessibility and input-method gaps that later cause costly rework.

Core Features & Use Cases

  • UX spec completeness validation: Checks that required UX spec sections (purpose, player context, states, navigation, layout zones, events, transitions, accessibility, localization, and testable acceptance criteria) are present and consistent.
  • Cross-reference alignment: Loads platform input configuration, accessibility requirements, interaction pattern library, referenced GDD UI requirements, and (optionally) the player journey to detect mismatches.
  • HUD and pattern library review modes: Supports validation tailored for HUD design documents and interaction pattern libraries with dedicated completeness and consistency checklists.

Quick Start

Run ux-review on the UX document you want validated by specifying its file path, for example /ux-review design/ux/inventory.md.

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 design specs for completeness before implementation handoff?

Validating UX design specs requires checking required sections like purpose, player context, states, navigation, layout zones, events, transitions, accessibility, and localization. A deterministic review parses these sections and cross-references context files to produce a verdict with specific blocking gaps.

What is UX spec cross-reference alignment with GDD and pattern libraries?

UX spec cross-reference alignment loads platform input configurations, accessibility requirements, interaction pattern libraries, and referenced GDD UI requirements to detect mismatches. It ensures the UX document is consistent with established game design documents and interaction standards before implementation.

Can I check a HUD design document for accessibility compliance and input-method coverage?

Yes, you can check HUD design documents for accessibility compliance and input-method coverage using dedicated HUD review modes. These modes apply tailored completeness and consistency checklists to validate player-facing HUD elements against platform input configurations and accessibility requirements.

Does UX validation work for interaction pattern libraries or only player-facing HUD documents?

UX validation works for both interaction pattern libraries and player-facing HUD documents. It applies dedicated completeness and consistency checklists tailored to each document type, ensuring both pattern definitions and HUD layouts meet required UX standards.

When should I run a UX review on my design documents?

You should run a UX review on design documents before implementation handoff and after major UX revisions. This timing prevents designs with missing sections, unclear player needs, or accessibility and input-method gaps from moving into implementation and causing costly rework.

How do I review a UX spec to find missing sections and blocking gaps?

To review a UX spec and find missing sections, specify the document file path to trigger a deterministic read-only review. The review parses required UX spec sections, loads cross-reference context files, and produces a verdict identifying specific blocking gaps that must be resolved.