bmad-customize

Automate discovery, authoring, placement, and verification of BMad TOML customization overrides.

Updated May 5, 2026
One-click install
npx skills add https://github.com/devalexanderdaza/bmad-any --skill bmad-customize-devalexanderdaza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-customize
Source: https://github.com/devalexanderdaza/bmad-any/tree/main/.agents/skills/bmad-customize
Command: npx skills add https://github.com/devalexanderdaza/bmad-any --skill bmad-customize-devalexanderdaza

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually writing and placing BMad customization override files is error-prone, risks being overwritten during skill updates, and requires specialized knowledge of BMad's merge semantics and directory structure. This Skill eliminates that friction by guiding you through the entire customization workflow, from discovery to verification.

Core Features & Use Cases

  • Skill Discovery: Automatically scans installed BMad skills to list all customizable agents and workflows, flagging any that already have team or user overrides in place.
  • Guided Override Authoring: Translates plain-English customization requests into valid TOML override files that adhere to BMad's merge rules for scalars, append arrays, and keyed array tables.
  • Automated Verification: Runs the official BMad customization resolver to confirm your override applies correctly, showing the merged output so you can see exactly what changed.
  • Use Case: For example, if you want to adjust the product manager agent to use a more casual tone and add a new menu item for quick status updates, this Skill will help you write the correct override, place it in the right team or user file, and confirm the change takes effect.

Quick Start

Use the bmad-customize skill to add a new menu item for "Weekly Standup Summary" to the installed product manager agent's menu.

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 configurations without manual file editing?

BMad agent configurations can be customized by authoring TOML override files. This skill automates the discovery, placement, and verification of per-skill agent and workflow overrides to eliminate manual file editing and merge errors.

How do BMad customization overrides apply merge semantics for TOML files?

BMad customization overrides apply specific merge semantics for scalar values, append arrays, and keyed array tables. This ensures that configuration overrides integrate correctly with the base agent and workflow settings without causing conflicts.

How do I add a new menu item to an installed BMad product manager agent?

To add a new menu item to an installed BMad product manager agent, you author a TOML override file. This skill translates plain-English requests into valid override files, places them correctly, and verifies the change takes effect.

Can I separate team-committed policy overrides from personal user overrides in BMad?

Yes, BMad supports both team-committed policy overrides and gitignored personal user overrides. Personal overrides are stored under the project's _bmad/custom/ directory, keeping individual configurations separate from shared policies.

How do I verify that my BMad workflow customization applies correctly?

You can verify BMad workflow customization by running the official resolve_customization.py script. This validates correct override application and displays the merged output so you can see exactly what changed.

Do I need a customize.toml schema to use BMad workflow overrides?

Yes, a customize.toml schema is required. This skill applies to projects with installed BMad skills that expose this schema, allowing you to manage both agent and workflow TOML customization overrides effectively.