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.