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.