bmad-customize

Translate user intent into TOML override files for BMad skills.

4|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/curdx/curdx-flow --skill bmad-customize-curdx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-customize
Source: https://github.com/curdx/curdx-flow/tree/main/.agents/skills/bmad-customize
Command: npx skills add https://github.com/curdx/curdx-flow --skill bmad-customize-curdx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps Claude Code users apply safe, correctly-scoped customization changes to installed BMad skills without guessing TOML field names or breaking the expected override merge rules.

Core Features & Use Cases

  • Scans installed skills for customization surfaces: Enumerates which installed BMad skills expose agent and/or workflow customization blocks and reports whether team or user override files already exist.
  • Directs the user to the right override surface: Determines whether changes belong under the target skill’s [agent] or [workflow] block (or both) based on the requested behavior.
  • Composes sparse, merge-friendly TOML overrides: Writes only the fields being changed and applies correct merge semantics (scalars override, arrays append, keyed table arrays replace by key).
  • Verifies the result via the resolver: Runs resolve_customization.py to show the merged output; if verification fails, it performs a manual base → team → user merge summary.

Quick Start

Use the bmad-customize skill to add your requested behavior by running: "customize bmad to override the selected workflow so it uses my preferred template and adds the change to activation steps."

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 breaking existing TOML override merge rules?

To customize BMad agent behavior safely, this Skill translates user intent into sparse TOML override files and applies correct merge semantics, ensuring arrays append and keyed table arrays replace by key without breaking base configurations.

Can I swap workflow templates and add activation steps for installed BMad skills?

Yes, you can swap workflow templates and add activation steps by directing requested changes to the target skill’s `[workflow]` block, composing merge-friendly TOML overrides that only write the fields being changed.

How does TOML override verification work when customizing Claude Code agent personas?

TOML override verification works by running `resolve_customization.py` to show the merged output, and if verification fails, it performs a manual base to team to user merge summary to validate the final agent persona configuration.

What is the best way to manage team and user override files for BMad workflow customization?

The best way to manage team and user override files is scanning installed skills to discover customization surfaces, then composing sparse overrides under agent or workflow blocks to ensure correct merge semantics across shared and individual configurations.

Why are my TOML overrides not merging correctly when changing BMad agent personas?

TOML overrides may fail to merge correctly if scalar, array, or keyed table array merge semantics are misapplied, which this Skill prevents by verifying outcomes via the resolver and performing fallback manual merging when needed.