bmad-agent-builder

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

Updated May 7, 2026
One-click install
npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-agent-builder-jgabriellima
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-agent-builder
Source: https://github.com/jgabriellima/deep-agent-skill/tree/main/skills/bmad-agent-builder
Command: npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-agent-builder-jgabriellima

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 a structured conversational process to create outcome-driven agents with clear personas, focused capabilities, and optional persistent memory. ## Core Features & Use Cases - Agent Building: A six-phase discovery process (intent, capabilities strategy, requirements, drafting, building, summary) that produces stateless, memory, or autonomous agent types with sanctum templates, First Breath onboarding, and optional PULSE autonomous behavior. - Quality Analysis: Analyzes existing agents for over-specification, persona-capability misalignment, and structural issues, producing an interactive HTML report with grades, opportunity themes, and fix prompts. - Guided Editing: Surgically edits existing agents while preserving identity coherence, with cascade assessment across SKILL.md, sanctum templates, and capability references. - Use Case: Ask the builder to create a personal coding coach agent; it determines the agent needs memory, gathers identity and CREED seeds, generates the sanctum templates and init script, and outputs a complete agent skill ready to install. ## Quick Start Ask the agent builder to create a new agent, for example: build an agent that acts as a creative writing coach with memory between sessions.

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?▼

Invoke the agent builder with a request like "create an agent" and describe your vision. It walks you through six conversational phases covering intent, capabilities, requirements, drafting, building, and summary, then outputs a complete agent skill directory.

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 skill?▼

Provide the path to an existing agent and choose the analyze option. The builder runs quality analysis covering structure, persona, cohesion, efficiency, and experience, then generates an interactive HTML report with grades, opportunity themes, and fix prompts.

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

Yes. Choose the edit route when given an existing agent. The builder assesses which files the change cascades across, preserves the agent's voice and structure, and validates coherence with lint scripts after editing.

What files does a memory agent need to work?▼

A memory agent uses a lean bootloader SKILL.md plus a sanctum containing INDEX, PERSONA, CREED, BOND, MEMORY, and CAPABILITIES files. An init-sanctum.py script creates this structure, and First Breath onboarding populates it during the first conversation.