skills.rest
xoai
xoaiCOMMUNITY
Explore all skills by this author →
𝕏@xoaiGitHub

ux-specify

Enrich feature specifications with UX requirements, error states, and accessibility notes.

25|7|Updated Mar 16, 2026
Search Tags:#design#planning#accessibility#specification#user experience#ux
One-click install
npx skills add https://github.com/xoai/sage --skill ux-specify
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ux-specify
Source: https://github.com/xoai/sage/tree/main/skills/ux-specify
Command: npx skills add https://github.com/xoai/sage --skill ux-specify

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that feature specifications are not just technically sound but also deeply consider the user experience, including usability, accessibility, and error handling.

Core Features & Use Cases

  • Error State Inventory: Automatically identifies and documents potential failure points for user actions.
  • UX Acceptance Criteria: Generates testable criteria based on usability principles.
  • Accessibility Notes: Flags specific accessibility considerations for implementation.
  • Five-Planes Analysis: Provides a comprehensive UX review using Garrett's framework.
  • Use Case: After a developer writes a feature specification, this Skill enriches it with detailed UX requirements, ensuring the final product is intuitive and accessible.

Quick Start

Enrich the current feature specification with UX requirements, focusing on error states and accessibility.

Frequently Asked Questions about ux-specify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add accessibility requirements to a feature specification?▼

To add accessibility requirements to a feature specification, you enrich it with detailed UX notes that flag specific accessibility considerations for implementation. This ensures your technical specs align with usability principles and address potential user barriers.

What is the five-planes analysis in user experience design?▼

The five-planes analysis is a comprehensive UX review using Garrett's framework. It evaluates feature specifications across strategy, scope, structure, skeleton, and surface planes to ensure final products align deeply with user needs and usability principles.

How do I document error states and user flows for a new feature?▼

To document error states and user flows for a new feature, you enrich your specification with detailed UX requirements. This process automatically identifies potential failure points for user actions and integrates journey maps to map out the complete user experience.

Can I generate UX acceptance criteria from an existing technical specification?▼

Yes, you can generate UX acceptance criteria from an existing technical specification. The process analyzes your feature spec and automatically creates testable criteria based on core usability principles and user-context notes.

What is the best way to align feature specifications with user needs?▼

The best way to align feature specifications with user needs is to integrate persona profiles, journey maps, and user-context notes directly into your technical specs. This ensures the final product is intuitive, accessible, and deeply considers the actual user experience.

Related Skills

Explore More Design & Creative Skills→
hoonzinopehoonzinope

uiux-engineer

Draft a UI/UX design document covering goals, personas, user flows, and states.

Community
Intermediate
aj-geddesaj-geddes
472

UX Designer

Design user flows and ASCII wireframes with WCAG 2.1 AA accessibility specifications.

Community
Basic
ShaheerKhawajaShaheerKhawaja
8

ux-genie

Derive personas, user stories, and journey maps from UI guidelines.

Community
Advanced
alexandephiliaalexandephilia

codebase-context

Index project codebases to generate stack, structure, and component inventories.

Community
Intermediate