bmad-init

Bootstrap and load BMad project configuration by generating core and module vars.

4|1|Updated Sep 30, 2024
One-click install
npx skills add https://github.com/co-cddo/ndx --skill bmad-init-co-cddo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-init
Source: https://github.com/co-cddo/ndx/tree/main/_bmad/core/bmad-init
Command: npx skills add https://github.com/co-cddo/ndx --skill bmad-init-co-cddo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill automates the bootstrap and loading of BMad project configuration, ensuring consistent access to core and module variables across skills and environments.

Core Features & Use Cases

  • Fast-path config loading: retrieve core and module vars from per-module YAML configs for immediate use.
  • Init workflow: guide first-time setup when a module config is missing and write the necessary files under the _bmad tree.
  • Template expansion: resolve default values and apply result templates to produce deployment-ready config.
  • Directory management: automatically create required directories defined in module.yaml as needed.

Quick Start

Run the bmad_init.py script with the load command for your module to fetch its configuration values.

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 and load YAML variables automatically?

Bootstrapping project configuration involves discovering the project root, resolving module templates, and writing YAML config files to automatically generate core and module variables for your environment.

What is the best way to load module-specific YAML config on the fly?

Loading module-specific YAML config on the fly requires a fast-path load command that reads per-module YAML files to retrieve core and module vars for immediate application use.

Do I need pyyaml to resolve templates and expand default values?

Yes, pyyaml is required to parse YAML config files and apply template expansion to resolve default values during the configuration bootstrap process.

How do I set up module configuration when the YAML config file is missing?

When a module config is missing, you trigger an init workflow that automatically creates required directories and writes the necessary YAML files under the project tree to establish configuration.

Why does template expansion fail during directory management setup?

Template expansion fails during directory management when project root discovery cannot locate module templates, but robust error handling catches missing directories and config files to provide diagnostic feedback.