bmad-module-builder

Plan, scaffold, and validate installable BMad modules from existing skills with Python scripts and YAML/CSV assets.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-module-builder-ncptuan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/ncptuan/stock_backtest_project/tree/main/.claude/skills/bmad-module-builder
Command: npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-module-builder-ncptuan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps you design, package, and verify BMad modules so individual skills become a coherent, installable module with proper setup, configuration, registration, and quality checks.

Core Features & Use Cases

  • Module Ideation and Planning: Brainstorm a new module, choose the right architecture, and produce a structured plan document for building agents and workflows.
  • Module Scaffolding: Convert an existing skill or skills folder into a distributable module by generating setup infrastructure, registration assets, help entries, and marketplace metadata.
  • Module Validation: Check that module structure, capability registration, CSV integrity, and setup files are complete and internally consistent.
  • Use Case: If you have already built several related BMad skills and want to ship them as a reusable toolkit, this Skill can generate a setup skill, module definition files, and validation workflow so the package is ready for installation and review.

Quick Start

Ask the bmad-module-builder skill to create a module from your existing skills folder or to validate a completed module before release.

Frequently Asked Questions about bmad-module-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I package multiple skills into an installable module?

Validate a BMad module before release by running deterministic checks to verify module structure, capability registration, CSV integrity, and setup files are complete and internally consistent.

What is BMad module scaffolding and when do I need it?

You need BMad module scaffolding when you want to ship several related skills as a coherent, reusable toolkit, generating setup infrastructure and registration assets for installation.

How do I generate YAML and CSV registration assets for a skill package?

Generate YAML and CSV registration assets for a skill package by running Python-based scaffolding scripts that produce capability registry files and help entries for deterministic module validation.

Does the module builder support legacy config migration?

Yes, the module builder supports legacy config migration alongside deterministic checks for module structure and registration integrity to ensure packaged skills remain internally consistent.

Do I need Python and PyYAML to scaffold and validate installable modules?

Yes, you need Python and the PyYAML dependency to run the scaffolding and validation scripts that generate YAML and CSV assets and perform deterministic checks for module structure integrity.

What's the best way to plan a BMad module architecture from existing skills?

The best way to plan a BMad module architecture is to start with a module ideation session that brainstorms the design, chooses the architecture, and produces a structured plan document for building agents and workflows.