К основному содержанию
скилл CX Codex

bmad-customize · bmad-code-org, core-tools — скилл для Claude Code: правка поведения агента BMad

Скилл bmad-customize для Claude Code настраивает переопределения BMad и шаблоны документов. Запускается по просьбе изменить поведение агента, рабочий процесс или содержимое PRD.

MIT 17 000 установок ★ 55 609 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-customize -a claude-code
Открыть на GitHub

Что делает bmad-customize

Скилл создаёт TOML-переопределения для навыков агентов и рабочих процессов BMad, а изменения документов оформляет в файлах шаблонов. Он определяет подходящую область настройки, записывает изменения в _bmad/custom/ и проверяет результат. Для шаблона может скопировать исходный файл и переключить переопределение на новую копию.

Настройка ограничена полями, открытыми в customize.toml: скилл не добавляет в них новые параметры. Центральный файл _bmad/custom/config.toml не входит в область настройки. Нужна установленная структура BMad в _bmad/; если её нет, скилл предлагает запустить настройку через скилл bmad. Для поиска доступных навыков и шаблонов используются скрипты Python, запускаемые командой uv run.

Какие задачи решает

  • переопределить поведение агента BMad
  • изменить шаги или шаблон рабочего процесса
  • добавить раздел или правило в шаблон PRD
  • проверить существующие настройки BMad

Примеры запросов агенту

  • Измени стиль общения агента BMad PM для всех рабочих процессов.
  • Настрой рабочий процесс UX так, чтобы он использовал другой шаблон.
  • Добавь в шаблон PRD раздел с критериями приёмки.

Как установить bmad-customize

1Через Skills CLI (Vercel)

npx skills add bmad-code-org/BMAD-METHOD --skill bmad-customize -a claude-code

2Вручную: положить файлы

~/.claude/skills/bmad-customize/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/bmad-customize/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о bmad-customize

Как установить bmad-customize в Claude Code?

Запусти npx skills add bmad-code-org/BMAD-METHOD --skill bmad-customize -a claude-code. Файл скилла находится по пути ~/.claude/skills/bmad-customize/SKILL.md.

Что делает bmad-customize?

Он создаёт и обновляет TOML-переопределения для агентов и рабочих процессов BMad, а для изменений документов правит шаблоны.

Что нужно для работы bmad-customize?

В проекте должна быть настроена BMad в _bmad/. Скрипты поиска запускаются через uv run; если каталога _bmad/ нет, скилл предлагает установить и запустить скилл bmad.

Исходный текст

SKILL.md · MIT
---
name: bmad-customize
description: Authors and updates customization overrides for installed BMad skills, and changes to the document templates their agents write from. Use when the user says 'customize bmad', 'override a skill', 'change agent behavior', 'customize a workflow', or wants a document such as the PRD to ask for, contain or render something different
---

# BMad Customize

Translate the user's intent into a correctly-placed TOML override file under `{project-root}/_bmad/custom/` for a customizable agent or workflow skill, or into a template file when the change is to a document. Discover, route, author, write, verify.

