skills.rest
PastaSus
PastaSusCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

bmad-bmb-setup

Installs and configures the BMad Builder module into a project's _bmad directory.

1|Updated Sep 18, 2026
Search Tags:#cli#migration#configuration#yaml#installer#bmad#module setup
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill bmad-bmb-setup-pastasus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-bmb-setup
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/bmad-bmb-setup
Command: npx skills add https://github.com/PastaSus/egg-defender --skill bmad-bmb-setup-pastasus

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Setting up a BMad module requires writing shared config, personal user settings, and help registry entries across multiple files, while also migrating legacy per-module configs without leaving stale values behind. This Skill automates that entire installation and migration workflow. ## Core Features & Use Cases - Config Merging: Writes core settings and module-specific values into _bmad/config.yaml and user-only settings (user_name, communication_language) into _bmad/config.user.yaml using an anti-zombie pattern that removes stale entries first. - Legacy Migration: Detects old per-module config files, uses their values as fallback defaults, and deletes them plus legacy installer directories after verifying skills are installed at .claude/skills/. - Help Registry: Merges module capability entries into _bmad/module-help.csv for the help system. - Use Case: A user says "install bmb module" in their project; the Skill collects preferences (or accepts headless arguments), writes all three config files, creates output directories, cleans up legacy installer packages, and confirms what changed. ## Quick Start Ask the assistant to install and configure the BMad Builder module in the current project, optionally providing values like your name and preferred language inline.

Frequently Asked Questions about bmad-bmb-setup

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

FAQPage Schema
How do I install the BMad Builder module in my project?▼

Invoke the setup skill and answer the configuration prompts, or pass values inline such as your user name and language for headless setup. The skill writes config.yaml, config.user.yaml, and module-help.csv under the _bmad directory and confirms the results.

How does BMad module config migration from legacy files work?▼

The merge scripts read legacy per-module config.yaml files from _bmad/core and _bmad/bmb, use matching values as fallback defaults, then delete the legacy files after a successful merge. Only keys matching the current schema are carried forward.

What is the difference between config.yaml and config.user.yaml in BMad?▼

config.yaml holds shared project settings like output_folder and module values, while config.user.yaml stores personal settings such as user_name and communication_language and is intended to be gitignored. User-only keys are never written to the shared config.

Why does the setup script fail with an unresolved {project-root} error?▼

The scripts reject any path argument still containing the literal {project-root} token. You must resolve it to the actual project root path before running, since the token is only valid inside config values, not filesystem paths.

Is it safe to delete legacy BMad installer directories?▼

Yes, the cleanup script verifies every skill in the legacy directories exists at .claude/skills/ before removing anything, and missing directories are treated as already cleaned rather than errors. The operation is idempotent.

Related Skills

Explore More Software Engineering Skills→
ImaginerLabsImaginerLabs

bmad-module-builder

Plan, scaffold, and validate BMad modules from module.yaml and module-help.csv.

Official
Advanced
tiweentiween

bmad-bmb-setup

Configure BMad Builder module with user preferences and configuration files.

Official
Advanced
b566776b566776

bmad-bmb-setup

Install and configure the BMad Builder module by generating config files.

Community
Advanced
Cbanzaime23Cbanzaime23

bmad-bmb-setup

Install and configure the BMad Builder module from assets/module.yaml into _bmad config files.

Community
Advanced