bmad-customize

Translate BMad customization requests into sparse TOML override files under _bmad/custom/.

1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/mol4/BMAD-Board --skill bmad-customize-mol4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-customize
Source: https://github.com/mol4/BMAD-Board/tree/main/BMAD%20board/.agents/skills/bmad-customize
Command: npx skills add https://github.com/mol4/BMAD-Board --skill bmad-customize-mol4

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you customize installed BMad skills without editing core skill files, so you can safely change behavior, persona, facts, and workflow options in the right project-local override location.

Core Features & Use Cases

  • Discover whether the target is an agent skill or a workflow skill.
  • Write sparse TOML override files into _bmad/custom/ with the correct team or user scope.
  • Respect existing overrides and merge them additively instead of overwriting the base skill.
  • Verify the result using the resolver or a manual fallback merge when the resolver is unavailable.
  • Use it when you want to change an agent's tone, role, persistent facts, menu items, workflow templates, or on-complete behavior.

Quick Start

Tell the skill which BMad agent or workflow you want to customize and describe the exact change you want to make.

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 behavior without editing core files?

You can customize BMad agent behavior by writing sparse TOML override files into the _bmad/custom/ directory, which safely modifies roles and menus without altering the base skill.

How do I change workflow templates and on-complete behavior for installed BMad skills?

Change workflow templates and on-complete behavior by applying project-local TOML overrides under _bmad/custom/, using the skill's customize.toml surface to target specific workflow configurations.

What is the best way to override persistent facts and personas in BMad workflows?

Overriding persistent facts and personas requires authoring sparse TOML files into the correct team or user scope within _bmad/custom/, preserving merge semantics to additively update the base skill.

Does customizing BMad skills overwrite the default configuration?

No, customizing BMad skills respects existing overrides and merges them additively instead of overwriting the base skill, ensuring your customizations remain safe and isolated.

How do I verify that my BMad TOML overrides merge correctly?

Verify your BMad TOML overrides by running the resolver to check the merged output, or use a manual fallback merge to test results when the resolver is unavailable.

Can I apply project-specific facts to BMad agent skills?

Yes, you can apply project-specific facts to BMad agent skills by generating correctly placed override files that inject custom data into the agent's configuration scope.