bmad-module-builder

Plans, scaffolds, and validates installable BMad modules from built skills.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Turning a folder of built skills into a properly structured, installable BMad module requires manual scaffolding of setup skills, module.yaml definitions, help CSV registries, and config merge scripts, which is error-prone and tedious to do by hand. ## Core Features & Use Cases - Ideate Module (IM): Facilitates a phased brainstorming session that produces a complete module plan document covering architecture, memory patterns, skill briefs, and build roadmap. - Create Module (CM): Reads existing skills and scaffolds module infrastructure, generating a dedicated setup skill for multi-skill modules or self-registration assets for standalone single-skill modules. - Validate Module (VM): Runs deterministic structural checks plus LLM quality review of module.yaml, help CSV entries, menu codes, and agent rosters, with headless JSON output for CI pipelines. - Use Case: After building several agent and workflow skills, run Create Module to auto-generate the setup skill, module.yaml, and module-help.csv, then run Validate Module to confirm every capability is registered before distribution. ## Quick Start Ask the agent to create a BMad module from the skills folder at ./skills and scaffold the setup infrastructure.

Frequently Asked Questions about bmad-module-builder

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

FAQPage Schema
How do I create an installable BMad module from my skills?▼

Use the Create Module path with a folder of built skills or a single SKILL.md file. It reads each skill, collects module identity and capabilities, then scaffolds a setup skill with module.yaml and module-help.csv, or self-registration assets for standalone modules.

How do I validate a BMad module structure before release?▼

Run the Validate Module path against the module's skills folder. It executes validate-module.py for structural checks on module.yaml, CSV integrity, menu codes, and before/after references, then performs an LLM quality review of capability descriptions.

What is the difference between standalone and multi-skill BMad modules?▼

Multi-skill modules get a dedicated {code}-setup skill that handles registration for all skills. Standalone single-skill modules embed self-registration directly via assets/module-setup.md, triggered by passing setup or configure as an argument.

Does the module builder support headless or CI automation?▼

Yes, both Create Module and Validate Module accept --headless or -H flags. Headless mode skips interactive prompts, infers defaults from a plan document or skills folder, and returns structured JSON suitable for CI pipeline gating.

What files does the module scaffolding script generate?▼

The scaffold scripts generate a setup skill containing SKILL.md, merge-config.py, merge-help-csv.py, cleanup-legacy.py, plus assets/module.yaml and assets/module-help.csv. Standalone modules also get a .claude-plugin/marketplace.json distribution manifest.