What problem does it solve?
This Skill prevents misconfiguration by guiding you to translate your intent into the correct TOML override files for installed BMad skills, without inventing unsupported fields.
Core Features & Use Cases
- Discovers what you can customize: Scans installed BMad skills and groups them as agent surfaces and workflow surfaces, showing whether team or user override files already exist.
- Routes your request to the right override surface: Helps you choose between
[agent] and [workflow] customization based on what you want to change (persona, facts, templates, step behavior, output behavior).
- Writes sparse, merge-safe override files: Produces only the fields you want to change and follows explicit merge semantics (scalars override; arrays append; keyed table entries replace by key).
- Verifies the result via the resolver: Runs
resolve_customization.py (or falls back to manual reasoning) so you can confirm the merged configuration actually changed the intended fields.
Use case example: You want to adjust the prompt persona and also swap a workflow template for one specific workflow; you can generate a team or user TOML override that applies persona changes at the agent level while applying the template swap at the workflow level, then verify the merged output.
Quick Start
Use the bmad-customize skill to customize an installed BMad workflow by saying: "customize bmad and override bmad-create-prd so it uses my preferred template and adjusts the activation steps."
