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.