bmad-customize

Authors TOML override files that customize installed BMad agent and workflow skills.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-customize-mathematicguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-customize
Source: https://github.com/MathematicGuy/team-006-vin20k/tree/main/.agent/skills/bmad-customize
Command: npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill bmad-customize-mathematicguy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Teams using the BMad method often need to adjust agent personas, workflow steps, templates, or output paths without forking the installed skills. This Skill translates plain-English customization requests into correctly placed, correctly merged TOML override files under _bmad/custom/, eliminating guesswork about file naming, merge semantics, and team-versus-user placement. ## Core Features & Use Cases - Discovery of customizable skills: Runs a scanner script that lists every installed BMad skill exposing a customize.toml, grouped by agent or workflow surface, with existing override status. - Guided override authoring: Classifies intent (directed, exploratory, audit, cross-cutting), picks the right surface, composes sparse TOML overrides, and confirms before writing team (.toml) or user (.user.toml) files. - Verification with fallback: Validates the result via resolve_customization.py, or manually replays the base → team → user merge rules when the resolver is missing. - Use Case: A product manager wants the BMad PM agent to always include company compliance facts. The Skill locates bmad-agent-pm, composes a persistent_facts override in _bmad/custom/bmad-agent-pm.toml, and verifies the merged output. ## Quick Start Ask the assistant to customize a BMad skill, for example: customize the bmad agent pm to always include our compliance guidelines as persistent facts.

Frequently Asked Questions about bmad-customize

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

FAQPage Schema
How do I customize a BMad agent or workflow skill?▼

State the target skill and the change you want in plain English. The Skill reads the target's customize.toml, composes a sparse TOML override, and writes it to _bmad/custom/ as a team (.toml) or user (.user.toml) file after your confirmation.

What is the difference between team and user override files in BMad?▼

Team overrides use {skill-name}.toml and are committed to the repository for shared policies and conventions. User overrides use {skill-name}.user.toml, are gitignored, and hold personal tone, private facts, or shortcuts.

How do BMad customization overrides merge with defaults?▼

Scalars like icon or template paths are replaced by the override, append arrays like persistent_facts and principles concatenate in order, and keyed arrays of tables merge by their code or id key. Layers apply base, then team, then user.

Can I customize a BMad skill that has no customize.toml?▼

No. Skills without a customize.toml expose no customization surface and cannot be overridden. The Skill will say so and suggest using bmad-builder to create a custom skill instead.

What happens if the BMad resolver script is missing?▼

Verification falls back to a manual merge: the Skill reads the base customize.toml plus any team and user override files, applies the same merge rules, and describes how the changed fields resolve.