ux-review

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates UX design documents before they enter the implementation pipeline, serving as the quality gate between UX Design and Visual Design/Implementation in the /team-ui pipeline.

Core Features & Use Cases

  • Completeness & Consistency: ensures required headers, sections, and cross-references exist across UX specs.
  • Accessibility & Alignment: checks accessibility requirements, GDD/UI alignment, and readiness for handoff to development.
  • Handoff Readiness: generates a clear verdict (APPROVED / NEEDS REVISION / MAJOR REVISION NEEDED) with concrete gaps for follow-up.

Quick Start

Provide the path to a UX spec file (or use all to validate every UX document in the design folder).

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 handoff?

To validate UX design specs, the tool checks required headers, sections, and cross-references to ensure completeness before handoff. It serves as a quality gate between UX Design and implementation in the design pipeline.

Can I check accessibility requirements across multiple UX documents at once?

Yes, you can check accessibility requirements across multiple UX documents by using the default 'all' scope. This validates every UX document in the design folder for accessibility and GDD alignment.

What is a UX spec quality gate and how does it work?

A UX spec quality gate validates design documents to ensure readiness before they enter the implementation pipeline. It loads cross-reference context, checks header metadata, and reports verdicts with concrete gaps for follow-up.

How do I know if my UX design is ready for development handoff?

To determine development handoff readiness, the review generates a clear verdict of APPROVED, NEEDS REVISION, or MAJOR REVISION NEEDED. This verdict is accompanied by concrete gaps requiring follow-up actions.

Does UX spec validation require any specific design frameworks or dependencies?

No specific design frameworks or dependencies are required to run UX spec validation. The tool operates independently to analyze your design documents and check alignment with GDDs.

What happens if my UX design documents are missing required sections?

If UX design documents are missing required sections, the validation process will report a MAJOR REVISION NEEDED or NEEDS REVISION verdict. It identifies and lists concrete gaps for your follow-up corrections.