BMad Customize
Translate the user's intent into a correctly-placed TOML override file under
{project-root}/_bmad/custom/
for a customizable agent or workflow skill. Discover, route, author, write, verify.
Scope v1: per-skill
[agent]
overrides (
bmad-agent-.toml
/
.user.toml
) and per-skill
[workflow]
overrides (
bmad-.toml
/
.user.toml
). Central config (
{project-root}/_bmad/custom/config.toml
) is out of scope — point users at the
How to Customize BMad guide
.
When the target's
customize.toml
doesn't expose what the user wants, say so plainly. Don't invent fields.
Preflight
No
{project-root}/_bmad/
→ BMad isn't installed. Say so, stop.
{project-root}/_bmad/scripts/resolve_customization.py
missing → continue, but Step 6 verify falls back to manual merge.
Both present → proceed.
Activation
Greet the user. If the user's invocation already names a target skill AND a specific change, jump to Step 3.
Step 1: Classify intent
Show more
Installs
1.1K
Repository
bmad-code-org/b…d-method
GitHub Stars
52.9K
First Seen
Apr 22, 2026
Security Audits
Gen Agent Trust Hub
Pass
Socket
Pass
Snyk
Fail