bmad-module-builder

Plan, scaffold, and validate BMad modules from module.yaml and module-help.csv.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ImaginerLabs/skill-manager --skill bmad-module-builder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/ImaginerLabs/skill-manager/tree/main/.trae/skills/bmad-module-builder
Command: npx skills add https://github.com/ImaginerLabs/skill-manager --skill bmad-module-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Bmad Module Builder helps you turn a spark of an idea into a fully scaffolded, installable BMad module by guiding ideation, planning, scaffolding, and validation.

Core Features & Use Cases

  • Ideate Module (IM) — brainstorm and produce a detailed plan document guiding the Agent Builder and Workflow Builder.
  • Create Module (CM) — scaffold module infrastructure from a folder of skills or a single SKILL.md, generating per-skill or standalone setups.
  • Validate Module (VM) — verify structure, registrations, and CSV entries for multi-skill and standalone modules. Supports headless mode for automation.
  • On Activation — loads available config and offers pathways for ideation, creation, or validation; defaults sensibly when config is missing.

Quick Start

Provide a folder containing your built skills (or a single SKILL.md) and run the BMad Module Builder to generate a scaffold.

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 an installable module from a folder of skills?▼

To scaffold a module, provide a folder containing built skills or a single SKILL.md file. The builder generates the infrastructure and per-skill or standalone setups, mapping module.yaml and module-help.csv to a distributable package.

What is the process for planning a BMad module from an initial idea?▼

Planning a module involves brainstorming the initial idea to produce a detailed plan document. This ideation phase guides the Agent Builder and Workflow Builder before the scaffolding infrastructure is generated.

Does the module validation workflow support headless mode for automation?▼

Yes, the validation workflow supports headless mode for automation. It verifies structure, registrations, and CSV entries for both multi-skill and standalone modules without requiring interactive input.

Can I build a standalone module from a single SKILL.md file?▼

Yes, you can build a standalone module from a single SKILL.md file. The builder scaffolds the required infrastructure and generates standalone registrations for distribution.

Do I need pyyaml installed to use the BMad module builder?▼

Yes, pyyaml is a required dependency for the module builder. It is necessary for processing module.yaml configuration files during the scaffolding and validation workflows.