bmad-ux

Generate and maintain DESIGN.md and EXPERIENCE.md UX specification files.

26|4|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/skyf0xx/hedgehog --skill bmad-ux-skyf0xx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-ux
Source: https://github.com/skyf0xx/hedgehog/tree/main/skills/BMAD/bmm-skills/2-plan-workflows/bmad-ux
Command: npx skills add https://github.com/skyf0xx/hedgehog --skill bmad-ux-skyf0xx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uv, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill solves the problem of inconsistent, poorly documented, or non-existent UX specifications by enforcing a rigorous, contract-based approach to design and experience documentation.

Core Features & Use Cases

  • Dual-Spine Documentation: Automatically generates and maintains DESIGN.md and EXPERIENCE.md files to separate visual identity from behavioral logic.
  • Creative Tool Integration: Invokes specialized renderers for color themes, design directions, and wireframes to visualize concepts during the discovery phase.
  • Reviewer Gate: Provides a structured validation pipeline to ensure accessibility, flow coverage, and design consistency before finalization.

Quick Start

Ask the bmad-ux skill to help you plan the user experience for your new project.

Frequently Asked Questions about bmad-ux

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

FAQPage Schema
How do I create structured UX design specifications for complex product workflows?

The dual-spine documentation system separates visual identity into DESIGN.md and behavioral logic into EXPERIENCE.md files, enforcing strict adherence to design system tokens and behavioral patterns across multi-surface application architectures.

What is the best way to maintain consistency across multi-surface application architectures?

You maintain consistency by applying automated validation rubrics and a structured reviewer gate that enforces strict adherence to design system tokens and behavioral patterns across multi-surface application architectures.

How do I visualize wireframes and design directions during the discovery phase?

You visualize concepts during the discovery phase by invoking specialized renderers for color themes, design directions, and wireframes that are integrated directly into the UX specification workflow.

Does the UX specification pipeline include validation for accessibility and flow coverage?

Yes, the pipeline includes a structured reviewer gate that provides automated validation rubrics to ensure accessibility, flow coverage, and design consistency before finalization.

Can I use this approach to separate visual identity from behavioral logic in documentation?

Yes, the dual-spine documentation system specifically isolates visual identity from behavioral logic by maintaining separate DESIGN.md and EXPERIENCE.md files for complex product workflows.

Do I need uv installed to automate design handoff processes?

Yes, uv is a required dependency needed to run the scripts that facilitate automated validation rubrics and iterative design handoff processes.