bmad-init

Load or initialize BMad module configuration variables from YAML configs.

2|Updated Apr 2, 2026

Search Tags:#project setup #yaml #governance #bmad #configuration bootstrap #template expansion

Ready to run

npx skills add https://github.com/cassioalexandre/agf --skill bmad-init-cassioalexandre

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bmad-init
Source: https://github.com/cassioalexandre/agf/tree/main/_bmad/core/bmad-init
Command: npx skills add https://github.com/cassioalexandre/agf --skill bmad-init-cassioalexandre

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill removes the friction of setting up BMad by automatically loading existing configuration variables or guiding first-time initialization.

Core Features & Use Cases

Fast-path config loading: Loads module configuration variables as JSON when the corresponding _bmad/{module}/config.yaml already exists.
Interactive first-time setup: Runs an init flow when configuration is missing, including core setup before module setup.
Module-aware variable resolution: Resolves module module.yaml questions, expands defaults (including {project-root}), writes flat YAML configs, and returns the final resolved variables to the calling skill.
Use case: When a new skill is added to .agents/skills/, run initialization once so agents can immediately access module-specific config variables without manual edits.

Quick Start

Ask an agent to initialize or load BMad configuration variables by running this skill for the target module: bmad-init with load and project-root set to your repository root.

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 in YAML?▼

To bootstrap project configuration variables, you initialize module-specific settings by parsing YAML files, expanding defaults like {project-root}, and writing flat configs to _bmad/{module}/config.yaml so agents can immediately access resolved variables.

What is the best way to load existing module configuration variables without manual edits?▼

Loading existing module configuration is done through a fast-path mechanism that reads the corresponding _bmad/{module}/config.yaml file and returns the resolved variables as JSON to the calling application or skill.

Does interactive project setup work when core configuration files are missing?▼

Interactive project setup handles missing configuration by running an initialization flow that establishes core setup first, then resolves module-level questions and writes the necessary YAML config files automatically.

Can I resolve module-specific template defaults and write them to a config file automatically?▼

Resolving module-specific template defaults is supported by executing deterministic subcommands that expand placeholders, apply default resolutions, and generate the final config.yaml file under the _bmad directory structure.

Do I need PyYAML installed to parse configuration files during project setup?▼

PyYAML is required to perform YAML parsing, template default resolution, and config file generation, ensuring that module configuration variables are correctly loaded and written as flat YAML files.

Why does first-time project setup require both core and module initialization steps?▼

First-time project setup requires core initialization before module setup to ensure that foundational governance variables are established, allowing module-specific questions and templates to resolve consistently across the configuration hierarchy.