bmad-module-builder

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

1|Updated Sep 18, 2026
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill bmad-module-builder-pastasus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/bmad-module-builder
Command: npx skills add https://github.com/PastaSus/egg-defender --skill bmad-module-builder-pastasus

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 logic — this Skill automates that entire lifecycle from ideation to validation. ## Core Features & Use Cases - Ideate Module (IM): Facilitated brainstorming that produces a structured 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, 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, ordering references, and agent rosters. - Use Case: You built three skills for a content creation suite. Run Create Module to generate the setup skill and capability registry, then Validate Module to confirm every skill is correctly registered before distribution. ## Quick Start Ask the assistant to create a BMad module from the skills folder at ./my-skills using 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 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 with module.yaml and module-help.csv, or embeds self-registration for single-skill modules.

How do I validate a BMad module structure?▼

Run the Validate Module path with your module's skills folder. It checks for required files, CSV integrity, duplicate menu codes, broken before/after references, and reviews capability descriptions for quality, returning a report or structured JSON in headless mode.

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 single-skill modules embed self-registration directly in the skill via assets/module-setup.md, triggered by passing setup or configure as an argument.

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 prompts, infers defaults where possible, and returns structured JSON suitable for CI pipeline gating.

What files does module scaffolding generate?▼

Scaffolding generates module.yaml with module identity and config variables, module-help.csv with capability registry entries, merge scripts for config and CSV, and for standalone modules a .claude-plugin/marketplace.json distribution manifest.