bmad-customize
Authors and updates customization overrides for installed BMad skills. Use when the user says 'customize bmad', 'override a skill', 'change agent behavior', or 'customize a workflow'.
Best for BMad users needing project-…Works with GitHub
⌘source
- author
@bmad-code-org- language
- JavaScript
★45kstars
5.4kforks
Apr 21, 2026
✦overview.md
Key Features
- ·Creates TOML override files for BMad skills
- ·Handles both agent and workflow skill customizations
- ·Verifies customizations against skill definitions
- ·Directs users to official documentation for central config
- ·Stops if BMad isn't installed in the project
Use Cases
- →Modifying an agent's behavior for a specific project
- →Overriding default workflow steps to match team processes
- →Adjusting skill parameters without modifying original skill files
- →Creating project-specific customizations for BMad agents
Best for
- ✓BMad users needing project-specific customizations
- ✓Teams adapting BMad skills to their workflows
Not ideal for
- !Modifying central BMad configuration
- !Creating new skills from scratch
- !Projects without BMad installed
FAQs
name
bmad-customize
description
Authors and updates customization overrides for installed BMad skills. Use when the user says 'customize bmad', 'override a skill', 'change agent behavior', or 'customize a workflow'.
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-<role>.toml / .user.toml) and per-skill [workflow] overrides (bmad-<workflow>.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.pymissing → continue, but Step 6 verify falls back to manual merge.- Both present → proceed.
Activation
Load _bmad/config.toml and _bmad/config.user.toml from {project-root} for user_name (default BMad) and communication_language (default English). Greet. If the user's invocation already names a target skill AND a specific change, jump to Step 3.
Step 1: Classify intent
$install
1-click copynpx skills add bmad-code-org/BMAD-METHOD --skill bmad-customizeSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
3/ 5
mediumPartially actionable with several concrete steps, but still missing important details.