bmad-ux

Elicit UX decisions and produce DESIGN.md and EXPERIENCE.md specification documents.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-ux-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-ux
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-ux
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-ux-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Turning vague product ideas into concrete, consistent UX specifications is hard: visual identity, information architecture, states, and accessibility decisions get scattered across conversations and never become a durable contract for downstream design and engineering work. ## Core Features & Use Cases - Dual specification output: Facilitates a structured discovery dialogue and distills decisions into DESIGN.md (visual identity tokens per the Google Labs design.md spec) and EXPERIENCE.md (information architecture, component behavior, state patterns, accessibility floor, and key user flows). - Creative rendering tools: Generates HTML color-theme comparisons, visual design directions, Excalidraw wireframes, and key-screen mockups so users can pick options visually instead of abstractly. - Validation and review: Runs an opt-in multi-lens reviewer gate (rubric walker plus accessibility and custom reviewers) that audits flow coverage, token completeness, and component coverage, producing consolidated HTML and Markdown validation reports. - Use Case: A product manager starting a new app says "let's create UX design"; the skill interviews them about brand, platforms, and user journeys, renders theme options, and delivers finalized DESIGN.md and EXPERIENCE.md files ready for architecture and story breakdown. ## Quick Start Ask the assistant to create a UX design for your product and answer its discovery questions about brand, platforms, and key user journeys.

Frequently Asked Questions about bmad-ux

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

FAQPage Schema
How do I create a UX design specification with this skill?

Invoke the skill with a request like "let's create UX design" and it runs a discovery dialogue covering brand, platforms, stakes, and user journeys. Decisions are logged to a memlog and distilled into DESIGN.md and EXPERIENCE.md at finalization.

What is the difference between DESIGN.md and EXPERIENCE.md?

DESIGN.md owns how the product looks: color, typography, spacing, shape, and component visual tokens following the Google Labs design.md spec. EXPERIENCE.md owns how it behaves: information architecture, voice, state patterns, interaction primitives, accessibility, and key flows.

Does the skill support design systems like shadcn or MUI?

Yes. When a UI system is named in the Foundation section, both documents inherit from it. DESIGN.md specifies only brand-layer token deltas over the system defaults, and EXPERIENCE.md specifies only the behavioral differences.

Can I validate an existing UX specification instead of creating one?

Yes. Validate mode critiques an existing DESIGN.md and EXPERIENCE.md pair without changing them, running a rubric walker across eight categories plus optional reviewer lenses, and writing consolidated HTML and Markdown validation reports.

Can the skill run headless in an automated pipeline?

Yes. Headless mode accepts a structured payload with intent (create, update, or validate) and inputs, skips greetings and interactive prompts, and ends with a JSON result containing status, artifact paths, assumptions, and open questions.

What are the limitations of the generated UX documents?

The skill captures and distills user decisions rather than inventing them, so unresolved questions remain as open items or assumption tags. Visual mockups are illustrative references; the spine documents remain the authoritative contract on any conflict.