How do I install the Bmad Module Builder skill?

Run npx skillmds@latest add salacoste/bmad-module-builder in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bmad Module Builder safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bmad Module Builder?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bmad Module Builder free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bmad Module Builder?

salacoste (@salacoste) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bmad Module Builder by salacoste — Agent Skill

Name: Bmad Module Builder
Rating: 4.666666666666667 (3 reviews)
Author: salacoste

File contents

BMad Module Builder

Overview

This skill helps you bring BMad modules to life — from the first spark of an idea to a fully scaffolded, installable module. It offers three paths:

Ideate Module (IM) — A creative brainstorming session that helps you imagine what your module could be, decide on the right architecture (agent vs. workflow vs. both), and produce a detailed plan document. The plan then guides you through building each piece with the Agent Builder and Workflow Builder.
Create Module (CM) — Takes an existing folder of built skills (or a single skill) and scaffolds the module infrastructure that makes it installable. For multi-skill modules, generates a dedicated -setup skill. For single skills, embeds self-registration directly into the skill. Supports --headless / -H.
Validate Module (VM) — Checks that a module's structure is complete and correct — every skill has its capabilities registered, entries are accurate and well-crafted, and structural integrity is sound. Handles both multi-skill and standalone modules. Supports --headless / -H.

Args: Accepts --headless / -H for CM and VM paths, an initial description for IM, or a path to a skills folder or single SKILL.md file for CM/VM.

On Activation

Load available config from {project-root}/_bmad/config.yaml and {project-root}/_bmad/config.user.yaml (root level and bmb section). If neither exists, fall back to {project-root}/_bmad/bmb/config.yaml (legacy per-module format). If still missing, let the user know bmad-builder-setup can configure the module at any time. Use sensible defaults for anything not configured.

Detect user's intent:

Ideate / Plan keywords or no path argument → Load ./references/ideate-module.md
Create / Scaffold keywords, a folder path, or a path to a single SKILL.md file → Load ./references/create-module.md
Validate / Check keywords → Load ./references/validate-module.md
Unclear → Present options:
- Ideate Module (IM) — "I have an idea for a module and want to brainstorm and plan it"
- Create Module (CM) — "I've already built my skills and want to package them as a module"
- Validate Module (VM) — "I want to check that my module's setup skill is complete and correct"

If --headless or -H is passed, route to CM with headless mode.

---name: bmad-module-builderdescription: Plans, creates, and validates BMad modules. Use when the user requests to 'ideate module', 'plan a module', 'create module', 'build a module', or 'validate module'.---# BMad Module Builder## OverviewThis skill helps you bring BMad modules to life — from the first spark of an idea to a fully scaffolded, installable module. It offers three paths:- **Ideate Module (IM)** — A creative brainstorming session that helps you imagine what your module could be, decide on the right architecture (agent vs. workflow vs. both), and produce a detailed plan document. The plan then guides you through building each piece with the Agent Builder and Workflow Builder.- **Create Module (CM)** — Takes an existing folder of built skills (or a single skill) and scaffolds the module infrastructure that makes it installable. For multi-skill modules, generates a dedicated `-setup` skill. For single skills, embeds self-registration directly into the skill. Supports `--headless` / `-H`.- **Validate Module (VM)** — Checks that a module's structure is complete and correct — every skill has its capabilities registered, entries are accurate and well-crafted, and structural integrity is sound. Handles both multi-skill and standalone modules. Supports `--headless` / `-H`.**Args:** Accepts `--headless` / `-H` for CM and VM paths, an initial description for IM, or a path to a skills folder or single SKILL.md file for CM/VM.## On ActivationLoad available config from `{project-root}/_bmad/config.yaml` and `{project-root}/_bmad/config.user.yaml` (root level and `bmb` section). If neither exists, fall back to `{project-root}/_bmad/bmb/config.yaml` (legacy per-module format). If still missing, let the user know `bmad-builder-setup` can configure the module at any time. Use sensible defaults for anything not configured.Detect user's intent:- **Ideate / Plan** keywords or no path argument → Load `./references/ideate-module.md`- **Create / Scaffold** keywords, a folder path, or a path to a single SKILL.md file → Load `./references/create-module.md`- **Validate / Check** keywords → Load `./references/validate-module.md`- **Unclear** → Present options: - **Ideate Module (IM)** — "I have an idea for a module and want to brainstorm and plan it" - **Create Module (CM)** — "I've already built my skills and want to package them as a module" - **Validate Module (VM)** — "I want to check that my module's setup skill is complete and correct"If `--headless` or `-H` is passed, route to CM with headless mode.

Frequently asked questions

Bmad Module Builder