Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

bmad-build — Claude skill: ship reviewed code

Takes a delegated feature, story, bug fix or bare issue link and turns it into working code that has been reviewed and verified. Needs BMad set up in the project.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-build -a claude-code
Open on GitHub

What bmad-build does

The skill runs render_skill.py from _bmad/scripts/ once and then follows whatever workflow the script prints. Before that, {project-root} is replaced with the nearest folder containing _bmad/, searching upward from the working directory, and {skill-root} becomes the absolute path to the skill's own directory. Don't change the working directory.

Named options get passed through as flags. A route (oneshot or full) appends --set workflow.route=; a review selection (none, quick, thorough) appends --set workflow.review=. If the script prints HALT: , the skill reports the reason and stops.

You need uv and a project where BMad is already configured. When the script is missing, the skill offers to set BMad up through the bmad skill and then retries. Any other failure, including uv not being available, ends the run with the command output reported — the workflow sources are never executed directly. Worth installing if you hand whole tasks to an agent and want review in the loop; skip it for typo or formatting edits.

What it helps with

  • turn a delegated feature into working code
  • fix a bug from an issue link
  • run a change through review before committing
  • pick the right review depth for a task
  • set up BMad when the project lacks it

Example prompts for the agent

  • bmad-build: add CSV export to the reports page
  • bmad-build, route full, review thorough — fix the crash on an empty list
  • bmad-build: here's the issue link, take it from there

How to install bmad-build

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/bmad-build/

From the same set25

The whole set →
bmad bmad-code-org Coordinates BMad Method modules, recommends the next skill, and tracks project initiatives. Useful when setting up or repairing your workflow. Claude Code CX Codex Cursor +1 13,100installs bmad-code-review bmad-code-org This skill runs several independent reviewers in parallel, then triages their findings. Useful when you want changes checked before a merge. Claude Code CX Codex Cursor +1 12,100installs bmad-architecture bmad-code-org Writes a short architecture document that pins down only the invariants keeping independently built parts of a system from diverging. Claude Code CX Codex Cursor +1 11,800installs bmad-agent-pm bmad-code-org Activates John, a product manager persona for PRD creation and requirements discovery. It breaks down product ideas into deliverable tickets. Claude Code CX Codex Cursor +1 11,800installs bmad-agent-architect bmad-code-org This skill turns ticket requirements into technical architecture with explicit trade-offs. Use it when you want to work with Winston as the architect. Claude Code CX Codex Cursor +1 11,800installs bmad-brainstorming bmad-code-org The skill runs a brainstorming session: the agent asks one question at a time, rotates creative techniques and logs ideas to a memlog. Useful when you want more options than you'd get alone. Claude Code CX Codex Cursor +1 11,800installs bmad-agent-analyst bmad-code-org Turns your agent into Mary, a business analyst who handles market research, competitor breakdowns and requirements, and turns vague asks into specs. Claude Code CX Codex Cursor +1 11,700installs bmad-agent-dev bmad-code-org Activates Amelia, a senior software engineer persona executing stories through red, green, refactor and acceptance criteria. Claude Code CX Codex Cursor +1 11,700installs

Similar

smart-explore thedotmack Uses tree-sitter to map code structure and find symbols. Useful when you need to explore a codebase without loading every full file. Claude Code CX Codex Cursor +1 7,300installs workers-best-practices cloudflare Guides coding agents on production Cloudflare Workers standards, Wrangler typing, observability setup, and runtime anti-pattern checks. Claude Code CX Codex Cursor +1 124,900installs claude-automation-recommender official Anthropic Analyzes a codebase and recommends Claude Code hooks, subagents, skills, plugins, and MCP servers. Useful when setting up a project or refining an existing workflow. Claude Code 9,057installs do thedotmack The skill runs an implementation plan in phases through subagents. Use it when a plan needs execution with checks after each phase. Claude Code CX Codex Cursor +1 7,000installs improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. Claude Code 1,163,035installs tdd Matt Pocock Guides the red-green TDD loop: ensures tests are written first, keep them at public interfaces, and avoid coupling to implementation details. Claude Code 1,141,062installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. Claude Code 990,453installs codebase-design Matt Pocock This skill helps design modules with small interfaces and hidden complexity. Use it when refactoring code, choosing a seam, or making tests easier to write. Claude Code 850,344installs

Questions about bmad-build

How do I install bmad-build in Claude?

Run npx skills add bmad-code-org/BMAD-METHOD --skill bmad-build -a claude-code. The skill lands at ~/.claude/skills/bmad-build/SKILL.md.

What does bmad-build do?

It takes implementation work you delegate — a feature, story, bug fix or meaningful change — and drives it to code that is reviewed and verified. A bare story or issue link is enough to trigger it.

What does bmad-build need to run?

BMad has to be set up in the project and uv must be available. If render_skill.py is missing, the skill offers to set BMad up first and then runs the command again.

Source text

SKILL.md · MIT
---
name: bmad-build
description: 'Turns implementation work into working code, reviewed and verified. Use when the user delegates a feature, story, bug fix, or meaningful change; a bare story or issue link counts. Skip obvious, low-risk mechanical maintenance such as small ignore-file, typo-only, formatting-only, or configuration-hygiene edits. Explicit BMAD requests always qualify. Do not volunteer for user-directed interactive edits or version-control operations that only record existing work.'
---

Run the following command exactly once without changing the current working directory.

Replace `{project-root}` with the nearest folder containing `_bmad/`, from the working directory upward.
Replace `{skill-root}` with the absolute path to this skill's directory.

```bash
uv run --no-cache "{project-root}/_bmad/scripts/render_skill.py" --project-root "{project-root}" --skill "{skill-root}"
```

- When the invocation names a route (`oneshot` or `full`), append `--set workflow.route=<value>` to the command.
- When the invocation names a review selection (`none`, `quick`, or `thorough`; "skip review" or "no review" mean `none`), append `--set workflow.review=<value>` to the command.
- The command prints the skill's workflow: follow it. `HALT: <reason>`: report the reason and stop.
- If the script does not exist, BMad is not set up in this project yet. Offer to set it up using `bmad` skill, then run the command again. If you do not have the `bmad` skill, offer to install it first.
- On any other output or failure, including `uv` being unavailable, report the command output and stop. Do not run any workflow source directly.

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

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor