bmad-bmb-setup

Installs and configures the BMad Builder module into a project's shared config files.

Updated May 7, 2026
One-click install
npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-bmb-setup-jgabriellima
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-bmb-setup
Source: https://github.com/jgabriellima/deep-agent-skill/tree/main/skills/bmad-bmb-setup
Command: npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-bmb-setup-jgabriellima

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Setting up the BMad Builder module requires writing consistent configuration across multiple YAML and CSV files, migrating legacy per-module configs, and cleaning up installer directories — a manual process prone to stale values and missed steps. ## Core Features & Use Cases - Guided Configuration Collection: Prompts for core settings (user name, language, output folder) and module variables defined in module.yaml, with support for headless/argument-driven installs. - Anti-Zombie Config Merging: Writes shared config.yaml and gitignored config.user.yaml via scripts that remove stale module entries before writing fresh values, and migrates legacy per-module configs as fallback defaults. - Help Registry & Cleanup: Merges module capabilities into module-help.csv and safely removes legacy installer directories after verifying skills exist at the installed location. - Use Case: After adding the BMad Builder module to a project, run this Skill to register its output folders, personal settings, and help entries in one pass, then reuse it later to reconfigure or migrate after an update. ## Quick Start Ask the agent to install and configure the BMad Builder module in this project, optionally providing values like your user name and preferred language inline.

Frequently Asked Questions about bmad-bmb-setup

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

FAQPage Schema
How do I install the BMad Builder module in a project?▼

Run the setup skill, which reads module.yaml, collects your preferences, and writes them to _bmad/config.yaml, config.user.yaml, and module-help.csv. You can pass values inline (e.g. user name and language) to skip interactive prompts.

How do I reconfigure BMad Builder settings after installation?▼

Run the setup skill again. It detects the existing module section in config.yaml, treats the run as an update, and uses an anti-zombie pattern that removes stale entries before writing fresh values.

What is the difference between config.yaml and config.user.yaml in BMad?▼

config.yaml holds shared project settings like output_folder and module variables, while config.user.yaml stores personal settings such as user_name and communication_language. The user file is intended to be gitignored so personal values never enter version control.

Does BMad setup migrate legacy per-module config files?▼

Yes. When legacy configs exist under _bmad/bmb/ or _bmad/core/, matching values are used as fallback defaults, the old files are deleted after a successful merge, and installer directories are removed once skills are verified at the installed location.

Why does BMad config use the literal {project-root} token?▼

The {project-root} token signals that a path is relative to the project root rather than the skill root, keeping configs portable. It is only resolved to a real path when creating output directories on disk.