a0-create-plugin

Scaffold Agent Zero plugins with plugin.yaml manifests and runtime hooks.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/ToXMon/tolu --skill a0-create-plugin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: a0-create-plugin
Source: https://github.com/ToXMon/tolu/tree/main/agent-zero-backup/workdir/agent-zero-backup/workdir/agent-zero-backup/skills/a0-create-plugin
Command: npx skills add https://github.com/ToXMon/tolu --skill a0-create-plugin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a single authoritative workflow and conventions for creating, extending, and publishing Agent Zero plugins so developers avoid inconsistent plugin layouts, broken imports, race conditions in UI components, and failed index submissions.

Core Features & Use Cases

  • Manifest enforcement: Requires a valid plugin.yaml at runtime and guides repo-root manifests for community plugins to ensure discoverability.
  • Frontend & Store patterns: Prescribes store-gating templates and separate store modules to prevent race conditions and maintain consistent notification handling.
  • Backend & lifecycle hooks: Documents hooks.py, execute.py, import rules, and environment targeting for safe install/update/uninstall operations.
  • Use Case: Build a local plugin that adds a settings modal, a backend API handler, and an install hook that installs runtime dependencies while preserving safe execution boundaries.

Quick Start

Create a local plugin named my_plugin under /a0/usr/plugins with a plugin.yaml, webui/config.html for settings, and a hooks.py install hook.

Frequently Asked Questions about a0-create-plugin

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

FAQPage Schema
How do I create an Agent Zero plugin with a valid plugin manifest?

To create an Agent Zero plugin, scaffold it under usr/plugins or a repo-root with a valid plugin.yaml at runtime. The manifest enforces discoverability and must define UI hooks, API handlers, and lifecycle extensions for safe execution.

What's the best way to add a settings UI and backend API handler to an Agent Zero plugin?

The best way to add a settings UI and backend API handler is to use webui/config.html for settings and separate store modules. Store-gating templates prevent race conditions and maintain consistent notification handling in the frontend.

How do lifecycle hooks work in Agent Zero plugin development?

Lifecycle hooks in Agent Zero plugins operate through hooks.py and execute.py with strict import rules and environment targeting. They ensure safe install, update, and uninstall operations while preserving execution boundaries for runtime dependencies.

Why does my community Agent Zero plugin fail index submission?

Community Agent Zero plugin index submission fails when the repo-root manifest schema is invalid or discoverability constraints are not met. Enforcing the plugin.yaml schema and correct repo-root layout ensures successful index submission for community plugins.

Can I use Python to build install hooks that manage runtime dependencies for Agent Zero plugins?

Yes, you can use Python to build install hooks in hooks.py that manage runtime dependencies. The hooks enforce safe execution boundaries and environment targeting for install, update, and uninstall operations within Agent Zero plugins.

What is a plugin manifest and when do I need one for Agent Zero webui extension?

A plugin manifest is a plugin.yaml file required at runtime to define UI hooks, API handlers, and settings UIs. You need one for any Agent Zero webui extension to ensure proper discovery and backend integration.