ux-review

Validate UX specifications for completeness, accessibility, and design alignment.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/scomofo/dragon-forge --skill ux-review-scomofo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ux-review
Source: https://github.com/scomofo/dragon-forge/tree/main/.agents/skills/ux-review
Command: npx skills add https://github.com/scomofo/dragon-forge --skill ux-review-scomofo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents costly rework by validating UX specs for completeness, accessibility compliance, GDD alignment, and implementation readiness before they move into production workflows.

Core Features & Use Cases

  • Spec completeness & quality gating: Checks required UX sections and identifies missing states, criteria, and interaction mapping gaps.
  • Cross-reference validation: Loads input/platform configuration and accessibility tier requirements to ensure the spec matches the game’s authoritative constraints.
  • HUD and pattern-library verification: Optionally validates HUD-focused specs and checks consistency with the interaction pattern library.

Quick Start

Run ux-review on design/ux/hud-design.md to produce an APPROVED, NEEDS REVISION, or MAJOR REVISION NEEDED verdict with specific gaps to fix.

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 specs for accessibility and completeness before handoff?

You validate UX specs by running a structured checklist review that cross-references input configurations and accessibility tier requirements. This process identifies missing states, criteria, and interaction mapping gaps, producing an APPROVED or NEEDS REVISION verdict with enumerated blocking and advisory gaps to fix.

What is the best way to check HUD designs for consistency with an interaction pattern library?

Checking HUD designs for pattern consistency requires loading the interaction pattern library as cross-reference context during the spec review. This validates HUD-focused specs against established interaction patterns, ensuring alignment and identifying specific deviations or missing states before implementation.

How does cross-reference validation ensure UX specs align with Game Design Documents (GDD)?

Cross-reference validation ensures GDD alignment by loading authoritative game architecture and design constraints into the review process. The UX spec is checked against these input and platform configuration documents to verify that interaction patterns and screen flows match the game's defined requirements.

Can I review a single UX screen file, or do I need to validate the entire interaction flow?

You can review a single UX screen file by using argument parsing for single-file scopes, or you can validate broader interaction flows using preset scopes. The review applies structured checklist validation to the specified scope and outputs a verdict with specific gaps to address.

What is the difference between blocking and advisory gaps in a UX spec review?

Blocking gaps are critical issues that prevent implementation readiness, while advisory gaps are recommended improvements that do not halt production. The UX spec review verdict enumerates both types separately so teams can prioritize fixing blocking issues before handoff.

When do I need to run a UX spec quality gate in the development pipeline?

You need to run a UX spec quality gate before moving designs into production workflows to prevent costly rework. It validates spec completeness, accessibility compliance, and implementation readiness during the UX-to-implementation handoff pipeline, ensuring all required sections and states are defined.