bmad-module-builder

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

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-module-builder-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-module-builder
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-module-builder-hordricjr

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 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 a build roadmap. - Create Module (CM): Reads existing skills and scaffolds module infrastructure, generating a dedicated setup skill for multi-skill modules or embedding self-registration into standalone single-skill modules, with headless mode support. - Validate Module (VM): Runs deterministic structural checks plus LLM quality review of module.yaml, help CSV entries, menu codes, and agent rosters, returning pass/fail results suitable for CI gating. - Use Case: After building three skills with the agent and workflow builders, run Create Module to 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 assistant to create a BMad module from the folder containing your built skills, providing the folder path and a short module code.

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 path to your skills folder. It reads every SKILL.md, collects module identity and capabilities, then scaffolds a setup skill with module.yaml and module-help.csv, or embeds self-registration for single-skill modules.

How do I validate a BMad module before distribution?

Run the Validate Module path against your module's skills folder. It checks structure, module.yaml fields, CSV integrity, duplicate menu codes, and broken before/after references, then adds an LLM quality review of each capability entry.

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, while multi-skill modules get a dedicated {code}-setup skill. The builder auto-detects which approach fits based on the skill count.

Can I run module creation and validation in headless mode?

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

Why does module validation report orphan CSV entries?

Orphan entries occur when module-help.csv references a skill name that has no matching folder with a SKILL.md in the module directory. Rename the CSV skill field or add the missing skill folder to resolve it.