bmad-customize

Create TOML override files for BMad agent and workflow customization.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill bmad-customize-enigmaicon-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-customize
Source: https://github.com/enigmaicon-eng/AI-Enterprise-OS/tree/main/examples/BMAD-METHOD/src/core-skills/bmad-customize
Command: npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill bmad-customize-enigmaicon-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you customize BMad-installed agents and workflows without guessing where to edit configuration or how overrides should be merged.

Core Features & Use Cases

  • Discover customizable skills: Scans sibling skill directories to find which skills expose [agent] and/or [workflow] customization surfaces.
  • Choose the right customization surface: Guides you to apply changes at either the agent level or the workflow level based on what you want to alter.
  • Author correct TOML overrides: Writes sparse team (.toml) or user (.user.toml) override files under _bmad/custom/ and never silently overwrites existing files.
  • Verify merged output: Uses the resolver to show the effective customization after applying base → team → user layers.

Quick Start

Tell the bmad-customize skill what you want to customize (for example, "customize bmad create-prd so it uses a different template and updates the output path").

Frequently Asked Questions about bmad-customize

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

FAQPage Schema
How do I customize BMad agent and workflow behavior?

You customize BMad behavior by creating sparse TOML override files under the `_bmad/custom/` directory. The skill detects available customizable surfaces and guides you to apply changes at either the agent or workflow level.

How does TOML configuration merging work for agent overrides?

TOML configuration merging applies layers sequentially: base configuration, then team `.toml` overrides, and finally user `.user.toml` overrides. The resolver script verifies the effective merged output to ensure your customizations apply correctly.

How do I discover which BMad skills support workflow customization?

The skill scans sibling skill directories for `customize.toml` surfaces to discover which BMad skills expose `[agent]` and `[workflow]` customization options. This exploratory discovery identifies all available modification targets.

Do I need Python3 to verify merged BMad overrides?

Yes, Python3 is required to run `resolve_customization.py` and verify merged BMad overrides. This script processes the base, team, and user TOML layers to display the effective configuration result.

Can I write user-level TOML overrides without overwriting team configuration?

Yes, you can author user-level `.user.toml` overrides separately from team `.toml` files. The skill writes sparse override files and never silently overwrites existing configurations, ensuring both layers remain intact.

What's the best way to apply agent customization changes to specific skill roles?

To apply agent customization changes, target specific skill roles by authoring sparse `_bmad/custom/<skill>.toml` files. This approach ensures your modifications are scoped correctly and merged seamlessly with existing configurations.