bmad-customize

Generate project-local TOML override files for BMad agents and workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, tomllib, and includes scripts (resource) components.

What problem does it solve?

This Skill helps you customize how BMad agents and workflows behave in your project by creating the correct override files, without guessing TOML fields or silently overwriting anything.

Core Features & Use Cases

  • Discover customizable BMad skills by scanning installed sibling skills that expose an agent and/or workflow surface.
  • Choose the correct surface (agent vs workflow) based on what you want to change, then generate sparse TOML overrides that match the target skill’s customize.toml schema.
  • Write and verify overrides safely by showing the full TOML (and diffs when files already exist), waiting for explicit confirmation, and running the project resolver to confirm the merged result.
  • Use cases: updating an agent’s persona or working style, adjusting workflow activation steps, changing templates or step behavior, and auditing what is already overridden.

Quick Start

Tell the skill what BMad agent or workflow you want to change and exactly how you want it to behave, then accept the proposed TOML override after you review the diff and the resolver output.

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 overwriting default configuration files?

You can change an agent's persona, persistent facts, and working style by creating sparse TOML overrides targeting the agent surface. The Skill matches your desired behavior to the target skill's customize.toml schema and verifies the merged result.

How do I adjust BMad workflow templates and activation steps for a specific project?

You adjust workflow templates and activation steps by generating TOML overrides for the workflow surface. The Skill composes the override file matching the target schema, shows you a diff of changes, and waits for your explicit confirmation before writing.

What is the correct TOML merge layering when tuning BMad workflows?

BMad workflow tuning uses a base to team to user layering merge semantic. The resolve_customization.py script verifies this hierarchy, ensuring your project-local user overrides are applied cleanly on top of team and base configurations.

Do I need Python3 and tomllib to manage BMad configuration overrides?

Yes, you need Python3 and the tomllib module installed to manage BMad configuration overrides. These dependencies are required to parse the TOML files and run the project resolver to verify the final merged configuration output.

Can I audit what BMad customizations are already applied to my project?

Yes, you can audit existing BMad customizations by scanning installed sibling skills that expose an agent or workflow surface. The Skill discovers these customizable surfaces and reviews the TOML override files already present in your _bmad/custom directory.