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

bmad-builder — скилл для Claude Code: что делает и как установить

Скилл bmad-builder для Claude Code создаёт и проверяет новые скиллы планирования в плагине BMAD. Генерирует структуру каталогов и следит, чтобы логика не выходила за рамки оркестрации.

MIT 102 установок ★ 493 обновлён 2026-06-20

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

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

Скилл генерирует рабочие каталоги для новых компонентов планирования BMAD и проверяет готовые файлы SKILL.md. Внутрь пакета входят скрипт разметки структуры scaffold-skill.sh, проверяльщик validate-skill.sh и Markdown-шаблоны под артефакты.

Инструмент поддерживает три намерения: Create для сборки скилла с нуля, Validate для аудита существующего описания и Scaffold для подготовки пустых папок. Вся работа строго ограничена планированием и формированием историй. Скилл запрещает писать прикладной код, запускать тесты, линтеры или сборку проекта.

Проверка через validate-skill.sh контролирует имя в нижнем регистре с дефисом, блок триггеров в описании, размер текста до ~5K токенов и блок об авторстве. Скрипт сразу бракует инструкции, если агент пытается взять на себя задачи разработки вместо передачи готовых спецификаций внешним исполнителям.

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

  • развернуть структуру каталогов и файлов для нового скилла BMAD
  • проверить готовый SKILL.md на нарушение границ планирования
  • подготовить шаблоны историй и проектных документов по правилам BMAD
  • настроить список разрешённых инструментов перед передачей в разработку

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

  • Создай новый планировочный скилл bmad-code-review через bmad-builder
  • Проверь файл skills/bmad-tester/SKILL.md на нарушения границ планирования
  • Разверни каркас каталогов для скилла bmad-deployer без генерации текста

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

1Через Skills CLI (Vercel)

npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-builder -a claude-code

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

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

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

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

Вопросы о bmad-builder

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

Выполните команду npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-builder -a claude-code. Файл спецификации сохранится по пути ~/.claude/skills/bmad-builder/SKILL.md.

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

Создаёт папки и шаблоны для скиллов плагина BMAD, а также проверяет разметку метаданных. Он удерживает агента в роли планировщика и блокирует попытки писать код приложений.

Что проверяет скрипт валидации скилла?

Скрипт validate-skill.sh ищет запрещённые команды сборки и тестирования, сверяет лимит размера до ~5K токенов и проверяет наличие обязательного подвала с авторством.

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

SKILL.md · MIT
---
name: bmad-builder
description: |
  Meta-skill for scaffolding and validating custom PLANNING/ORCHESTRATION skills within the BMAD Planning & Orchestrator plugin. Produces the full skill directory: SKILL.md, scripts, and templates — all pre-targeted at this plugin's path conventions. Includes a scope-violation checker so newly created skills never drift into dev/lint/build/coverage territory. Use when the user says "create a skill", "scaffold a skill", "build a new planning skill", "add a skill to the orchestrator", "extend BMAD planning", "custom orchestration skill", "validate this skill", "check this skill for scope violations", "new skill for the planner", or "bmad-builder". Supports three intents: Create (new skill skeleton), Validate (check an existing SKILL.md), Scaffold (directory structure only). This skill plans and scaffolds only — it NEVER writes application code, runs tests, lints, or builds.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite
---

# BMAD Builder

**Function:** Scaffold and validate custom planning/orchestration skills for the BMAD Planning & Orchestrator plugin. Produces compliant SKILL.md files, shell scripts, and templates — pre-wired to this plugin's path conventions — and runs scope-violation checks to keep new skills inside the PLAN/ORCHESTRATE boundary.

## Scope (PLAN, never build)

This skill produces planning artifacts and skill skeleton files. It does NOT write application code, run tests, lint, check coverage, or execute builds. If a skill being designed is tempted to "implement", "fix the code", "run the suite", or "review the diff" — that is a scope violation. Plan and hand off instead.

## Three intents

Always clarify which intent applies before starting.

### Create — new planning skill from scratch

1. Gather requirements (use TodoWrite to track):
   - Skill name (lowercase-hyphen, prefixed `bmad-`; e.g. `bmad-example`)
   - What planning/orchestration problem it solves
   - Trigger phrases users will say
   - Allowed tools (subset of: Read, Write, Edit, Bash, Glob, Grep, WebSearch, WebFetch, TodoWrite)
   - Which BMAD track(s) it applies to (Quick Flow / BMad Method / Enterprise)
   - Upstream BMAD counterpart (e.g. `bmad-risk-assessment`)

