bmad-builder-setup

Install and configure the BMad Builder module with config files and legacy migration.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-builder-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-builder-setup
Source: https://github.com/florian-trehaut/bmad-global/tree/main/src/core-skills/bmad-builder-setup
Command: npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-builder-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Installs and configures the BMad Builder module into a project, ensuring consistent project setup and module metadata.

Core Features & Use Cases

  • Installs the BMad Builder module into {project-root}/_bmad and registers module help.
  • Generates and migrates configuration files:
    • {project-root}/_bmad/config.yaml (shared core settings)
    • {project-root}/_bmad/config.user.yaml (user-specific settings)
    • {project-root}/_bmad/module-help.csv (module capabilities)
  • Supports legacy-migration flow to carry forward prior settings and cleans up old files after a successful merge.

Quick Start

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

Frequently Asked Questions about bmad-builder-setup

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

FAQPage Schema
How do I install and configure the BMad Builder module in my project?

To install the BMad Builder module, run the setup script which deploys it into your project root directory, validates the module metadata, and prompts for your specific preferences to generate the necessary configuration files.

How does legacy migration work when updating BMad Builder configuration files?

Legacy migration carries forward your prior settings from older configuration files, merges them into the new config.yaml and config.user.yaml formats, and automatically cleans up obsolete files after a successful merge to preserve existing project behavior.

What configuration files are generated during BMad Builder module setup?

The setup generates a shared config.yaml for core settings, a config.user.yaml for user-specific preferences, and a module-help.csv documenting module capabilities, all placed directly within the project's root directory structure.

Does the BMad Builder setup process require any specific Python dependencies?

Yes, the setup requires the pyyaml dependency to parse, validate, and write the YAML configuration files needed to properly install and configure the BMad Builder module within your development environment.

Can I preserve my existing anti-zombie behavior when updating the module configuration?

Yes, the setup explicitly preserves anti-zombie behavior during module updates by validating the existing module.yaml and safely migrating your prior settings into the newly generated configuration files without losing active states.

What is the best way to register module help capabilities for my project setup?

The setup automatically registers module help by generating a module-help.csv file that documents module capabilities, ensuring your project setup maintains consistent metadata and accurate help documentation for the installed module.