Scope v1: per-skill `[agent]` overrides (`bmad-agent-<role>.toml` / `.user.toml`) and per-skill `[workflow]` overrides (`bmad-<workflow>.toml` / `.user.toml`). Central config (`{project-root}/_bmad/custom/config.toml`) is out of scope — point users at the [How to Customize BMad guide](https://docs.bmad-method.org/how-to/customize-bmad/).

When the target's `customize.toml` doesn't expose what the user wants, say so plainly. Don't invent fields.

## Preflight

- No `{project-root}/_bmad/` → BMad is not set up here. Offer to run the `bmad` skill's setup, installing `bmad` first if you do not have it (`npx skills add bmad-code-org/BMAD-METHOD --skill bmad`). Stop if the user declines.
- `{project-root}/_bmad/scripts/resolve_customization.py` missing → continue, but Step 6 verify falls back to manual merge.
- Both present → proceed.

## Activation

Greet the user. A change to a document, even one naming its skill or agent, goes to Document templates. Otherwise, if the user's invocation already names a target skill AND a specific change, jump to Step 3.

## Step 1: Classify intent

- **Directed** — specific skill + specific change → Step 3.
- **Exploratory** — "what can I customize?" → Step 2.
- **Audit/iterate** — wants to review or change something already customized → Step 2, lead with skills that have existing overrides; read the existing override in Step 3 before composing.
- **Cross-cutting** — could live on multiple surfaces → Step 3, choose agent vs workflow explicitly with the user.
- **Document** — names a document type (a PRD, a brief, a postmortem) or a change to what one asks for, contains or renders → Document templates. The user need not know which skill writes it.

## Step 2: Discovery

```
uv run {skill-root}/scripts/list_customizable_skills.py --project-root {project-root}
```

Use `--extra-root <path>` (repeatable) if the user has skills installed in additional locations.

Group the returned `agents` and `workflows` for the user; for each show name, description, whether `has_team_override` or `has_user_override` is true. Surface any `errors[]`. For audit/iterate intents, lead with already-overridden entries.

Empty list: show `scanned_roots`, ask whether skills live elsewhere (offer `--extra-root`); otherwise stop.

## Step 3: Determine the right surface

Read the target's `customize.toml`. Top-level `[agent]` or `[workflow]` block defines the surface.

If a team or user override already exists, read it first and summarize what's already overridden before composing.

**Cross-cutting intent — walk both surfaces with the user:**
- Every workflow a given agent runs → agent surface (e.g. `bmad-agent-pm.toml` with `persistent_facts`, `principles`).
- One workflow only → workflow surface (e.g. `bmad-ux.toml` with `activation_steps_prepend`).
- Several specific workflows → multiple workflow overrides in sequence, not an agent override.

**Single-surface heuristic:**
- Workflow-level: template swap, output path, step-specific behavior, or a named scalar already exposed (`*_template`, `on_complete`). Surgical, reliable.
- Agent-level: persona, communication style, org-wide facts, menu changes, behavior that should apply to every workflow the agent dispatches.

When ambiguous, present both with tradeoff, recommend one, let the user decide.

Intent outside the exposed surface (step logic, ordering, anything not in `customize.toml`): say so; offer `activation_steps_prepend`/`append` or `persistent_facts` as approximations, or, if `bmad-toolsmith` is installed, recommend it to create a custom skill.

## Step 4: Compose the override

Translate plain-English into TOML against the target's `customize.toml` fields. If an existing override was read, frame the change as additive.

Merge semantics:
- **Scalars** (`icon`, `role`, `*_template`, `on_complete`) — override wins.
- **Append arrays** (`persistent_facts`, `activation_steps_prepend`/`append`, `principles`) — team/user entries append in order.
- **Keyed arrays of tables** (menu items with `code` or `id`) — matching keys replace, new keys append.

Overrides are sparse: only the fields being changed. Never copy the whole `customize.toml`.

**Template swap** (`*_template` scalar): offer to copy the default template to `{project-root}/_bmad/custom/{skill-name}-{purpose}-template.md`, point the override at the new path, offer to help edit it.

## Document templates

Every document `bmad-facilitate` writes, John's (`bmad-agent-pm`) and Mary's (`bmad-agent-analyst`) included, comes from a markdown template, not from TOML. The format is at `https://docs.bmad-method.org/customize/write-a-document-template/`.

1. Find the template: `uv run {project-root}/_bmad/scripts/list_templates.py --libraries-of <bmad-facilitate's folder> --libraries-of <each installed agent whose customize.toml sets template_libraries> --project-root {project-root} --root <folder> --brief`, one `--root` per skills folder. Match the user's words to a template id; when more than one fits, such as `prd` and `prd-light`, ask which, or both.
2. Sort each change. About this document type → a template file: a section to add, one made required or optional, the order, an input to ask for, a writing or review rule, its rubric, its view, or whether its HTML view is made (`html_view`). For every document → `bmad-facilitate.toml` through Steps 4–6: `html_view` for all, `style`, `doc_standards`, reviewers, output. When it could be either, ask, offering this document type first.
3. Extend by default: `{project-root}/_bmad/custom/facilitate-templates/<id>-<purpose>.md`, or the user's existing extension of that id, updated. Read the template first, its `file` from the listing with `--template <id>`, then write only the change under `extends: <id>` frontmatter:
   - A `##` section with a comment saying where it goes and what to ask. It is required unless the comment starts `optional` or `include when`. To replace a template section, use its heading and say so in the comment.
   - `stance`, `inputs`, `writing` or `done when` comments, added to the template's.
   - `description`, `not_for`, `guidance`, `rubric`, `methods`, `output`, `style`, `view` or `html_view` frontmatter, replacing the template's.
   - `facilitation_order` only to reorder or remove the template's own sections; it replaces the whole order, and a template section it leaves out is removed, including one the template adds in a later update. Never set it just to place a new section: the section's comment places it.
4. Copy only when the change outgrows an extension. To rebuild the document everywhere, copy it into that folder with its `template` id kept. For a different document beside it, such as a PRD for one team, give the copy a new id (`prd-billing`), its own `description` and `not_for`, and `agents:` naming the agent that should offer it; extensions of the original do not reach it. Either way, say the copy no longer receives updates to the original.
5. Placement: the project folder is the team's, committed. A personal template for every project goes in `~/.bmad/facilitate-templates/`.
6. Show the file, wait for an explicit yes, and write it. Verify by running the listing again with `--template <id>` in place of `--brief`: show the template's `extensions`, merged `facilitation_order`, `removed`, `view` and `html_view`, and fix any `order_problems` before finishing.

## Step 5: Team or user placement

Under `{project-root}/_bmad/custom/`:
- `{skill-name}.toml` — team, committed. Policies, org conventions, compliance.
- `{skill-name}.user.toml` — user, gitignored. Personal tone, private facts, shortcuts.

Default by character (policy → team, personal → user), confirm before writing.

## Step 6: Show, confirm, write, verify

1. Show the full TOML. If the file exists, show a diff. Never silently overwrite.
2. Wait for explicit yes.
3. Write. Create `{project-root}/_bmad/custom/` if needed.
4. Verify:
   ```
   uv run {project-root}/_bmad/scripts/resolve_customization.py --skill <install-path> --project-root {project-root} --key <agent-or-workflow>
   ```
   Show the merged output, point out the changed fields.

   **Resolver missing or fails:** read whichever layers exist — `<install-path>/customize.toml` (base), `{project-root}/_bmad/custom/{skill-name}.toml` (team), `{project-root}/_bmad/custom/{skill-name}.user.toml` (user) — apply base → team → user with the same merge rules (scalars override, tables deep-merge, `code`/`id`-keyed arrays merge by key, all other arrays append), describe how the changed fields resolve.

   **Verify shows override didn't land** (field unchanged, merge conflict, file not picked up): re-enter Step 4 with the verify output as context. Usually wrong field name, wrong merge mode (scalar vs array), or wrong scope.
5. Summarize what changed, where the file lives, how to iterate. Remind the user to commit team overrides.

## Complete when

- Override or template file written (or user explicitly aborted).
- User has seen resolver or listing output (or manual fallback merge summary).
- User has acknowledged the summary.

Otherwise the skill isn't done — finish or tell the user they're exiting incomplete.

## When this skill can't help

- **Central config** (`{project-root}/_bmad/custom/config.toml`) — see the [How to Customize BMad guide](https://docs.bmad-method.org/how-to/customize-bmad/).
- **Step logic, ordering, behavior not in `customize.toml`** — open a feature request, or, if `bmad-toolsmith` is installed, use it to create a custom skill. Offer to help with either.
- **Skills without a `customize.toml`** — not customizable.

© bmad-code-org · MIT · bmad-code-org/BMAD-METHOD

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — bmad-customize от других авторов.

bmad-customize bmad-code-org Скилл bmad-customize для Claude Code, Codex, Cursor и других платформ. Создаёт TOML-файлы переопределений для BMad-агентов и воркфлоу в _bmad/custom/. CX Codex +1 17 000установок bmad-tech-spec aj-geddes Скилл bmad-tech-spec для Claude Code создаёт компактный техспек для небольших фич вместо полного PRD и архитектуры. Он собирает один артефакт перед разработкой историй. CX Codex +1 114установок bmad-spec aj-geddes Скилл bmad-spec для Claude Code превращает заметки, PRD или расшифровку в короткий файл SPEC.md с пятью разделами. Он включается, когда нужно сформулировать задачу и границы проекта. CX Codex +1 108установок bmad-marketing-growth-module reason-machines Скилл bmad-marketing-growth-module для Claude Code объединяет 14 агентов и 6 воркфлоу BMAD Framework для маркетинга SaaS: от стратегии до постов для отдельных площадок. CX Codex +1 910установок bmad-tea-automate bmad-code-org Скилл bmad-tea-automate для Claude Code генерирует тесты в режимах red или expand и чинит обнаруженные дефекты. Агент подключает его при запросах на автоматизацию тестов и ATDD. CX Codex +1 887установок bmad-tea-evaluate bmad-code-org Скилл bmad-tea-evaluate для Claude Code проводит поведенческую оценку агента и помогает закрыть найденные пробелы. Запускается по просьбе оценить агента или подтвердить, что он ведёт себя правильно. CX Codex +1 866установок bmad-idea akillness Скилл bmad-idea превращает сырую идею в один концепт-артефакт и подсказывает, к какому скиллу идти дальше. Нужен до PRD и спринт-планов. CX Codex +1 368установок

Из того же набора33

Весь набор →
bmad-project-context Скилл bmad-project-context помогает составить, обновить или проверить блок инструкций в AGENTS.md для кодовых агентов. Фиксирует ошибки модели и выносит правила в файл проекта. CX Codex +1 17 200установок bmad-party-mode Скилл bmad-party-mode для Claude Code собирает обсуждение между BMAD-агентами и пользовательскими персонами. Запускает раундтейблы, объединяет несколько точек зрения и позволяет настраивать собственные партии. CX Codex +1 17 200установок bmad-qa-generate-e2e-tests Скилл bmad-qa-generate-e2e-tests для Claude Code создаёт сквозные и API-тесты для уже работающих функций. Агент подключает его по запросу на автотесты существующей функции. CX Codex +1 17 200установок bmad-deep-recon Скилл bmad-deep-recon для глубокого ресёрча: готовит промпт, обрабатывает отчёт или сам собирает данные по теме и по вашему репозиторию. CX Codex +1 17 100установок bmad-walkthrough Скилл bmad-walkthrough для Claude Code, который проводит человека по ревью коммита, PR, файла или директории. Вызывается по имени и запускает пошаговый воркфлоу через скрипт BMad. CX Codex +1 17 000установок bmad-customize Скилл bmad-customize для Claude Code, Codex, Cursor и других платформ. Создаёт TOML-файлы переопределений для BMad-агентов и воркфлоу в _bmad/custom/. CX Codex +1 17 000установок bmad-forge-idea Скилл bmad-forge-idea для Claude Code проверяет сырую идею вопросами и разными точками зрения. Запускается по просьбе проверить предположения, найти слабые места или проработать замысел. CX Codex +1 17 000установок bmad-prd Скилл bmad-prd для Claude Code и других платформ: создаёт, обновляет и проверяет PRD по заданному уровню детализации. Собирает требования в рабочий документ. CX Codex +1 14 600установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой