bmad-module-builder

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

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/5onyy/essential-ai-agent-skills --skill bmad-module-builder-5onyy
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/5onyy/essential-ai-agent-skills/tree/main/.cursor/skills/bmad-module-builder
Command: npx skills add https://github.com/5onyy/essential-ai-agent-skills --skill bmad-module-builder-5onyy

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 BMad skills into a properly packaged, installable module requires manual creation of setup skills, module.yaml definitions, help CSV registries, and config merge logic β€” a repetitive and error-prone process this Skill automates end to end. ## 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, configuration, 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 plus LLM quality review of capability entries, menu codes, before/after references, and agent rosters, with headless JSON output for CI pipelines. - Use Case: After building five skills for a content creation suite, run Create Module to auto-generate the setup skill, capability registry, and config merge scripts, then validate the result before distribution. ## Quick Start Ask the agent to create a BMad module from the skills folder at ./my-skills with module code cis.

Frequently Asked Questions about bmad-module-builder

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

FAQPage Schema
How do I package multiple skills into an installable BMad module?β–Ό

Use the Create Module path with a folder containing your built skills. It reads every SKILL.md, collects module identity and capabilities, then runs scaffold-setup-skill.py to generate a {code}-setup skill with module.yaml, module-help.csv, and config merge scripts.

How do I validate a BMad module before distribution?β–Ό

Run the Validate Module path against your module's skills folder. The validate-module.py script checks structure, CSV integrity, duplicate menu codes, and broken before/after references, followed by an LLM quality review of capability descriptions and agent rosters.

What is the difference between standalone and multi-skill BMad modules?β–Ό

Multi-skill modules get a dedicated -setup skill that handles registration for all skills. Standalone modules embed self-registration directly into the single skill 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 are required for a valid BMad module?β–Ό

Multi-skill modules need a -setup skill containing SKILL.md, assets/module.yaml, and assets/module-help.csv. Standalone modules additionally require assets/module-setup.md plus scripts/merge-config.py and scripts/merge-help-csv.py for self-registration.