a0-development
Development guide for extending and building features for the Agent Zero AI framework. Covers architecture, tools, extensions, API endpoints, agent profiles, projects, prompts, and skills — with correct paths, imports, and patterns matching the current codebase.
Best for Agent Zero framework develo…Works with GitHub
⌘source
- author
@agent0ai- language
- Python
★17kstars
3.6kforks
May 2, 2026
✦overview.md
Key Features
- ·Architecture and project layout
- ·Create new Tools
- ·Add Extensions with hooks
- ·Build API endpoints
- ·Create Agent Profiles
- ·Understand prompt system
Use Cases
- →Extending Agent Zero with custom tools
- →Adding extensions to hook into framework lifecycle
- →Building API endpoints for Web UI
- →Creating custom agent profiles with tailored prompts
- →Developing new skills for Agent Zero
Best for
- ✓Agent Zero framework developers
- ✓extension builders
- ✓tool creators
Not ideal for
- !beginners unfamiliar with Agent Zero
FAQs
name
a0-development
description
Development guide for extending and building features for the Agent Zero AI framework. Covers architecture, tools, extensions, API endpoints, agent profiles, projects, prompts, and skills — with correct paths, imports, and patterns matching the current codebase.
version:1.0.0
author:Agent Zero Team
tags:["development","framework","agent-zero","extending","tools","extensions","skills","api","agents","prompts"]
trigger_patterns:["extend agent zero","agent zero development","build agent zero feature","create agent zero tool","add extension","framework development","agent zero architecture","how does agent zero work","create agent zero extension","add api endpoint","create agent profile","agent zero internals","how does the agent loop work","extension hook points","prompt system","agent profile"]
Agent Zero Development Guide
This skill provides comprehensive, accurate guidance for extending and building features for Agent Zero. Use it when you need to:
- Understand the architecture and project layout
- Create new Tools for agent capabilities
- Add Extensions to hook into the framework lifecycle
- Build API Endpoints for the Web UI
- Create Agent Profiles (subordinates) with custom prompts
- Understand and extend the Prompt System
- Create Skills (see the dedicated
create-skillskill for the full wizard) - Work with Projects and workspace configuration
Path convention: Throughout this guide,
/a0/refers to the framework root — this is/a0/inside Docker, or your local repository root in development. All paths are relative to this root.
[!IMPORTANT] Plugins are the primary way to extend Agent Zero. Most new tools, extensions, and prompts should be packaged as plugins. For all plugin tasks (create, review, manage, debug, contribute), load the
a0-plugin-routerskill which routes to the appropriate specialist. This guide covers the underlying framework patterns that plugins build upon.
$install
1-click copynpx skills add agent0ai/agent-zero --skill a0-developmentSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.