bmad-init

Initialize and load BMad module configuration from YAML files.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Yukine5377/common --skill bmad-init-yukine5377
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-init
Source: https://github.com/Yukine5377/common/tree/main/.cursor/skills/bmad-init
Command: npx skills add https://github.com/Yukine5377/common --skill bmad-init-yukine5377

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

The BMad Init skill bootstraps and loads configuration for BMad projects, streamlining setup and retrieval of module-specific variables so skills can run with consistent settings.

Core Features & Use Cases

  • Fast-path load: returns existing core and module variables as JSON to speed activation.
  • Init Path: guides first-time configuration when config is missing, writing core and module config files.
  • Module discovery: resolves module metadata via module.yaml located in skill assets, root, or _bmad installations.

Quick Start

Run the bmad_init.py script to bootstrap and load configuration for a module.

Frequently Asked Questions about bmad-init

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

FAQPage Schema
How do I bootstrap project configuration variables for a new module?

To load project configuration variables, the tool uses a fast-path load that returns existing core and module variables as JSON. This speeds up activation by quickly retrieving settings from YAML config files under _bmad/core and _bmad/{module}.

How does module discovery work when resolving YAML config files?

Module discovery works by resolving module metadata via module.yaml located in skill assets, root, or _bmad installations. It reads and writes YAML config files under _bmad/core and _bmad/{module} to manage settings.

Do I need pyyaml installed to initialize BMad project config?

Yes, you need pyyaml installed to initialize BMad project config because the skill depends on it to read and write YAML config files. It is a required dependency for resolving module definitions and handling configuration variables.

What is the best way to resolve {project-root} placeholders in module configuration?

The best way to resolve {project-root} placeholders in module configuration is by using the resolve-defaults command. This command processes placeholders within YAML config files during the initialization and loading of BMad configuration variables.

Why does my configuration setup not working when config files are missing?

Configuration setup fails when config files are missing because the fast-path load cannot return existing variables. You must trigger the Init Path, which guides first-time configuration by writing the missing core and module config files.