a0-create-agent
Create a new Agent Zero agent profile (subordinate). Covers where profiles live (user / plugin-distributed / project-scoped), the agent.yaml schema, the prompt inheritance & override model, and optional profile-specific tools and extensions. Use for any "create/add/new agent profile" request.
Best for Agent Zero usersWorks with GitHub
⌘source
- author
@agent0ai- language
- Python
★17kstars
3.5kforks
Apr 29, 2026
✦overview.md
Key Features
- ·Create subordinate agent profiles in Agent Zero
- ·User profiles in /a0/usr/agents/<profilename>/
- ·Supports plugin-distributed and project-scoped profiles
- ·Covers agent.yaml schema and prompt inheritance
- ·Optional profile-specific tools and extensions
Use Cases
- →Setting up a new specialized agent for a project
- →Adding a custom subordinate agent to an existing Agent Zero installation
- →Distributing a reusable agent profile via a plugin
Best for
- ✓Agent Zero users
- ✓Plugin developers
- ✓Multi-agent workflows
Not ideal for
- !Users on non-Agent Zero platforms
FAQs
name
a0-create-agent
description
Create a new Agent Zero agent profile (subordinate). Covers where profiles live (user / plugin-distributed / project-scoped), the agent.yaml schema, the prompt inheritance & override model, and optional profile-specific tools and extensions. Use for any "create/add/new agent profile" request.
version:1.0.0
tags:["agents","profile","create","new","subordinate"]
trigger_patterns:["create agent","new agent profile","add agent profile","make agent profile","agent profile template","build agent profile"]
Create an Agent Zero Agent Profile
[!IMPORTANT] Do not create new profiles in
/a0/agents/— that directory is reserved for core framework profiles (default,agent0,developer,hacker,researcher,_example). User profiles belong in/a0/usr/agents/<profile_name>/.
Related skills: /a0/skills/a0-development/SKILL.md (broader framework guide) | /a0/skills/a0-create-plugin/SKILL.md (bundle a profile inside a plugin).
Primary references:
/a0/agents/_example/— the canonical reference profile (tool + extension + prompt overrides)/a0/agents/default/— the base profile every other profile inherits from/a0/docs/agents/AGENTS.plugins.md— plugin-distributed profiles + per-profile config
Existing Profile Pattern
The built-in profiles are intentionally split into two layers:
agent.yamlis tiny metadata for discovery and delegation:titledescriptioncontext
- The actual profile behavior usually lives in
prompts/agent.system.main.specifics.md.
Use the shipped profiles as calibration:
| Profile | Pattern to copy |
|---|---|
agent0 | Minimal top-level assistant identity |
$install
1-click copynpx skills add agent0ai/agent-zero --skill a0-create-agentSafety 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.