bmad-agent-builder

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

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-agent-builder-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-agent-builder
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-agent-builder
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-agent-builder-hordricjr

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 BMad agents through structured conversational discovery. ## 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 PULSE scheduled wake behavior), with the type emerging from discovery questions rather than upfront selection. - 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 the prompt-quality canon. - Deterministic scaffolding: Emits agents from templates (SKILL.md, customize.toml, sanctum files, wake.py, init-sanctum.py) via a template-processing script, with lint gates and optional eval runs before handoff. - Use Case: Ask to create a personal writing coach agent; the builder discovers it needs memory, drafts the persona and capabilities, scaffolds the sanctum templates, and hands off an agent that wakes with continuity across sessions. ## Quick Start Ask the assistant to create a new agent that acts as a personal coding 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 with persistent memory?

Invoke the builder with a description of your agent and answer discovery questions about whether it needs to remember between sessions. A memory agent ships a lean bootloader SKILL.md plus a sanctum of six files (PERSONA, CREED, BOND, MEMORY, CAPABILITIES, INDEX) that it reloads on every activation.

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

Stateless agents ship their whole identity in one SKILL.md for isolated sessions. Memory agents add a persistent sanctum reloaded on each wake. Autonomous agents are memory agents plus PULSE.md, letting them wake on a schedule and do work unattended.

How do I edit an existing agent without breaking its design?

Route to the Edit intent, which loads edit-guidance.md. It reads the agent's full structure first, assesses whether the change is local or cascading across files, and validates coherence afterward with lint checks on paths and scripts.

Can the agent builder run non-interactively in a script?

Yes, pass --headless or -H to make the builder non-interactive. In headless mode it resumes from the memlog automatically and emits a JSON status object with the agent path, type, and memlog location instead of conversational output.

Why does a memory agent have such a short SKILL.md file?

The bootloader is lean by design, around 400 tokens, carrying only the identity seed, the Three Laws, the Sacred Truth, and activation routing. All persona detail, principles, and capability menus live in the sanctum, so a thin bootloader indicates correct design rather than missing content.