bmad-agent-builder

Builds, edits, and analyzes persona-driven agent skills through conversational discovery.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-agent-builder-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-builder
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-agent-builder
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-agent-builder-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Designing a well-structured AI agent skill requires balancing persona design, capability prompts, memory architecture, and quality standards, which is difficult to do consistently by hand. This Skill guides the creation, editing, and quality analysis of agent skills so each one ships lean, outcome-driven, and coherent. ## Core Features & Use Cases - Three agent archetypes: Produces stateless agents (single SKILL.md), memory agents (lean bootloader plus a persistent sanctum), and autonomous agents (memory plus scheduled PULSE wake behavior), with the type emerging from discovery questions rather than an upfront menu. - Create, Edit, and Analyze intents: Routes to a build loop for new agents, surgical edit guidance that preserves existing design, or a quality-analysis report based on shared prompt-quality standards. - Template-driven emission: Generates SKILL.md, customize.toml, sanctum templates (PERSONA, CREED, BOND, MEMORY, CAPABILITIES, PULSE), First Breath scripts, and wake/init scripts from a consistent asset library. - Use Case: Ask to create a personal writing coach agent; the builder discovers it needs memory, drafts the persona and capabilities, emits the bootloader SKILL.md plus sanctum templates, and hands off with lint results and a decision memlog. ## Quick Start Ask the assistant to create a new agent that acts as a personal coding coach with memory between sessions, and answer the discovery questions it asks.

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 with a persona?

Invoke the builder with a description of the agent you want, then answer discovery questions about memory needs, teachability, and autonomy. It drafts the persona and capabilities, shows the draft for feedback, and emits the SKILL.md plus supporting files.

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

Stateless agents ship everything in one SKILL.md with no memory between sessions. Memory agents add a persistent sanctum reloaded on each activation, and autonomous agents add PULSE for scheduled self-directed wake behavior.

Can I edit an existing agent without rebuilding it?

Yes, the Edit intent makes targeted changes while preserving the agent's identity and design. It assesses cascade effects across files, keeps persona content in sanctum templates, and runs lint checks after editing.

Does the builder support non-interactive or headless runs?

Yes, passing --headless or -H makes the builder non-interactive, skipping open-floor discovery and emitting a JSON status result. Resume detection via the memlog happens automatically in headless mode.

What are the limitations of the agent quality analysis?

Analysis verifies agents against the prompt-quality canon and archetype bars but does not execute the agent's capabilities end-to-end. Eval runs require the separate bmad-eval-runner skill and remain opt-in unless configured as required.