skills.rest
agent0ai
agent0aiOFFICIAL
Explore all skills by this author →
Website𝕏@Agent0aiGitHub

a0-create-agent

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

19.1k|3.8k|Updated Jun 10, 2024
Search Tags:#Scaffolding#agent profile#CREATE#agent zero#subordinate#agent.yaml#prompt override
One-click install
npx skills add https://github.com/agent0ai/agent-zero --skill a0-create-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: a0-create-agent
Source: https://github.com/agent0ai/agent-zero/tree/main/skills/a0-create-agent
Command: npx skills add https://github.com/agent0ai/agent-zero --skill a0-create-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating a new Agent Zero subordinate agent profile requires knowing where profiles live, the exact agent.yaml schema, and how prompt inheritance works. This Skill guides the full workflow so profiles are valid, discoverable, and correctly scoped on the first attempt.

Core Features & Use Cases

  • Progressive intake and blueprint generation: Interviews the user one question at a time, then produces a confirmed AgentProfileBlueprint JSON as the single source of truth before writing any files.
  • Correct profile scaffolding: Creates agent.yaml with exactly title, description, and context, plus optional prompt overrides, profile-specific tools, and lifecycle extensions in user, plugin, or project scope.
  • Prompt inheritance guidance: Explains the agent.system.main.specifics.md override slot and when to override communication, solving, or environment prompts without copying unchanged files.
  • Use Case: Ask for a data-analyst subordinate agent and receive a confirmed blueprint, a valid /a0/usr/agents/data-analyst/ directory, and verification steps to delegate to it via call_subordinate.

Quick Start

Ask the agent to create a new agent profile for your desired specialty and confirm the blueprint it proposes.

Frequently Asked Questions about a0-create-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new agent profile in Agent Zero?▼

Create a directory under /a0/usr/agents/<name>/ containing an agent.yaml file with title, description, and context fields. Add a prompts/agent.system.main.specifics.md file to define the profile's role and behavior, then delegate to it via call_subordinate using the directory name.

What fields does agent.yaml support in Agent Zero?▼

agent.yaml supports exactly three fields: title, description, and context. Model settings, temperature, and allowed_tools are not valid there; model preset selection lives in a companion _model_config/config.json file instead.

Where should user agent profiles be stored in Agent Zero?▼

User profiles belong in /a0/usr/agents/<profile_name>/, not in /a0/agents/, which is reserved for core framework profiles like default, developer, and researcher. Plugin-distributed and project-scoped profiles have their own designated paths.

Can an agent profile use a different model preset?▼

Yes, by creating a plugins/_model_config/config.json file inside the profile directory containing only a model_preset key naming an existing global preset. API keys and preset definitions are managed centrally and must never be stored in the profile.

Why is my new agent profile not showing up in Agent Zero?▼

Check that the directory name uses only lowercase letters, numbers, hyphens, or underscores and is unique across search paths. Also verify agent.yaml parses as valid YAML and that a fresh agent or subordinate spawn has occurred, since profiles load at initialization.

Related Skills

Explore More Software Engineering Skills→
ayo-oooayo-ooo

agent-discovery

List available ayo agents with descriptions, models, tools, and skills.

Official
Intermediate
laraxotlaraxot
26

bmad-advanced-elicitation

Prompt a language model to reconsider, refine, and improve its recent responses.

Official
Advanced
sidunrealdesidunrealde

settings

Configure GSD workflow agents with model profiles and workflow toggles.

Community
Intermediate
open-octoopen-octo
88

skill-creator

Create and refine reusable skill instructions with valid SKILL.md frontmatter.

Official
Advanced