bmad-module-builder

Scaffold and validate BMad modules with setup and skill entries.

Updated May 5, 2026
One-click install
npx skills add https://github.com/b566776/whitebox --skill bmad-module-builder-b566776
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/b566776/whitebox/tree/main/.gemini/skills/bmad-module-builder
Command: npx skills add https://github.com/b566776/whitebox --skill bmad-module-builder-b566776

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Plans, scaffolds, and validates end-to-end BMad modules, reducing time-to-value for developers building modular AI tooling.

Core Features & Use Cases

  • Ideate Module (IM): brainstorm module architecture and produce a detailed plan to drive the build process.
  • Create Module (CM): scaffold module infrastructure from existing skills to installable packages, including -setup for multi-skill modules or embedded setup for standalone skills.
  • Validate Module (VM): verify module structure, capability registrations, and integrity checks to ensure consistency and readiness.

Quick Start

Ideate a module plan, scaffold it with the builder, and validate the result.

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 a module from existing skills into an installable package?

To scaffold a module, the builder extracts metadata from existing skills, populates frontmatter, and generates the necessary setup and skill entries to create a fully installable package. It handles both standalone skills and multi-skill module architectures automatically.

What is the best way to validate module structure and capability registrations?

Validating module structure requires verifying capability registrations and running integrity checks to ensure consistency. The validate workflow confirms correct wiring of setup and skill entries, preventing configuration errors and anti-zombie merge issues before deployment.

How do I plan and ideate architecture for a new module?

Planning module architecture involves brainstorming the design to produce a detailed plan that drives the build process. The ideation workflow generates a structured architectural blueprint, turning a concept into a ready-to-scaffold module specification.

Do I need pyyaml to scaffold and validate modules?

Yes, pyyaml is required as a dependency to scaffold and validate modules. It enables the builder to parse configuration files, extract metadata, and populate frontmatter during the module generation and integrity checking workflows.

Can I automate module setup and configuration merges for multi-skill packages?

Automating module setup for multi-skill packages is supported through dedicated setup workflows. The builder manages anti-zombie configuration merges and ensures correct wiring of skill entries, reducing manual configuration errors during package assembly.

Why does my scaffolded module fail integrity checks during validation?

Module integrity checks fail when capability registrations are missing or setup entries are incorrectly wired. The validate workflow detects these structural inconsistencies and anti-zombie configuration issues, ensuring readiness before the module is packaged.