ux-review

Validate UX design documents for completeness, accessibility, and GDD alignment.

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill ux-review-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ux-review
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/ux-review
Command: npx skills add https://github.com/imgamer/AILearn --skill ux-review-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents incomplete or inaccessible UX specs from reaching implementation by validating UX documents against completeness, accessibility, GDD alignment, and implementation readiness requirements.

Core Features & Use Cases

  • UX spec quality gate: Reviews UX documents for required sections, player-perspective clarity, interaction completeness, and testable acceptance criteria.
  • HUD and interaction consistency checks: Validates HUD design completeness (states, visual budget, layout zones) and ensures HUD elements align with GDD UI requirements.
  • Pattern library compliance: Confirms interaction patterns are consistent with the existing library and flags when new patterns need to be added.

Quick Start

Use the ux-review skill to validate a specific UX spec file like /ux-review design/ux/inventory.md and return an APPROVED or NEEDS REVISION verdict with exact 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 a UX design document for implementation readiness?

A UX review validates your UX design document by checking for required sections, player-perspective clarity, and testable acceptance criteria. It outputs a structured verdict identifying blocking issues versus advisory gaps to ensure implementation readiness.

What is included in a HUD design completeness check?

A HUD design completeness check validates layout zones, state coverage, and visual budget constraints. It ensures HUD elements align with Game Design Document UI requirements to maintain interface consistency across the player journey.

How do I check if my interaction patterns match an existing pattern library?

Checking interaction pattern library compliance involves comparing your new UX specs against established interaction patterns. This process flags inconsistencies with existing library standards and identifies when new patterns need to be formally added for platform-specific input coverage.

Can I review UX specs for accessibility compliance and platform-specific input coverage?

Yes, you can review UX specs for accessibility compliance and platform-specific input coverage. The validation process cross-references technical preferences and design requirements to ensure your interface handles diverse player-journey contexts and platform inputs.

Does game UX review verify alignment with the Game Design Document?

Yes, game UX review verifies alignment with the Game Design Document (GDD) by cross-referencing your UX documents against design requirements. This ensures HUD elements and interaction patterns match the intended player experience and technical preferences.

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

In a UX spec review, blocking issues are critical gaps that prevent implementation readiness, such as missing states or incomplete player-journey context. Advisory issues are non-critical recommendations that do not halt development but should be addressed to improve overall interface quality.