ux-review

Validate UX specs, HUD designs, and interaction patterns for implementation readiness.

Updated May 13, 2026
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill ux-review-francisvarga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ux-review
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/ux-review
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill ux-review-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures a UX spec, HUD design, or interaction pattern library is complete, consistent with the GDD, and ready to implement—without missing accessibility or player-need requirements.

Core Features & Use Cases

  • UX Spec quality gate: Checks required sections for player need, navigation, entry/exit, layout/component inventory, states/variants, interaction mapping, data requirements, events, transitions, accessibility, localization, and acceptance criteria.
  • HUD-focused validation: Verifies HUD philosophy, information architecture coverage, zones/safe margins, per-element specifications, gameplay-context states, visual budget, platform adaptation, and tuning knobs.
  • Pattern library consistency checks: Confirms the pattern catalog is current and that standard and required game-specific patterns include state specs, accessibility specs, implementation notes, and non-conflicting behaviors.
  • Verdict-driven handoff: Produces APPROVED / NEEDS REVISION / MAJOR REVISION NEEDED with specific gaps and where to fix them.

Quick Start

Run ux-review for a single UX file, 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 a UX spec for accessibility and implementation readiness?

Validating a UX spec for accessibility requires parsing required sections like player needs, navigation, states, and accessibility compliance. The process cross-references technical preferences and GDD UI requirements to produce a structured verdict with blocking or advisory issues.

What is included in a HUD design quality gate check?

A HUD design quality gate verifies HUD philosophy, information architecture coverage, zones, safe margins, per-element specifications, gameplay-context states, visual budget, platform adaptation, and tuning knobs to ensure completeness before implementation.

How do I check if my interaction pattern library is ready for handoff?

Checking an interaction pattern library involves confirming the catalog is current and that standard and game-specific patterns include state specs, accessibility specs, implementation notes, and non-conflicting behaviors before producing an approval verdict.

Can I batch validate multiple UX files across a design directory?

Yes, you can batch validate multiple UX files by running a batch validation command across the design/ux directory, parsing all required sections and cross-referencing GDD alignment to produce structured verdicts for each file.

What does a UX spec validation verdict include?

A UX spec validation verdict includes an APPROVED, NEEDS REVISION, or MAJOR REVISION NEEDED status, accompanied by specific gaps and advisory issues detailing exactly where to fix blocking problems in the design.

Does UX spec validation require write access to the design files?

UX spec validation requires read-only access by parsing required sections and cross-referencing technical preferences, accessibility requirements, and GDD UI requirements without modifying the original design files.