ux-spec

Generates per-screen UX specification documents through a structured interview covering content, actions, states, and flows.

Updated May 24, 2026
One-click install
npx skills add https://github.com/pirras-torres/pirras-marketplace --skill ux-spec-pirras-torres
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ux-spec
Source: https://github.com/pirras-torres/pirras-marketplace/tree/main/plugins/pi-dev/skills/ux-spec
Command: npx skills add https://github.com/pirras-torres/pirras-marketplace --skill ux-spec-pirras-torres

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing UX specifications screen by screen is slow and often inconsistent, and teams frequently mix visual design details into UX docs. This Skill runs a structured interview that captures content, actions, states, and navigation for every screen, then writes clean Markdown files to docs/03_design/. ## Core Features & Use Cases - Screen-by-screen interview: Walks through each screen one at a time, capturing what the user sees, available actions, action outcomes, and empty/loading/error/partial states. - Cross-screen flow documentation: Records multi-screen flows with triggers, steps, decision points, and failure states in a dedicated ux_flows.md file. - Context-aware setup: Reads existing PRD, personas, product journey, and domain model docs before asking questions, and auto-detects the docs folder. - Use Case: After defining personas and a product journey for a finance app, run this Skill to produce ux_dashboard.md, ux_account_detail.md, and ux_flows.md covering every screen and the payment flow, ready to hand to a UI designer. ## Quick Start Ask the assistant to create a UX specification for your product using the ux-spec skill and answer the screen-by-screen interview questions.

Frequently Asked Questions about ux-spec

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

FAQPage Schema
How do I write a UX specification for my product?▼

Run the ux-spec skill, which interviews you screen by screen about content, actions, states, and navigation, then writes one Markdown file per screen into docs/03_design/. It reads your PRD, personas, and domain model first so questions are grounded in existing context.

What is the difference between a UX spec and a UI spec?▼

A UX spec documents what users see as information, what actions they can take, and what happens in each state, without any visual details. Colors, typography, spacing, and component choices belong in the UI spec, which this skill explicitly excludes and defers to the ui-spec skill.

What documents do I need before creating a UX specification?▼

The skill reads docs/01_product/01_prd.md, 04_personas.md, 05_product_journey.md, and docs/02_business/domain_model.md before starting. Having these product and domain documents in place ensures the interview questions and interaction rules reference real entities and user context.

How are cross-screen user flows documented?▼

After all screens are covered, the skill asks about flows spanning multiple screens and writes them to docs/03_design/ux_flows.md. Each flow records its trigger, ordered steps, decision points, failure states, and end state.

What are the limitations of this UX documentation approach?▼

The skill deliberately excludes all visual design concerns such as layout, colors, and component names, so it cannot replace a UI specification or design mockups. It also depends on the quality of your answers during the interview and on upstream product documents being current.