bmad-ux

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

1|Updated Sep 18, 2026
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill bmad-ux-pastasus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-ux
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/bmad-ux
Command: npx skills add https://github.com/PastaSus/egg-defender --skill bmad-ux-pastasus

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Turning a vague product vision into concrete, developer-ready UX specifications is slow and inconsistent. This Skill facilitates a structured discovery conversation and distills the results into two canonical documents: DESIGN.md (visual identity per the Google Labs spec) and EXPERIENCE.md (information architecture, behavior, states, and flows). ## Core Features & Use Cases - Facilitated UX Discovery: Elicits the user's vision through probing questions, named-protagonist journeys, and concern scans, logging every decision to a memlog without imposing design opinions. - Dual Specification Output: Produces DESIGN.md (colors, typography, spacing, components as YAML tokens plus prose) and EXPERIENCE.md (IA, state patterns, interaction primitives, accessibility floor, key flows) with cross-referenced tokens. - Creative Rendering Tools: Generates HTML color themes, design directions, Excalidraw wireframes, and key-screen mockups so users can pick visuals instead of describing them. - Validation & Reviewer Gate: Runs rubric-based and lens-selectable parallel reviewer passes that produce consolidated HTML/Markdown validation reports. - Use Case: A founder says "lets create UX design" for a journaling app; the Skill interviews them, renders theme options, and delivers final DESIGN.md and EXPERIENCE.md files ready for architecture and story breakdown. ## Quick Start Ask the assistant to create UX specifications for your product idea 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?

Say "lets create UX design" or "help me plan the UX" to activate it. The skill runs a discovery conversation about your product, renders visual options like color themes and wireframes, then distills decisions into DESIGN.md and EXPERIENCE.md files.

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

DESIGN.md owns how the product looks: color, typography, spacing, and component tokens per the Google Labs spec. EXPERIENCE.md owns how it behaves: information architecture, state patterns, interaction primitives, accessibility, and key flows, referencing DESIGN.md tokens by name.

Does it work with design systems like shadcn or Material UI?

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

Can it validate an existing UX specification?

Yes, the Validate intent critiques an existing DESIGN.md and EXPERIENCE.md pair using a rubric walker covering flow, token, component, and state coverage, plus optional reviewer lenses. It writes consolidated HTML and Markdown validation reports without modifying the spines.

Can I resume an unfinished UX design session?

Yes. On Create intent it scans the output path for prior in-progress run folders whose DESIGN.md status is not final and offers to resume. All decisions persist in a .memlog.md file that a resumed run reloads.

Does it support headless or automated runs?

Yes. When invoked headless it skips greetings and questions, infers intent from provided inputs, and ends with a structured JSON payload describing status, produced artifacts, assumptions, and open questions.