bmad-ux

Generate DESIGN.md and EXPERIENCE.md files for UX specifications.

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

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 addresses the fragmentation between product vision and design execution by facilitating the creation of structured, contract-based UX specifications that ensure consistency across visual and behavioral layers.

Core Features & Use Cases

  • Dual-Spine Architecture: Generates synchronized 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 options before finalization.
  • Reviewer Gate: Provides a multi-lens validation pipeline to ensure accessibility, editorial quality, and design system compliance.

Quick Start

Invoke the bmad-ux skill to begin planning the user experience for your new project by following the guided elicitation process.

Frequently Asked Questions about bmad-ux

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

FAQPage Schema
How do I create UX design specifications that stay consistent across visual and behavioral layers?

To create consistent UX design specifications, this Skill uses a dual-spine architecture that generates synchronized DESIGN.md and EXPERIENCE.md files, separating visual identity from behavioral logic to maintain alignment across both layers.

What is a contract-based approach to UX specifications and when do I need it?

Contract-based UX specifications are structured documents that capture design intent as enforceable visual and behavioral contracts. You need this approach when product vision and design execution fragment and require structured consistency across multiple platforms.

How do I validate accessibility and design system compliance before finalizing a UX spec?

You validate accessibility and design system compliance using a multi-lens reviewer gate pipeline that checks editorial quality and adherence to established design systems, ensuring UX specifications meet accessibility standards before finalization.

Do I need uv installed to use this UX specification workflow?

Yes, you need uv installed as a runtime dependency. The Skill requires uv to execute its scripts and reference components, which support the guided elicitation process for planning user experiences and generating design specifications.

Can I visualize wireframes and color themes before committing to a final UX specification?

Yes, you can visualize wireframes and color themes before finalization. The Skill integrates specialized renderers for color themes, design directions, and wireframes, allowing you to review visual options through creative tool integration before locking in specifications.

What's the best way to manage information architecture across multiple platforms in a design system?

The best way to manage information architecture across platforms is through the guided elicitation process this Skill provides, which captures design intent and validates it against your established design system to ensure cross-platform consistency.