bmad-init

Load or bootstrap BMad module configuration files with templates.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-init
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-init
Source: https://github.com/amitmishra-byldd/Bmad-Note-Maker/tree/main/_bmad/core/bmad-init
Command: npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-init

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Initialize BMad project configuration and load config variables; use when any skill needs module-specific configuration values, or when setting up a new BMad project.

There are two modes: fast-path config loading when existing and an init path that guides first-time setup, writes config files, and returns ready vars. Every BMad skill should call this on activation to obtain its config vars; the script bmad_init.py lives in the skill's scripts directory and is the entry point for both modes.

Core Features & Use Cases

  • Fast path: If a module's config exists, load and return vars as JSON for immediate use.
  • Init path: When config is missing, guide through questions, write _bmad/core and _bmad/{module} config files, and return resolved vars.
  • Universal entry point: Called by any skill upon activation to obtain consistent configuration values.

Quick Start

Run python bmad_init.py load --module <module_code> --all --project-root /path/to/project to fetch all vars, or use check to bootstrap when needed.

Frequently Asked Questions about bmad-init

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

FAQPage Schema
How do I initialize configuration for a BMad project?▼

BMad project configuration initialization guides first-time setup by writing _bmad/core and _bmad/{module} config files with templates, resolving placeholders like {project-root}, and returning ready vars.

How do I load module-specific configuration values using YAML?▼

Loading module-specific configuration uses a fast path that reads existing YAML config files and returns vars as JSON for immediate use, triggered by running bmad_init.py load --module <code> --all.

When do I need to bootstrap project config files?▼

Bootstrapping project config files is needed when a module's configuration is missing, triggering the init path that guides through questions, writes config files, and returns resolved vars.

Does bmad_init require PyYAML to resolve config templates?▼

Yes, bmad_init requires PyYAML to parse YAML configuration files, resolve placeholders like {project-root}, and apply result templates during the initialization and fast-path loading processes.

What is the best way to ensure consistent configuration variables across BMad skills?▼

The best way to ensure consistent configuration variables is to have every BMad skill call bmad_init.py upon activation to obtain its config vars, enforcing config file creation under _bmad directories.

Why does my BMad skill activation fail to find configuration values?▼

BMad skill activation fails to find configuration values when the _bmad/core or _bmad/{module} config files are missing, requiring you to run the init path to generate them.