{setup-skill-name}

Install and configure a BMad module by updating _bmad config files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Automates the setup of a BMad module into a project, reducing manual configuration and ensuring consistent structure.

Core Features & Use Cases

  • Reads module metadata from assets/module.yaml to determine identity and version.
  • Collects user preferences and writes core configuration to {project-root}/_bmad/config.yaml and per-module settings to {project-root}/_bmad/config.user.yaml.
  • Registers module capabilities for the help system in {project-root}/_bmad/module-help.csv.
  • Performs anti-zombie migrations by cleaning up existing module sections and migrating legacy values when provided.

Quick Start

Run the setup to install and configure the BMad module into your project.

Frequently Asked Questions about {setup-skill-name}

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

FAQPage Schema
How do I automate BMad module setup and configuration in a project?

Automating BMad module setup involves reading metadata from assets/module.yaml, collecting user preferences, and writing configurations to _bmad/config.yaml and _bmad/config.user.yaml. It also registers module capabilities in module-help.csv to ensure consistent project structure.

What is the best way to migrate legacy BMad configurations and clean up old settings?

The best way to migrate legacy BMad configurations is to apply legacy defaults during module setup while cleaning up existing module sections. This anti-zombie migration prevents zombie data by removing old configs from _bmad/config.yaml and config.user.yaml.

Does the BMad module setup require specific dependencies like pyyaml to function?

Yes, BMad module setup requires the pyyaml dependency to parse and write YAML files. It uses pyyaml to read module metadata and update the core and module sections within _bmad/config.yaml and _bmad/config.user.yaml.

How does BMad module configuration handle per-module settings and help system registration?

BMad module configuration handles per-module settings by writing user preferences to _bmad/config.user.yaml. It registers help system capabilities by updating entries in _bmad/module-help.csv, ensuring modules are properly documented and accessible.

Can I use BMad setup to install a Godot module into an existing project structure?

Yes, you can use BMad setup to install a Godot module into an existing project. The setup process reads module metadata, collects your preferences, and updates the necessary _bmad configuration files to integrate the module seamlessly.

Why does my BMad module setup keep outdated configuration data after updating?

Outdated configuration data persists when legacy values are not properly migrated. The BMad setup performs anti-zombie migrations by cleaning up existing module sections in _bmad/config.yaml and applying legacy defaults to prevent stale zombie data.