Agent Zero AI framework
name: a0-development description: "Develop or operate Agent Zero: projects, chats, tasks, framework, tools and API/WebUI." version: 1.1.0 author: Agent Zero Team tags: ["development", "framework", "agent-zero", "extending", "tools", "extensions", "skills", "api", "agents", "prompts", "dox"] 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" - "dox" - "manage Agent Zero projects" - "create Agent Zero chat" - "Agent Zero API" - "create project" - "activate project" - "project instructions" - "create chat" - "new chat"
Agent Zero Development
Use this skill to develop Agent Zero or operate an existing instance on the user's behalf. For projects, chats, tasks, and other application features, read references/operate-agent-zero.md and use existing APIs. Load only the references needed for the task; verify current source before changing code.
Reality Rules
- Source and nearest DOX beat memory, examples, and this skill if they disagree.
- Before editing, read the applicable
AGENTS.mdchain from the repo root to every file you expect to touch. - New capabilities should usually be plugins. For plugin-specific work, load
a0-create-pluginfor authoring/review/contribution ora0-manage-pluginfor discovery and lifecycle operations. - Do not assume ports. Discover WebUI host/port from startup output, launcher or Docker mapping, or explicit
--host,--port,WEB_UI_HOST, andWEB_UI_PORTconfiguration. - In Docker, framework checks belong to
/opt/venv-a0and agent/user code execution belongs to/opt/venv. Do not use one runtime as proof for the other. - Treat
/a0/as the runtime framework root inside Docker. In local development it means the repository root. If a live container matters, prove that/a0matches the checkout before trusting source-only conclusions. - Do not document or change ignored
usr/ortmp/runtime state unless the user explicitly asks.
Reference Map
Load references with:
{"tool_name": "skills_tool:read_file", "tool_args": {"skill_name": "a0-development", "file_path": "references/<file>.md"}}
| Need | Read |
|---|---|
| Operate Agent Zero for the user: projects, chats, tasks, profiles, skills and settings | references/operate-agent-zero.md |
| Runtime split, root layout, discovery order, path and port boundaries | references/architecture-runtime.md |
| DOX edit workflow, when to update docs, file-level DOX checks | references/dox-workflow.md |
| Tool contracts, locations, prompts, and verification | references/tools.md |
| Python/WebUI extension discovery, hook points, ordering, implicit hooks | references/extensions.md |
| HTTP API, WebSocket handlers, WebUI extension surfaces | references/api-webui.md |
| Agent profiles, prompts, skills, projects | references/agents-prompts-skills-projects.md |
| Plugin-first workflow, where to put new work, handoffs to plugin skills | references/plugins-workflow.md |
Working Flow
- Distinguish operating existing features from developing new behavior. For application operations, follow
references/operate-agent-zero.md; the remaining steps apply to source changes. - Read the root
AGENTS.md, then the nearest childAGENTS.mdfiles for the target paths. - Read the focused reference file from this skill.
- Inspect the current source files named by the reference before making a claim or patch.
- Keep changes narrow and in the repo-owned surface. Prefer
usr/for user-created runtime content, but do not document ignored user state unless requested. - Update DOX when a durable contract, path, behavior, workflow, responsibility, or verification rule changes.
- Run targeted checks from the relevant DOX file. For skill-only changes, at minimum verify frontmatter parsing, reference paths, and markdown sanity.
Handoffs
- Plugin creation: load
a0-create-plugin. - Plugin management or installation: load
a0-manage-plugin. - Plugin review, debugging or publishing: load
a0-create-pluginand read its relevant reference. - Agent profile creation: load
a0-create-agent. - Skill creation or skill format work: load
build-skill.
Closeout
Report the exact files changed, the grounding checks used, whether DOX was updated or intentionally left unchanged, and what verification ran. If a claim depends on a live Docker runtime, include the runtime proof, not only checkout evidence.