write-uxd

Authors a User Experience Document from a template with reference-anchor validation for D2R code planning.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill write-uxd-gozonerd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-uxd
Source: https://github.com/gozonerd/shadow-ai-assessment/tree/main/.claude/skills/write-uxd
Command: npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill write-uxd-gozonerd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Without a User Experience Document, code planners fall back to generic component-library defaults, producing internally consistent but visually bland output. This Skill walks you through authoring a UXD that anchors visual and interaction decisions to concrete reference apps, brand-voice choices, and polish criteria before implementation begins. ## Core Features & Use Cases - Template-Driven Authoring: Loads the UXD template and walks through all required sections, from aesthetic anchors and design tokens to accessibility-as-delight and anti-patterns. - Reference-Anchor Discipline: Rejects reference apps without screenshots and brand voices stated only as adjectives, enforcing concrete visual decisions. - ASAE Quality Gate: Runs a design-domain validation pass on the draft before saving, checking state catalogs, contrast ratios, and asset existence. - Use Case: Before running a D2R code plan for a new SvelteKit app, invoke this Skill to produce an approved UXD with screenshots, palette hex values, and per-component state catalogs saved to the project planning directory. ## Quick Start Ask the assistant to write a UXD for your project using the write-uxd skill, providing the project name and filename prefix.

Frequently Asked Questions about write-uxd

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

FAQPage Schema
How do I write a UXD for a D2R code plan?

Invoke the write-uxd skill with your project name and filename prefix. It loads the UXD template, walks you through each required section, runs an ASAE design gate on the draft, and saves the approved file to your project's planning directory.

What sections does a User Experience Document require?

Required sections cover aesthetic anchors, visual design system, interaction patterns, information architecture, accessibility-as-delight, responsive behavior, anti-patterns, reference design assets, stakeholder approvals, and open questions. Optional sections can be marked NA with justification.

Can I use reference apps without screenshots in a UXD?

No. The skill enforces reference-anchor discipline and rejects reference apps without screenshots. You must capture a screenshot, provide a public URL, or defer the reference and mark the section incomplete.

Can write-uxd run in a different Claude thread or another LLM?

Yes. Portable prompt mode generates a self-contained prompt with the template inline, project context, filename conventions, and validation checklist, so any capable LLM can author the UXD without file access.

When should I not use write-uxd standalone?

If you cannot answer the UXD-readiness questions about reference apps, brand voice, and polish criteria, the skill recommends running the ideate-to-d2r-ready orchestrator first, which handles pre-UXD interrogation before invoking this skill.