write-ux-spec

Writes or updates a UX specification document for one screen or flow through guided interview and independent review.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/sagittaras/agentic-workflow --skill write-ux-spec-sagittaras
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-ux-spec
Source: https://github.com/sagittaras/agentic-workflow/tree/main/skills/write-ux-spec
Command: npx skills add https://github.com/sagittaras/agentic-workflow --skill write-ux-spec-sagittaras

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a screen specification that an implementer can build from without follow-up questions is hard: project-wide standards get silently overridden, layout decisions stay in the designer's head, and vague sentences become implementation bugs. This Skill produces a binding UX spec for one screen or flow by separating cited project invariants from original design decisions extracted through a structured interview. ## Core Features & Use Cases - Standards extraction: Mines the project's art bible, ADRs, rules, and neighboring specs for invariants that are cited rather than re-decided. - Batched interview: Asks the user only about the original design of the screen — composition, layout, states, interactions — in scoped question batches with recommended options. - Template-driven writing: Selects optional modules (arrival context, transitions) based on the screen's nature and writes against a binding template with numbered sections and acceptance criteria. - Autonomous review loop: Submits the approved draft to an independent reviewer subagent with a clean context, iterates on blocking findings, and escalates after repeated failures. - Use Case: Ask to document a new inventory screen; the Skill reads the art bible, interviews you about zones and components, writes the numbered spec, gets it reviewed, and hands back a document ready for implementation issues. ## Quick Start Ask the assistant to write a UX spec for the screen or flow you want documented, naming the screen or an existing spec number to update.

Frequently Asked Questions about write-ux-spec

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

FAQPage Schema
How do I write a UX specification for a screen?

Invoke the skill with the screen or flow name; it reads the project's art bible and ADRs for existing standards, interviews you in batches about layout, states, and interactions, then writes the spec from a binding template and gets it independently reviewed.

What should a UX spec document contain?

The template requires a metadata header, user need and goals, navigation position, entry and exit points, a wireframe with zones and component inventory, state and interaction tables, data requirements, accessibility specifics, binary acceptance criteria, and owned open questions.

When should I not use a UX spec workflow?

Do not use it for project-wide visual standards like palettes and typography, which belong in an art bible, nor for architectural decisions, informal design brainstorming, or reviewing an already finished spec.

Can the skill update an existing UX spec instead of creating one?

Yes. It detects an existing spec for the screen, reads it fully before interviewing, and applies targeted edits rather than a full rewrite, updating the last-modified date while preserving the last-verified date.

What happens if the project has no art bible?

The skill reports the missing art bible and lets the user decide whether to proceed with visual standards extracted from code or first create an art bible, since without one the spec would invent per-screen visual decisions.