bmad-agent-builder

Builds, edits, and analyzes AI agent skills through conversational discovery.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/5onyy/essential-ai-agent-skills --skill bmad-agent-builder-5onyy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-agent-builder
Source: https://github.com/5onyy/essential-ai-agent-skills/tree/main/.cursor/skills/bmad-agent-builder
Command: npx skills add https://github.com/5onyy/essential-ai-agent-skills --skill bmad-agent-builder-5onyy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Designing well-structured AI agent skills is hard: agents often end up over-specified with mechanical procedures, lack clear identity, or have no coherent memory architecture. This Skill guides users through conversational discovery to build outcome-driven agents with clear personas, focused capabilities, and optional persistent memory. ## Core Features & Use Cases - Agent Building: Six-phase conversational process covering intent discovery, capability strategy, requirements gathering, drafting, building, and summary, producing stateless, memory, or autonomous agent types. - Quality Analysis: Analyzes existing agents for over-specification, persona-capability misalignment, and structural issues, generating an interactive HTML report with grades, opportunity themes, and fix prompts. - Guided Editing: Targeted edit workflow that assesses cascade impact across SKILL.md, sanctum templates, and capability files while preserving agent identity. - Use Case: Ask the builder to create a personal coding coach agent; it determines the agent needs memory, generates a bootloader SKILL.md plus sanctum templates (PERSONA, CREED, BOND, MEMORY, CAPABILITIES), an init script, and a First Breath onboarding conversation. ## Quick Start Ask the agent builder to create a new agent by describing who the agent is and what it should accomplish, for example: build an agent that acts as a creative writing coach with persistent memory.

Frequently Asked Questions about bmad-agent-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom AI agent skill?▼

Describe who the agent is, what it should achieve, and how it should make users feel. The builder walks through conversational discovery phases, determines the agent type, and generates the complete skill structure including SKILL.md, references, and templates.

What is the difference between stateless, memory, and autonomous agents?▼

Stateless agents keep everything in SKILL.md with no persistence. Memory agents add a sanctum folder with persona, creed, bond, and memory files that persist across sessions. Autonomous agents add PULSE for self-directed background operation between sessions.

How do I analyze the quality of an existing agent?▼

Provide the path to an existing agent and request a quality analysis. The skill scans for over-specification, persona-capability misalignment, and structural issues, then produces a synthesized report with an agent portrait, capability dashboard, and an interactive HTML version.

Can I edit an agent without rebuilding it from scratch?▼

Yes. The edit workflow makes targeted changes while preserving the agent's identity and design. It assesses cascade impact across files first, then applies edits matched to the agent type, and runs lint validation afterward.

Does the agent builder support headless or non-interactive execution?▼

Yes. Pass --headless or -H to run non-interactively. Built agents can also support headless activation modes with named task routing, which suits cron-scheduled background operation for autonomous agents.

When should an agent use scripts instead of prompts?▼

Use scripts for deterministic operations like calculations, file processing, or data transformation where judgment is not needed. The builder actively probes for script opportunities during the capabilities phase and requires approval for any external dependencies.