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.