bmad-customize Skill for Claude Code: Customize Your BMad Skills

BMad Method skill that writes the override files that change how your installed BMad agents and workflows behave.

Installs: 12.5K; on skills.sh
Stars: 54.9K; on GitHub
Files: 3; besides SKILL.md
Updated: Nov 2026; last repo commit

Say what you want to change, such as an agent's tone or a workflow's output path, and it finds the right skill, writes a small TOML override and checks the merged result. It places the file as a team override or a personal one.

It works in a project where BMad is set up and stops if the _bmad folder is missing. It does not cover central config or step logic that a skill does not expose. The folder has 4 files including SKILL.md, with one Python helper and its tests.

Good for

BMad users who want their agents to follow team conventions
Developers who want a different output template or a step before a workflow starts
Anyone who asks "what can I customize?"

Install bmad-customize

Claude Code

Copy this prompt.

Install the bmad-customize skill in Claude Code. Run this command:

/plugin marketplace add bmad-code-org/bmad-plugins

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

bmad-customize needs BMad set up in your project: its SKILL.md runs a script from the project's _bmad folder and tells the agent to run the bmad skill's setup when that script is missing. Pick one route, not both. The marketplace manifest lists this skill's folder under the bmad-toolbox plugin, so install bmad-toolbox after you add the marketplace, plus the plugin that holds the bmad skill (the bmad-plugins README names bmad-method and bmad-toolbox). Then ask the bmad skill to run bmad setup. Skills CLI route: it asks which coding tools to install to, so choose Claude Code, then ask the bmad skill to run bmad setup. BMad needs uv for its setup and Python scripts. The README calls v7 a preview alpha with breaking changes between updates.

From the project README. Source.

What's in the skill

When it loads

Authors and updates customization overrides for installed BMad skills. Use when the user says 'customize bmad', 'override a skill', 'change agent behavior', or 'customize a workflow'

Sections in SKILL.md

Preflight
Activation
Step 1: Classify intent
Step 2: Discovery
Step 3: Determine the right surface
Step 4: Compose the override
Step 5: Team or user placement
Step 6: Show, confirm, write, verify
Complete when
When this skill can't help

Key facts

Author: BMad Code (owner of the bmad-code-org/bmad-method repo)
License: README and the plugin marketplace manifest say MIT; GitHub reports no detected license
Installs on skills.sh: 12,544 as of 2026-11-02
GitHub stars: 54,859 for the whole bmad-code-org/bmad-method repo, 2026-11-02
Last repo commit: 2026-11-01
Files: 4 files including SKILL.md (1 Python helper and its tests)
Needs: BMad set up in the project; uv runs its scripts (SKILL.md)

What it includes

Sorts your request as directed, exploratory, audit or cross-cutting.
Read · Step 1: Classify intent
Lists customizable agents and workflows and which already have overrides.
Runs list_customizable_skills.py, which scans sibling skill folders.
Runs code · Step 2: Discovery
Reads the target's customize.toml and picks agent or workflow level.
Read · Step 3: Determine the surface
Writes a sparse TOML change that only holds the fields you are changing.
Read · Step 4: Compose the override
Chooses a team file or a personal .user.toml file and confirms with you.
Read · Step 5: Team or user placement
Shows the file, waits for a yes, writes it and shows the merged result.
Writes under _bmad/custom/.
Runs code · Step 6: Show, confirm, write, verify

From the official docs

Permissions

Low risk

It writes configuration files that change how your other BMad skills behave. It shows you the full file and waits for a yes first.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It writes override files that change other skills
Overrides in _bmad/custom/ change how other BMad skills behave. The skill shows the full TOML and waits for your yes before it writes. github.com
Team overrides are meant to be committed
SKILL.md puts team overrides in a committed file and personal ones in a user file it calls gitignored. Check which one it picked. github.com
This is a preview release
The BMAD-METHOD README calls v7 a preview alpha with breaking changes between updates. github.com

Technical details

Scopes	Runs scripts/list_customizable_skills.py, which scans sibling skill folders Runs uv run on _bmad/scripts/resolve_customization.py to show the merged result after it writes Reads each skill's customize.toml and SKILL.md description Writes TOML override files under _bmad/custom/ after you say yes

Questions

What does bmad-customize do?

It writes TOML override files for installed BMad agent and workflow skills, then shows you the merged result. It only changes fields that a skill's customize.toml exposes.

How do I install it?

Use the install box at the top of this page. After installing, ask the bmad skill to run bmad setup, because this skill needs BMad set up in the project.

Does it work in the Claude app or claude.ai?

This page documents no install for the Claude app. The skill needs a project folder with BMad set up, so the box lists Claude Code, Codex and the skills CLI.

Is it safe?

It writes configuration files under _bmad/custom/, which change how your other BMad skills behave. SKILL.md says it shows the full TOML and waits for an explicit yes before writing.

What can it not change?

Per SKILL.md it does not cover central config, step logic or skills without a customize.toml. It suggests approximations or the bmad-toolsmith skill, if installed.

Team or personal override?

A team file is committed and meant for policies and conventions. A user file is for personal tone and shortcuts, and SKILL.md calls it gitignored.

Information

updated Nov 2, 2026

Repository: bmad-code-org/bmad-method
Folder: skills/bmad-customize

bmad-code-org/bmad-method skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

README.md · github.com
README.md · github.com
marketplace.json · github.com
SKILL.md · github.com
list_customizable_skills.py · github.com