bmad-module-builder

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

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill bmad-module-builder-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/bmad-module-builder
Command: npx skills add https://github.com/watchthelight/shatterfish --skill bmad-module-builder-watchthelight

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 generating module.yaml, help CSV registries, setup skills, and config merge logic by hand, which is error-prone and hard to validate. ## 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): Scaffolds module infrastructure from existing skills, 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 capability entries, menu codes, ordering references, and agent rosters, returning pass/fail results or structured JSON for CI. - Use Case: You built three skills for a content suite and want to distribute them. Run Create Module to generate the setup skill, module.yaml, and help CSV, then run Validate Module to confirm every capability is registered correctly before publishing. ## Quick Start Ask the assistant to create a BMad module from the skills folder at .claude/skills/my-module and confirm the generated module.yaml and help CSV before scaffolding.

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 the folder containing your built skills. It reads every SKILL.md, collects module identity and capabilities, then scaffolds a setup skill for multi-skill modules or embeds self-registration for a single skill.

How do I validate a BMad module before publishing?

Run the Validate Module path against your module's skills folder. It executes a validation script checking structure, CSV integrity, menu codes, and references, then performs 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, triggered by a setup or configure argument. Multi-skill modules instead get a dedicated {code}-setup skill that handles registration for all skills.

Does the module builder support headless or CI usage?

Yes, both Create Module and Validate Module accept --headless or -H. Create requires a module code and skills path, returning structured JSON with inferred fields flagged; Validate returns pass/fail JSON suitable for CI 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 marketplace.json manifest.