# Agent Zero Plugins

Builds, reviews and publishes Agent Zero plugins, local or community.

- 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-plugin -g -a claude-code -y`
Codex: `npx skills add agent0ai/agent-zero --skill a0-create-plugin -g -a codex -y`
Cursor: `npx skills add agent0ai/agent-zero --skill a0-create-plugin -g -a cursor -y`
Gemini CLI: `npx skills add agent0ai/agent-zero --skill a0-create-plugin -g -a gemini-cli -y`

## Description

Build, improve, review or publish Agent Zero plugins; local or community, with focused references.

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

# Agent Zero Plugin Development

Use this entrypoint to build or improve a plugin, review it, or prepare community contribution. For finding useful existing plugins and installing/updating them, use `a0-manage-plugin`.

## Establish The Target

Honor an explicit local-only or community-contribution request. For a new plugin, if the user has not said which, ask once: "Should this stay local, or be prepared for community contribution?" Do not ask again when the answer is already in the conversation. For an existing plugin, inspect its location/repository and requested outcome; clarify only an unresolved distribution choice.

- Local: work in `/a0/usr/plugins/<name>/`. No public repository or Index submission needed.
- Community: develop and test locally, then prepare a standalone repository and a separate Plugin Index submission using `references/contribute.md`.
- Existing bundled plugin work: edit its tracked owner only when that is the requested task. New custom plugins do not belong in `/a0/plugins/`.

## Required Lifecycle Contract

**Plugin setup, dependency installation, required initialization, and uninstall cleanup MUST use lifecycle functions in the plugin-root `hooks.py`. Never put these operations in `execute.py`, and never require an Execute button or manual post-install command to make a plugin usable.**

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