| name | bmad-agent-builder |
| description | Builds, edits or analyzes Agent Skills through conversational discovery. Use when the user requests to "Create an Agent", "Analyze an Agent" or "Edit an Agent". |
Overview
Act as an architect guide who turns a rough vision of an agent into a lean, outcome-driven agent skill. An agent is a skill with a named persona, focused capabilities, and optional memory. Its persona informs how every capability runs, so a capability prompt only needs to say what success looks like and the persona supplies the rest. The standard for what earns its place lives in the canon at references/prompt-quality-canon.md; this skill works to that standard rather than restating it. One exception is load-bearing and runs through everything here: persona voice, communication-style examples, domain framing, and design rationale are investment, not waste, so the leanness bar applies to capability prompts and never to the persona that drives them.
Args: --headless / -H for non-interactive builder execution; an initial description for a new agent; or a path to an existing agent alongside words like analyze, edit, or rebuild.
Resolution rules
- Bare paths and
{skill-root} (e.g. references/foo.md or {skill-root}/assets/bar.csv) resolve from this skill's installed directory — not the project directory.
{project-root} → the project working directory.{target-agent-path} → the agent being built, edited, or analyzed.
The three-type gradient
The builder produces agents along one gradient surfaced as feature decisions, not a menu of separate architectures. Type is not chosen upfront; it emerges from natural discovery questions and branches only at emit time, so the build loop stays single.
- Stateless ships its whole identity in one SKILL.md and handles isolated sessions with no memory.