2. Run the scaffold script to create the directory:
   ```bash
   bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/scaffold-skill.sh <skill-name>
   ```
   This creates `skills/<skill-name>/` with `scripts/` and `templates/` subdirectories and a starter SKILL.md.

3. Fill the SKILL.md using the skill template:
   - Reference: `${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/templates/skill.template.md`
   - Keep body under 5K tokens; push long reference detail to a sibling `REFERENCE.md` in the new skill's own folder
   - Use `${CLAUDE_PLUGIN_ROOT}` for all paths to bundled scripts/templates
   - Artifacts go to `bmad-output/` (honor user-configured folder)
   - End with the mandatory attribution footer (see template)

4. Validate the new skill:
   ```bash
   bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/validate-skill.sh \
     ${CLAUDE_PLUGIN_ROOT}/skills/<skill-name>/SKILL.md
   ```
   Fix all errors; review all warnings before declaring done.

### Validate — check an existing SKILL.md

Run the validator directly against any SKILL.md path:
```bash
bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/validate-skill.sh <path-to-SKILL.md>
```

The validator checks:
- `name` field present and lowercase-hyphen
- `description` field present with trigger phrases
- `allowed-tools` field present (warns if missing)
- No dev/lint/build/coverage scope violations in `allowed-tools` or body
- File size within the ~5K token target (~20KB)
- Attribution footer present

### Scaffold — directory structure only

Use when you want an empty directory skeleton without generating content:
```bash
bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-builder/scripts/scaffold-skill.sh <skill-name>
```
Then fill SKILL.md manually using the template as a guide.

## Scope law for new skills

Every skill created by this builder MUST comply with the Scope Law:

- The plugin PLANS and ORCHESTRATES. It NEVER writes application code, runs tests, lints, checks coverage, builds, or reviews implemented code.
- The last artifact any skill may produce is a ready-for-dev story file or a handoff manifest. Implementation is handed to EXTERNAL dev tools/plugins.
- Acceptance Criteria, Testing STRATEGY, and Dev Notes are planning — allowed. Executing tests or writing implementation code is out of scope.

The `validate-skill.sh` script enforces this automatically by flagging forbidden terms.

## BMAD fidelity reminders

When designing skills, track the BMAD Method conventions:

| Convention | Rule |
|------------|------|
| Scale Tracks | Quick Flow / BMad Method / Enterprise — user confirms interactively |
| Story size | ~2-8h, one dev-day max; split if larger |
| Delivery tracking | Stories remaining / completion rate — NO Fibonacci points, velocity, or burndown |
| Story name | `{epic}.{story}.{slug}.story.md` |
| Story status | backlog → ready-for-dev → in-progress → review → done |
| Decision log | Decisions thread through `decision-log.md` |
| Project constitution | `project-context.md` loaded across skills |
| Three intents | Create / Update / Validate where applicable |

## Available scripts

| Script | Purpose |
|--------|---------|
| `scripts/scaffold-skill.sh <name>` | Creates `skills/<name>/` with subdirs and starter SKILL.md |
| `scripts/validate-skill.sh <SKILL.md>` | Validates frontmatter, scope, size, and attribution footer |

Invoke with the `${CLAUDE_PLUGIN_ROOT}` prefix shown above. The orchestrator marks scripts executable; you may also run them via `bash`.

## Templates

| Template | Use for |
|----------|---------|
| `templates/skill.template.md` | Skeleton for a new planning/orchestration SKILL.md |
| `templates/document.template.md` | Generic planning document (PRD section, brief, spec section, etc.) |

## Subagent strategy

For creating a full skill package in parallel:

| Agent | Task | Output |
|-------|------|--------|
| Agent 1 | Draft SKILL.md body from gathered requirements | `skills/<name>/SKILL.md` |
| Agent 2 | Write domain scripts (validators, checklists) | `skills/<name>/scripts/` |
| Agent 3 | Write domain templates | `skills/<name>/templates/` |
| Agent 4 | Write REFERENCE.md if body exceeds 5K tokens | `skills/<name>/REFERENCE.md` |

