{setup-skill-name}

Install and configure BMad modules by merging module.yaml and user answers into config files.

Updated May 5, 2026
One-click install
npx skills add https://github.com/b566776/whitebox --skill setup-skill-name-b566776
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: {setup-skill-name}
Source: https://github.com/b566776/whitebox/tree/main/.gemini/skills/bmad-module-builder/assets/setup-skill-template
Command: npx skills add https://github.com/b566776/whitebox --skill setup-skill-name-b566776

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Automates the setup of BMad modules inside a project by reading module metadata and user answers, then configuring core and per-module values so deployments are repeatable and scalable across teams.

Core Features & Use Cases

  • Auto-merge core and module settings into the shared _bmad/config.yaml, with anti-zombie behavior to replace existing module sections.
  • Maintain per-user preferences in _bmad/config.user.yaml while keeping sensitive values out of the shared config.
  • Support legacy migrations by consuming legacy dir values as fallbacks and cleaning up old config files.

Quick Start

Provide the module.yaml and the answers JSON, then run the setup to install or configure the module.

Frequently Asked Questions about {setup-skill-name}

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

FAQPage Schema
How do I automate module setup and merge configs into _bmad/config.yaml?

To automate module setup, provide a module.yaml and user answers JSON to the setup process. It merges core and module settings into _bmad/config.yaml using an anti-zombie strategy that cleanly replaces existing module sections for repeatable deployments.

What is the anti-zombie strategy when merging yaml configurations?

The anti-zombie strategy is a configuration merge mechanism that overwrites existing module sections in _bmad/config.yaml. It prevents obsolete or orphaned settings from persisting when a new module is installed or an existing one is reconfigured.

How do I migrate legacy configuration settings during a module setup?

To migrate legacy settings, the setup reads legacy directory values as fallbacks and automatically cleans up old configuration files. This ensures smooth transitions when applying new module.yaml configurations to a project.

Can I keep per-user preferences separate from the shared config.yaml?

Yes, you can maintain per-user preferences in _bmad/config.user.yaml. This separates sensitive or individual values from the shared _bmad/config.yaml, keeping team deployments scalable without exposing personal configurations.

What inputs do I need to provide to install a BMad module?

You need to provide the module.yaml file containing module metadata and an answers JSON object with your specific configurations. The setup consumes these inputs to install and configure the BMad module into your project.

Why are my old configuration files not working after a module update?

Old configuration files may conflict with new module settings due to legacy formats. The setup process addresses this by consuming legacy directory values as fallbacks and performing a cleanup of old config files during the migration.