ux-review

Validate UX design specifications for accessibility, GDD alignment, and implementation readiness.

1|Updated May 5, 2026
One-click install
npx skills add https://github.com/XGanQAQ/Unity-Claude-Code-Game-Studios --skill ux-review-xganqaq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ux-review
Source: https://github.com/XGanQAQ/Unity-Claude-Code-Game-Studios/tree/main/.claude/skills/ux-review
Command: npx skills add https://github.com/XGanQAQ/Unity-Claude-Code-Game-Studios --skill ux-review-xganqaq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The ux-review skill prevents incomplete or inconsistent UX specs from reaching implementation by validating UX documentation against accessibility, platform input coverage, GDD alignment, and readiness criteria.

Core Features & Use Cases

  • Completeness gate: Checks required sections (states, data requirements, events, transitions, accessibility, localization, acceptance criteria) for both UX specs and HUD/pattern documents.
  • Cross-reference validation: Loads platform input config from .claude/docs/technical-preferences.md, validates accessibility tier and pattern library consistency, and checks referenced GDD UI requirements and player journey context when available.
  • Structured verdict output: Produces APPROVED, NEEDS REVISION, or MAJOR REVISION NEEDED with specific gaps and where they occur.

Quick Start

Run ux-review on your UX spec by telling the assistant to validate the file /design/ux/your-screen.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 implementation readiness?

Validating UX design specs for implementation readiness involves checking documentation for completeness, accessibility compliance, GDD alignment, and platform input coverage. The review produces a structured verdict identifying specific gaps requiring revision.

What sections are required in a UX spec to pass a completeness gate?

Passing a UX spec completeness gate requires specific sections: states, data requirements, events, transitions, accessibility, localization, and acceptance criteria. Missing sections trigger a revision verdict to ensure full documentation.

Can I bulk validate interaction pattern libraries and HUD designs?

You can bulk validate interaction pattern libraries and HUD designs. The review process applies bulk validation across the design/ux folder with specialized checks for hud.md and interaction-patterns.md files to ensure consistency.

Does UX spec validation check platform input coverage and accessibility tiers?

UX spec validation checks platform input coverage and accessibility tiers by loading configurations from technical-preferences.md. It ensures pattern library consistency and validates referenced GDD UI requirements and player journey context.

What is the difference between NEEDS REVISION and MAJOR REVISION NEEDED in UX review?

The difference between NEEDS REVISION and MAJOR REVISION NEEDED in UX review is the severity of identified gaps. The structured verdict output uses these distinct categories to indicate whether minor fixes or substantial rework is required for readiness.