bmad-init

Overview

This skill is the configuration entry point for all BMad skills. It has two modes:

• Fast path: Config exists for the requested module — returns vars as JSON. Done.
• Init path: Config is missing — walks the user through configuration, writes config files, then returns vars.

Every BMad skill should call this on activation to get its config vars. The caller never needs to know whether init happened — they just get their config back.

The script bmad_init.py is located in this skill's scripts/ directory. Locate and run it using python for all commands below.

On Activation — Fast Path

Run the bmad_init.py script with the load subcommand. Pass --project-root set to the project root directory.

• If a module code was provided by the calling skill, include --module {module_code}
• To load all vars, include --all
• To request specific variables with defaults, use --vars var1:default1,var2
• If no module was specified, omit --module to get core vars only