bmad-customize

Generate per-skill TOML overrides for installed BMad skills.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-customize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-customize
Source: https://github.com/florian-trehaut/bmad-global/tree/main/src/core-skills/bmad-customize
Command: npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-customize

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Translates user intent into per-skill customization TOML overrides for installed BMad skills.

Core Features & Use Cases

  • Determine whether a skill exposes an agent and/or workflow surface by reading its customize.toml.
  • Generate and place team- or user-scoped TOML overrides under {project-root}/_bmad/custom/.
  • Validate changes with resolver tooling to ensure safe, auditable merges.

Quick Start

Run the customize skill to generate and place per-skill override TOML files.

Frequently Asked Questions about bmad-customize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create per-skill TOML overrides to customize installed BMad skills?

To create per-skill TOML overrides, run the customize skill to generate and place team- or user-scoped override files under your project's _bmad/custom/ directory, ensuring safe and auditable merges.

What is the customize.toml surface block used for in BMad workflows?

The customize.toml surface block determines whether a BMad skill exposes an agent and/or workflow surface, allowing you to apply targeted TOML overrides across those specific automation and workflow surfaces.

How do I validate TOML override merges for BMad skills?

You validate TOML override merges by running resolver tooling after writing your per-skill overrides, ensuring that team and user customizations merge safely and remain auditable within your project.

Where should per-skill customization TOML files be placed in my project?

Per-skill customization TOML files must be placed under the {project-root}/_bmad/custom/ directory, where the skill handles generation, placement, and merging semantics for both team and user scopes.

Do I need to parse SKILL.md frontmatter before generating BMad TOML overrides?

Yes, generating BMad TOML overrides requires parsing the skill's SKILL.md frontmatter and customize.toml surface blocks to correctly identify exposed surfaces and apply the appropriate agent and workflow overrides.

Can I scope BMad skill customizations separately for team and user environments?

Yes, you can generate and place TOML overrides using either team-scoped or user-scoped configurations, allowing distinct customization semantics that are validated through the resolver tooling for safe merges.