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-07-19
- Stars
- ★ 1
- 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.md17.2 KB
- 参考文档references/ideate-module.md18.4 KB
- 参考文档references/validate-module.md5.3 KB
- 脚本scripts/scaffold-setup-skill.py3.9 KB
- 脚本scripts/scaffold-standalone-module.py6.0 KB
- 脚本scripts/tests/test-scaffold-setup-skill.py7.9 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 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.
04 同仓库更多 Skills
writing-plans
Use when you have a spec or requirements for a multi-step task, before touching code
to-prd
Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.
steve-jobs-perspective
史蒂夫·乔布斯(Steve Jobs)的思维框架与表达方式。基于Isaacson授权传记、Stanford演讲、 Lost Interview、D Conference系列、Make Something Wonderful、30+一手来源的深度调研, 提炼6个核心心智模型、8条决策启发式和完整的表达DNA。 用途:作为思维顾问,用乔布斯的视角分析产品、审视决策、提供反馈。 当用户提到「用乔布斯的视角」「乔布斯会怎么看」「Jobs模式」「steve jobs perspective」时使用。 即使用户只是说「帮我用乔布斯的角度想想」「如果乔布斯会怎么做」「切换到乔布斯」也应触发。
pinme
Use this skill when the user mentions "pinme", or needs to upload files, store to IPFS, create/publish/deploy websites or full-stack services (including frontend pages, backend APIs, database storage, email sending, etc.), or any feature requiring backend database/server support.
pinme-share
Use this skill when the user wants to share, publish, or upload a static result through PinMe, especially by generating a static HTML share page for a PinMe project link, deployed full-stack app, Codex conversation summary, report, file, demo, or any 分享/发布/上传分享页 request that should end with `pinme upload`.
pinme-llm
Use this skill when a PinMe project (Worker TypeScript) needs to call OpenRouter-backed LLM APIs, including models, chat/completions, streaming, or OpenRouter web search. Guides AI to generate correct Worker TS code.