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.