# Agent Zero Profiles

Creates Agent Zero profiles with agent config, prompt overrides, tools, and extensions.

- Repository: https://github.com/agent0ai/agent-zero (19630 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agent0ai/agent-zero --skill a0-create-agent -g -a claude-code -y`
Codex: `npx skills add agent0ai/agent-zero --skill a0-create-agent -g -a codex -y`
Cursor: `npx skills add agent0ai/agent-zero --skill a0-create-agent -g -a cursor -y`
Gemini CLI: `npx skills add agent0ai/agent-zero --skill a0-create-agent -g -a gemini-cli -y`

## Description

Create Agent Zero profiles with agent.yaml, prompt overrides, tools and extensions.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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/plugins/AGENTS.md`, plugin-distributed profiles + per-profile config

---

## Existing Profile Pattern

The built-in profiles are intentionally split into two layers:

1. `agent.yaml` is tiny metadata for discovery and delegation:
   - `title`
   - `description`
   - `context`
2. 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 |
| `developer` | Rich capabilities, methodology, output requirements |
| `researcher` | Rich capabilities, methodology, evidence standards |
| `hacker` | Short, direct operational identity plus optional environment override |
| `_example` | Minimal demo of prompt/tool/extension override surfaces |

For most new profiles, create `agent.yaml` plus one strong `agent.system.main.specifics.md`. Add other prompt overrides, tools, or extensions only when the blueprint explicitly needs them.

---

## Step 0: Progressive Intake

Do not ask the user a long form. New users are easily overwhelmed. Guide them with lossy compression: ask only the next highest-value question, one or two questions per turn maximum.

Default assumptions unless the user says otherwise:

The rest: https://github.com/agent0ai/agent-zero/blob/HEAD/skills/a0-create-agent/SKILL.md