bmad-module-builder

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

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-module-builder-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-module-builder
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-module-builder-hexalith

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 distributable, installable BMad module requires manual creation 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 a build roadmap. - Create Module (CM): Reads existing SKILL.md files 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, module-help.csv entries, menu codes, and agent rosters, with headless JSON output for CI pipelines. - Use Case: After building three skills with the agent and workflow builders, run Create Module to generate the setup skill, config merge scripts, and marketplace.json so users can install the module with one command. ## Quick Start Ask the assistant to create a BMad module from the folder containing your built skills, or to validate an existing module's structure.

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 containing your built skills. It 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-registration assets.

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

A standalone module embeds registration logic directly into a single skill via assets/module-setup.md, triggered by a setup or configure argument. Multi-skill modules instead get a dedicated -setup skill that handles config collection and help CSV registration for all skills.

How do I validate a BMad module before release?

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

Does the module builder support headless or CI usage?

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 suitable for CI pipeline gating on module quality.

What files does the module scaffolding script generate?

For multi-skill modules it creates a -setup skill folder with SKILL.md, merge-config.py, merge-help-csv.py, cleanup-legacy.py, module.yaml, and module-help.csv. Standalone modules additionally get a .claude-plugin/marketplace.json distribution manifest.