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.