bmad-module-builder

Scaffold and validate BMad modules from SKILL.md files into installable artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Helps developers and creators turn collections of SKILL.md files into coherent, installable BMad modules by planning, scaffolding, and validating module structure and registration.

Core Features & Use Cases

  • Ideate Module (IM): Guided brainstorming and a plan document template to define module identity, architecture, capabilities, and build roadmap.
  • Create Module (CM): Scaffolds standalone or multi-skill module infrastructure, generates module.yaml and module-help.csv, and can produce a dedicated setup skill or self-registering standalone skill.
  • Validate Module (VM): Runs deterministic checks and quality reviews against module.yaml and module-help.csv, ensuring CSV integrity, unique menu codes, and correct before/after references.
  • Headless & CI-friendly: Supports headless mode for automated scaffolding and validation with structured JSON outputs for pipelines.
  • Tooling: Includes scripts to scaffold, merge config and help CSV, and cleanup legacy installers.

Quick Start

Ask the skill to "create module" and provide the path to your skills folder to scaffold an installable BMad module.

Frequently Asked Questions about bmad-module-builder

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

FAQPage Schema
How do I scaffold installable BMad modules from SKILL.md files?

To scaffold installable BMad modules from SKILL.md files, the skill generates module.yaml and module-help.csv while creating a setup skill or self-registering standalone skill from your provided folder path.

What is the best way to validate module.yaml and module-help.csv integrity?

Validating module.yaml and module-help.csv integrity involves running deterministic checks for CSV structure, unique menu codes, and correct before/after references to ensure your BMad module is correctly packaged and registered.

Can I automate scaffolding and validation in a headless CI workflow?

Yes, you can automate scaffolding and validation in a headless CI workflow by running the scripts in headless mode, which outputs structured JSON results for automated pipelines to consume without interactive prompting.

Do I need PyYAML to generate module artifacts and merge config files?

Yes, you need PyYAML installed to run the scaffold and merge scripts, as it provides the required configuration handling to merge module settings into _bmad config files and generate artifacts.

How do I plan and define the architecture for a multi-skill module?

To plan and define the architecture for a multi-skill module, you use the guided ideation session to brainstorm module identity, capabilities, and build roadmap, outputting a structured plan document template.

When should I use a dedicated setup skill instead of a standalone module?

You should use a dedicated setup skill instead of a standalone module when your BMad module contains multiple skills that require coordinated registration and configuration merging, rather than a single self-registering standalone skill.