bmad-bmb-setup

Configure the BMad Builder module with shared and user settings files.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-bmb-setup-ncptuan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-bmb-setup
Source: https://github.com/ncptuan/stock_backtest_project/tree/main/.claude/skills/bmad-bmb-setup
Command: npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-bmb-setup-ncptuan

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill sets up the BMad Builder module in a project without forcing you to manually create configuration files, merge legacy settings, or clean up outdated installer directories.

Core Features & Use Cases

  • Guided module setup: Collects shared project settings and module-specific values, then writes them into the correct BMad configuration files.
  • Safe migration and cleanup: Detects legacy per-module config and help files, uses them as fallback defaults, and removes obsolete files and directories after a successful merge.
  • Operational automation: Updates module help registration, preserves user-only settings in a separate personal config file, and creates configured output directories on disk.
  • Use case: Ideal when adding BMad Builder to a new repository, updating an existing installation, or standardizing a project that still uses older _bmad/core and _bmad/bmb config layouts.

Quick Start

Ask the AI to set up the BMad Builder module for your project and accept defaults or provide your preferred user, language, and output settings.

Frequently Asked Questions about bmad-bmb-setup

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

FAQPage Schema
How do I migrate legacy _bmad configuration files to a new module layout?

Migrate legacy _bmad per-module configurations by detecting existing config and help files, using them as fallback defaults during the merge, and safely removing obsolete files after a successful update.

How do I set up project automation configuration for Claude skills?

Set up project automation by collecting shared project settings and module-specific values, then writing them into the correct BMad configuration files while preserving user-only settings in a separate personal config file.

How does YAML merging handle user settings and stale entries during a module update?

YAML merging separates user settings into a personal config file and performs anti-zombie replacement to automatically remove stale entries, ensuring only active configuration remains after the update.

Can I use BMad Builder with an existing repository that still uses older config layouts?

Yes, BMad Builder standardizes repositories using older _bmad/core and _bmad/bmb config layouts by applying guided module setup, merging legacy data, and verifying removal of redundant installer directories.

Do I need PyYAML to install and configure BMad Builder?

Yes, PyYAML is a required dependency to install and configure BMad Builder, as the skill relies on it to process the YAML merging and configuration file generation.

What is the best way to clean up redundant installer directories after a module update?

The best way to clean up redundant installer directories is through an automated module update that verifies successful configuration migration before safely removing obsolete files from the repository.