bmad-module-builder
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'.
- License 许可
- MIT
- 最近更新
- 2026-04-18
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- bmad-module-builder
- description
- 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'.
02 资源文件 13
- 资产文件assets/module-plan-template.md4.3 KB
- 脚本assets/standalone-module-template/merge-config.py13.8 KB
- 脚本assets/standalone-module-template/merge-help-csv.py6.5 KB
- 资产文件assets/standalone-module-template/module-setup.md6.0 KB
- 参考文档references/create-module.md14.8 KB
- 参考文档references/ideate-module.md18.4 KB
- 参考文档references/validate-module.md4.7 KB
- 脚本scripts/scaffold-setup-skill.py3.9 KB
- 脚本scripts/scaffold-standalone-module.py6.0 KB
- 脚本scripts/tests/test-scaffold-setup-skill.py7.6 KB
- 脚本scripts/tests/test-scaffold-standalone-module.py9.3 KB
- 脚本scripts/tests/test-validate-module.py11.8 KB
- 脚本scripts/validate-module.py10.8 KB
03 SKILL.md 正文
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
-setupskill. 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 config is 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.
04 同仓库更多 Skills
meeting-minutes
Generate concise, actionable meeting minutes for internal meetings. Includes metadata, attendees, agenda, decisions, action items (owner + due date), and follow-up steps.
documentation-writer
Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework.
doc-coauthoring
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
code-review-workflow
Executes comprehensive 4-phase code review: basic review, quality check, bundle analysis, and test coverage. Should be used when the user mentions comprehensive code review, checking code quality, or reviewing staged changes with multi-phase analysis. This is the comprehensive review workflow, distinct from focused skills like frontend-code-review, staged-code-review, or code-change-test-designer.
code-change-test-designer
Analyzes code changes and designs comprehensive test cases. Reads diffs, summarizes capability changes, and designs test cases covering main flows and edge cases. Should be used when the user mentions test coverage, designing tests for code changes, or analyzing diff/commit for testing purposes. Distinguished from code-review-workflow which provides comprehensive review, this skill focuses on test case design for code changes.
skill-creator
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.