bmad-module-builder

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

2|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Wizarck/nexandro --skill bmad-module-builder-wizarck
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/Wizarck/nexandro/tree/main/skills/bmad-module-builder
Command: npx skills add https://github.com/Wizarck/nexandro --skill bmad-module-builder-wizarck

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 an installable, distributable BMad module requires manual scaffolding of setup skills, config merging, help CSV registration, and structural validation — this Skill automates that entire lifecycle. ## 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): Scaffolds module infrastructure from existing skills — generating a dedicated -setup skill for multi-skill modules or embedding self-registration into standalone single-skill modules, including module.yaml, module-help.csv, and marketplace.json. - Validate Module (VM): Runs deterministic structural checks (CSV integrity, orphan entries, duplicate menu codes, broken before/after references) plus LLM quality review of capability descriptions. - Use Case: You have built three skills for a content creation suite. Run Create Module to generate the setup skill and capability registry, then run Validate Module in headless mode to confirm the module passes CI before distribution. ## Quick Start Ask the assistant 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 a BMad module from existing skills?▼

Use the Create Module path by providing a folder path containing your built skills. The skill reads every SKILL.md, gathers module identity, generates module.yaml and module-help.csv, then runs the scaffold script to produce a setup skill or standalone self-registering module.

What is the difference between a setup skill and a standalone module?▼

Multi-skill modules get a dedicated {code}-setup skill that handles registration for all skills. Single-skill modules use the standalone approach, embedding self-registration directly into the skill via assets/module-setup.md, triggered by passing setup or configure as an argument.

How do I validate a BMad module before distribution?▼

Run the Validate Module path with your module's skills folder. It executes validate-module.py for structural checks like missing CSV entries, duplicate menu codes, and broken before/after references, then performs an LLM quality review of capability descriptions.

Does the module builder support headless or CI mode?▼

Yes, both Create Module and Validate Module accept --headless or -H flags. Headless mode skips interactive questions, infers defaults where possible, and returns structured JSON output suitable for CI pipeline gating.

What files does module scaffolding generate?▼

Multi-skill scaffolding creates a {code}-setup folder with SKILL.md, merge-config.py, merge-help-csv.py, cleanup-legacy.py, module.yaml, and module-help.csv. Standalone scaffolding adds module-setup.md, merge scripts, and a .claude-plugin/marketplace.json distribution manifest.