bmad-customize

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

Updated May 22, 2026
One-click install
npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-customize-asygnuz-s-a-s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-customize
Source: https://github.com/Asygnuz-S-A-S/one-star/tree/main/.claude/skills/bmad-customize
Command: npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-customize-asygnuz-s-a-s

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Customizing BMad agents and workflows requires knowing where override files live, which fields each skill exposes, and how team and user layers merge. This Skill translates plain-English change requests into correctly placed, verified TOML overrides under _bmad/custom/ without manual file hunting. ## Core Features & Use Cases - Discovery and routing: Scans installed skills for customize.toml surfaces, classifies them as agent or workflow, and reports existing team/user overrides via a Python script. - Guided override authoring: Composes sparse TOML overrides with correct merge semantics (scalars override, arrays append, keyed tables merge by code/id) and places them as team (.toml) or user (.user.toml) files. - Verification loop: Runs the BMad customization resolver to confirm the override landed, with a manual merge fallback when the resolver is missing. - Use Case: A user says "make the PM agent always include our compliance checklist." The Skill discovers the agent's exposed fields, writes bmad-agent-pm.toml with a persistent_facts entry, and verifies the merged result. ## Quick Start Ask the assistant to customize a BMad skill, for example: change the PRD workflow to use a different output template for this project.

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?▼

Invoke the customize flow and describe the change 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 or user 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 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. Arrays such as persistent_facts and activation steps append in order. Keyed arrays of tables merge by their `code` or `id` field, with matching keys replaced.

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.

Why did my BMad override not take effect?▼

Common causes are a wrong field name, wrong merge mode (scalar versus array), or wrong file scope. The verification step runs the resolve_customization.py resolver or a manual base-team-user merge to show exactly how fields resolve.