bmad-module-builder

Generate module.yaml and module-help.csv scaffolds from SKILL.md frontmatter.

1|Updated Aug 3, 2025
One-click install
npx skills add https://github.com/MazenMrad/Obsidio --skill bmad-module-builder-mazenmrad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-module-builder
Source: https://github.com/MazenMrad/Obsidio/tree/main/.cursor/skills/bmad-module-builder
Command: npx skills add https://github.com/MazenMrad/Obsidio --skill bmad-module-builder-mazenmrad

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Creating a new BMad module involves aligning identities, capabilities, configuration, and packaging — this skill automates that lifecycle from ideation through scaffolding and validation.

Core Features & Use Cases

  • Ideate and plan new modules with structured frontmatter, dependency graphs, and a design rationale.
  • Scaffold multi-skill modules or standalone skills with installable, self-registering setups and asset templates.
  • Validate module structure and help CSV integrity to ensure smooth distribution and consumption.

Quick Start

Provide your module goals and any existing SKILL.md entries to generate a complete module plan and scaffolding assets.

Frequently Asked Questions about bmad-module-builder

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

FAQPage Schema
How do I scaffold a new module from a SKILL.md file?

To scaffold a new module, provide your module goals and existing SKILL.md entries. The builder reads the frontmatter to generate a complete module plan, module.yaml, module-help.csv, and optional setup structures.

What is the best way to validate module structure and help CSV integrity?

Validating module structure ensures smooth distribution by checking the integrity of your module.yaml and module-help.csv scaffolds. This process verifies that identities, capabilities, and configurations align correctly.

Can I generate module scaffolds without interactive prompts?

Yes, you can produce module.yaml and module-help.csv scaffolds in headless mode. The builder supports both interactive and headless operations to create ready-to-run module plans without requiring user input.

Do I need pyyaml to produce module.yaml scaffolds?

Yes, pyyaml is required. It provides the underlying parsing needed to read SKILL.md frontmatter and generate the module.yaml configuration files during the scaffolding process.

How do I plan a multi-skill module with dependency graphs?

Planning a multi-skill module involves providing your module goals and referenced skills. The builder identifies capabilities from frontmatter to create a build roadmap with dependency graphs and design rationale.

Why does my module packaging fail during setup generation?

Module packaging fails when identities, capabilities, and configurations are misaligned. The builder automates this lifecycle from ideation through validation to ensure proper self-registering setups and asset templates.