bmad-bmb-setup

Installs and configures the BMad Builder module for a project.

1|Updated Aug 3, 2025
One-click install
npx skills add https://github.com/MazenMrad/Obsidio --skill bmad-bmb-setup-mazenmrad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-bmb-setup
Source: https://github.com/MazenMrad/Obsidio/tree/main/.cursor/skills/bmad-bmb-setup
Command: npx skills add https://github.com/MazenMrad/Obsidio --skill bmad-bmb-setup-mazenmrad

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Automates the installation, configuration, and onboarding of the BMad Builder module into a project, reducing manual setup and ensuring consistent project defaults.

Core Features & Use Cases

  • Auto-installs and configures the BMad Builder module using assets/module.yaml to determine module metadata.
  • Writes and manages three key project files: {project-root}/_bmad/config.yaml, {project-root}/_bmad/config.user.yaml, and {project-root}/_bmad/module-help.csv.
  • Supports legacy migrations by merging legacy values as defaults before finalizing configuration.

Quick Start

Run the activation flow to install and configure the BMad Builder module in your project.

Frequently Asked Questions about bmad-bmb-setup

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

FAQPage Schema
How do I automate project configuration setup for BMad Builder?

To set up BMad Builder, you run the activation flow which reads assets/module.yaml for module metadata, collects your preferences, and writes three files to your project root: _bmad/config.yaml, _bmad/config.user.yaml, and _bmad/module-help.csv. It also cleans up legacy installer directories during the process.

What project files are generated when configuring a BMad module?

Configuring a BMad module generates three project-scoped files: {project-root}/_bmad/config.yaml, {project-root}/_bmad/config.user.yaml, and {project-root}/_bmad/module-help.csv. These files capture your merged preferences and legacy defaults to ensure consistent project configuration.

Do I need to install dependencies before setting up project config files with YAML?

Yes, you need to install pyyaml before setting up project config files with YAML. The Skill requires the pyyaml dependency to parse assets/module.yaml for module metadata and to write the generated YAML configuration files into your project's _bmad directory.

Can I migrate legacy configuration values when installing BMad Builder?

Yes, you can migrate legacy configuration values when installing BMad Builder. The setup process supports legacy migrations by merging legacy values as defaults before finalizing your configuration, and it cleans up legacy installer directories after generating the new config files.

What is the best way to manage project defaults for BMad Builder onboarding?

The best way to manage project defaults for BMad Builder onboarding is to use the automated setup flow that merges user preferences with legacy defaults. This ensures consistent configuration by writing consolidated settings directly into _bmad/config.yaml and config.user.yaml.