bmad-agent-builder
Skill1 starsChanged 7 months agoMITView on GitHub
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".
11 other projects use a version of this, 3 of them edited.
Adopted by
Most recently taken up by
- muslim-sec/skillstheir own version, first seen Nov 15, 2026
- delorenj/skillstheir own version, first seen Nov 7, 2026
- PaulKnauer/sonos-mcp-servertheir own version, first seen Oct 31, 2026
- laraxot/laravelpizza.comtheir own version, first seen Oct 8, 2026
- bmad-code-org/bmad-buildertheir own version, first seen Oct 8, 2026
- snovak7/bmad-github-zoho-pipelinetheir own version, first seen Sep 28, 2026
Used with
Projects with it also use bmad-eval-runner, bmad-dev-auto and 8 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
bmad-code-orgSkillbmad-eval-runner
Run a skill's evals and report results. Use when the user wants to evaluate a skill, run evals, benchmark a skill, validate triggers, optimize a description, or grade skill outputs.
Also in 6 projects that use this
areesh-aliSkillbmad-dev-auto
One iteration of an unattended development loop. Use when invoked by name.
Also in 4 projects that use this
airclearSkillbmad-tea
Enterprise Test Architecture (TEA) framework for quality engineering. Includes workflows for testing education (TEA Academy), risk-based test design, framework scaffolding, ATDD (Red-phase), CI/CD pipeline configuration, NFR (Non-functional) assessment, and quality auditing (0-100 scoring). Use for establishing or executing comprehensive testing strategies.
Also in 4 projects that use this
GauravRatnawatSkillbmad-ux
Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX
Also in 5 projects that use this
GauravRatnawatSkillbmad-checkpoint-preview
LLM-assisted human-in-the-loop review. Make sense of a change, focus attention where it matters, test. Use when the user says "checkpoint", "human review", or "walk me through this change".
Also in 5 projects that use this
DogaOztuzunSkillbmad-product-brief
Create or update product briefs through guided or autonomous discovery. Use when the user requests to create or update a Product Brief.
Also in 7 projects that use this
Other versions11 projects use a version of this.
Word for word · 0
None found.
Edited · 3
- DogaOztuzun/branchdeck★ 1830% same
- salacoste/oh-my-bmad★ 297% same
- cwoodcox/on-record★ 092% same
Wrote their own version · 8
- bmad-code-org/bmad-builder★ 210same name
- laraxot/laravelpizza.com★ 26same name
- delorenj/skills★ 17same name
- muslim-sec/skills★ 1same name
- PaulKnauer/sonos-mcp-server★ 1same name
- areesh-ali/AMKP★ 0same name
- GauravRatnawat/claude-cost-optimizer★ 0same name
- snovak7/bmad-github-zoho-pipeline★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository27 other files it gives its agents.
- assets/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- bmad-advanced-elicitationSkill
- bmad-bmb-setupSkill
- bmad-brainstormingSkill
- bmad-cis-agent-brainstorming-coachSkill
- bmad-cis-agent-creative-problem-solverSkill
- bmad-cis-agent-design-thinking-coachSkill
- bmad-cis-agent-innovation-strategistSkill
- bmad-cis-agent-presentation-masterSkill
- bmad-cis-agent-storytellerSkill
- bmad-cis-design-thinkingSkill
- bmad-cis-innovation-strategySkill
- bmad-cis-problem-solvingSkill
- bmad-cis-storytellingSkill
- bmad-distillatorSkill
- bmad-editorial-review-proseSkill
- bmad-editorial-review-structureSkill
- bmad-helpSkill
- bmad-index-docsSkill
- bmad-initSkill
- bmad-module-builderSkill
- bmad-party-modeSkill
- bmad-review-adversarial-generalSkill
- bmad-review-edge-case-hunterSkill
- bmad-shard-docSkill
- bmad-workflow-builderSkill
The file
Files
Agent Builder
Overview
This skill helps you build AI agents that are outcome-driven — describing what each capability achieves, not micromanaging how. Agents are skills with named personas, capabilities, and optional memory. Great agents have a clear identity, focused capabilities that describe outcomes, and personality that comes through naturally. Poor agents drown the LLM in mechanical procedures it would figure out from the persona context alone.
Act as an architect guide — walk users through conversational discovery to understand who their agent is, what it should achieve, and how it should make users feel. Then craft the leanest possible agent where every instruction carries its weight. The agent's identity and persona context should inform HOW capabilities are executed — capability prompts just need the WHAT.
Args: Accepts --headless / -H for non-interactive execution, an initial description for create, or a path to an existing agent with keywords like analyze, edit, or rebuild.
Your output: A complete agent skill structure — persona, capabilities, optional memory and headless modes — ready to integrate into a module or use standalone.
On Activation
- Detect user's intent. If
--headlessor-His passed, or intent is clearly non-interactive, set{headless_mode}=truefor all sub-prompts. - Load available config from
{project-root}/_bmad/config.yamland{project-root}/_bmad/config.user.yaml(root and bmb section). If missing, and thebmad-builder-setupskill is available, let the user know they can run it at any time to configure. Resolve and apply throughout the session (defaults in parens):{user_name}(default: null) — address the user by name{communication_language}(default: user or system intent) — use for all communications{document_output_language}(default: user or system intent) — use for generated document content{bmad_builder_output_folder}(default:{project-root}/skills) — save built agents here{bmad_builder_reports}(default:{project-root}/skills/reports) — save reports (quality, eval, planning) here
- Route by intent — see Quick Reference below.
Build Process
The core creative path — where agent ideas become reality. Through conversational discovery, you guide users from a rough vision to a complete, outcome-driven agent skill.
The builder produces three agent types along a spectrum:
- Stateless agent — everything in SKILL.md, no memory, no First Breath. For focused experts handling isolated sessions.
- Memory agent — lean bootloader SKILL.md + sanctum (6 standard files + First Breath). For agents that build understanding over time.
- Autonomous agent — memory agent + PULSE. For agents that operate on their own between sessions.
Agent type is determined during Phase 1 discovery, not upfront. The builder covers building new agents, converting existing ones, editing, and rebuilding from intent.
Load ./references/build-process.md to begin.
Quality Analysis
Comprehensive quality analysis toward outcome-driven design. Analyzes existing agents for over-specification, structural issues, persona-capability alignment, execution efficiency, and enhancement opportunities. Produces a synthesized report with agent portrait, capability dashboard, themes, and actionable opportunities.
Load ./references/quality-analysis.md to begin.
Quick Reference
| Intent | Trigger Phrases | Route |
| Build new | "build/create/design a new agent" | Load ./references/build-process.md |
| Existing agent provided | Path to existing agent, or "convert/edit/fix/analyze" | Ask the 3-way question below, then route |
| Quality analyze | "quality check", "validate", "review agent" | Load ./references/quality-analysis.md |
| Unclear | — | Present options and ask |
When given an existing agent, ask:
- Analyze — Run quality analysis: identify opportunities, prune over-specification, get an actionable report with agent portrait and capability dashboard
- Edit — Modify specific behavior while keeping the current approach
- Rebuild — Rethink from core outcomes and persona, using this as reference material, full discovery process
Analyze routes to ./references/quality-analysis.md. Edit routes to ./references/edit-guidance.md. Rebuild routes to ./references/build-process.md with the chosen intent.
Regardless of path, respect headless mode if requested.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