Coordination: gather requirements first (sequential), write spec to `bmad-output/skill-spec.md`, then fan out. Main context validates all outputs with `validate-skill.sh` and assembles the final package.

## Notes for LLMs

- Use TodoWrite to track which components have been created.
- Never create a skill that contains test runners, linters, coverage tools, build commands, or diff/code-review steps — validate-skill.sh will flag these.
- Always end SKILL.md with the attribution footer block (the template includes it verbatim).
- Keep SKILL.md under 5K tokens; use REFERENCE.md for lengthy patterns.
- Use `${CLAUDE_PLUGIN_ROOT}` for all internal paths — never hardcode `~/.claude` or absolute machine paths.
- Output artifacts (non-skill files) go under `bmad-output/` by default.

> ---
> Part of the **BMAD Planning & Orchestrator** plugin — a Claude Code harness for the **BMAD Method** by the **BMAD Code Organization** (https://github.com/bmad-code-org/BMAD-METHOD). Implements the spirit of `bmad-bmb-builder`. All methodology credit belongs to the BMAD Code Organization.

© aj-geddes · MIT · aj-geddes/claude-code-bmad-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
bmad-agent-pm bmad-code-org Скилл bmad-agent-pm для Claude Code и Cursor выступает в роли менеджера продуктов Джона для написания, обновления и проверки планов проектов. CX Codex +1 17 800установок bmad-auto bmad-labs Скилл bmad-auto оркеструет реализацию задач по методологии BMAD: ведёт конвейер историй Phase 4 либо переключается на Quick Flow для точечных правок. CX Codex +1 145установок bmad-architecture bmad-code-org Скилл bmad-architecture пишет короткий архитектурный документ: фиксирует только те решения, без которых независимо собранные части системы разойдутся. CX Codex +1 17 800установок bmad-idea akillness Скилл bmad-idea превращает сырую идею в один концепт-артефакт и подсказывает, к какому скиллу идти дальше. Нужен до PRD и спринт-планов. CX Codex +1 368установок bmad-marketing-growth-module reason-machines Скилл bmad-marketing-growth-module для Claude Code объединяет 14 агентов и 6 воркфлоу BMAD Framework для маркетинга SaaS: от стратегии до постов для отдельных площадок. CX Codex +1 910установок bmad-gds akillness Скилл bmad-gds организует разработку игр как виртуальный продюсер. Скилл принимает дизайн-документы или заметки и строит план этапа для проектов на Unity, Unreal Engine или Godot. CX Codex +1 400установок

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

Весь набор →
bmad-brainstorm Скилл bmad-brainstorm запускает структурированные мозговые штурмы по методикам вроде SCAMPER, SWOT и «5 почему». Формирует отчёт с выводами для дальнейшего планирования. CX Codex +1 130установок bmad-tech-spec Скилл bmad-tech-spec для Claude Code создаёт компактный техспек для небольших фич вместо полного PRD и архитектуры. Он собирает один артефакт перед разработкой историй. CX Codex +1 114установок bmad-spec Скилл bmad-spec для Claude Code превращает заметки, PRD или расшифровку в короткий файл SPEC.md с пятью разделами. Он включается, когда нужно сформулировать задачу и границы проекта. CX Codex +1 108установок bmad-readiness-check Скилл bmad-readiness-check для Claude Code сверяет документы планирования перед началом разработки. Запускается по просьбе проверить готовность требований, архитектуры и эпиков к реализации. CX Codex +1 107установок bmad-document-project Скилл bmad-document-project для Claude Code сканирует готовый репозиторий в режиме чтения и сохраняет файл project-documentation.md. Документ фиксирует стек и архитектуру перед планированием дальнейших задач. CX Codex +1 104установок bmad-sprint-planning Скилл bmad-sprint-planning для Claude Code раскладывает истории по зависимостям и формирует план передачи в разработку. Запускается по просьбе упорядочить истории, составить волны или создать sprint-status.yaml. CX Codex +1 104установок bmad-investigate Скилл bmad-investigate для Claude Code расследует баги и оформляет факты в case file. Запускается по запросу найти причину ошибки, разобрать инцидент или обновить расследование. CX Codex +1 102установок bmad-init Скилл bmad-init для Claude Code разворачивает рабочую область планирования BMAD. Запускается при старте нового проекта, чтобы выбрать масштаб и создать стартовые документы. CX Codex +1 100установок

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

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