Skip to content
cccskills
FreePublished on GitHub

a0-create-plugin

Build, improve, review, or troubleshoot Agent Zero plugins for local use or community distribution. Follow plugin structure and installation rules, verify behavior in the target runtime, and prepare repository and Plugin Index contributions when requested.

OriginalShow the original description

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

See how to install

Good for

  • Building an Agent Zero plugin for local use
  • Reviewing an existing plugin's structure and behavior
  • Investigating plugins that fail to load or run
  • Preparing a plugin for community distribution

Files included (8)

  • SKILL.md5.4 KB
  • AGENTS.md1.7 KB
  • references/AGENTS.md1.3 KB
  • references/channel-commands.md13.2 KB
  • references/contribute.md4.9 KB
  • references/implementation.md11.1 KB
  • references/review.md5.0 KB
  • references/webui.md9.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

  • install() prepares dependencies and initializes the plugin automatically after installation and again after updates. Make it safe to rerun.
  • pre_update() stops plugin-owned processes or prepares state before an update when needed.
  • uninstall() stops plugin-owned processes, removes registrations, and removes plugin-owned dependencies/resources before the framework deletes the plugin directory. Preserve shared dependencies and unrelated user data.
  • Keep lifecycle ownership in hooks.py; it may delegate to plugin-local helpers. If boot-time initialization is needed, a startup extension may call the same helper or hook; it does not replace install/uninstall hooks.
  • Omit execute.py unless there is a separate, explicitly requested manual operation unrelated to setup, dependency installation, required initialization, updates, or removal.

Read Only What The Task Needs

After loading this skill, use skills_tool with action: "read_file", skill_name: "a0-create-plugin", and the reference path:

WorkReference
Manifest, layout, backend, tools, settings, hooks, runtime verificationreferences/implementation.md
Channel integrations: shared slash commands, effects, menus, authorizationreferences/channel-commands.md
Alpine stores, settings UI, x-overflow controls, notifications, custom message/process-step handlersreferences/webui.md
Review existing code or verify a completed changereferences/review.md
Standalone repository, license, Index entry, validation and PRreferences/contribute.md

Working Flow

  1. Inspect the existing plugin and relevant source. Read /a0/AGENTS.md, /a0/plugins/AGENTS.md, and the closest applicable contracts.
  2. Load the implementation reference, plus the UI reference if needed. Build only the requested capability; reuse existing helpers and patterns.
  3. Keep plugin.yaml at the plugin root. Use stable underscore names for new custom plugins. Keep credentials and runtime state out of published source.
  4. Verify the real target runtime, not just the checkout. Use the framework Python for backend/plugin checks. Read references/review.md before declaring the work complete; report actual checks and remaining limitations.
  5. For local work, deliver the working plugin and usage instructions. For community work, continue through the contribution reference within the user's publication authorization. Preparing a plugin is not the same as publishing it or merging its Index PR.

Brief Troubleshooting

Follow the first failing boundary: root plugin.yaml and correct directory; global/project/profile toggle and effective config; imports in the framework runtime; API auth/CSRF and route; extension path/breakpoint; store import and gate. Inspect the relevant server/browser error before editing. Use management APIs for lifecycle refreshes; do not manually rerun install/uninstall hooks as a diagnostic or delete state to hide the failure.

Finish

Report the feature, usage, live verification, and any unresolved limits. For community work, distinguish repository publication, PR creation, CI results, and actual merge. Follow an existing request to commit or publish; otherwise keep changes ready for review.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a0-create-agent

FreeSummary

Create specialized Agent Zero profiles by defining their roles, working methods, and delegation criteria. The skill prepares configuration files and instructions, with optional custom tools, extensions, and model preset selection when needed.

  • Create a specialist agent for data analysis
  • Define when to delegate work to an agent
  • Customize an agent's workflow and response format
agent0ai/agent-zero19.5KUpdated Oct 15, 2026

a0-development

FreeSummary

Operate Agent Zero projects, chats, and tasks, or develop new tools, extensions, and API features. The skill guides work through existing APIs, relevant documentation, current source code, and checks appropriate to the change.

  • Manage Agent Zero projects and chats
  • Develop custom tools and extensions
  • Add API endpoints or WebUI features
agent0ai/agent-zero19.5KUpdated Oct 15, 2026

a0-manage-plugin

FreeSummary

Find Agent Zero plugins that match a task, compare candidates and their requirements, and manage installation, updates, settings, activation, and removal. It also supports security scans and checks the resulting plugin state through framework management APIs.

  • Find and compare plugins for a specific task
  • Review service, credential, and cost requirements before installation
  • Scan, install, or update a plugin
agent0ai/agent-zero19.5KUpdated Oct 15, 2026

Automate web page tasks such as clicking, filling forms, uploading and downloading files, and taking screenshots. Work across tabs using a browser on the connected host machine or inside a Docker container.

  • Filling web forms and selecting options
  • Uploading or downloading files through websites
  • Capturing screenshots to inspect page appearance
agent0ai/agent-zero19.5KUpdated Oct 15, 2026

Create, edit, and install extensions for Agent Zero Browser, including extensions from Chrome Web Store. It guides permission reviews and checks for suspicious behavior, with new extensions built as readable files that users can inspect.

  • Create a browser extension for a specific website
  • Modify an existing extension
  • Install an extension from Chrome Web Store
agent0ai/agent-zero19.5KUpdated Oct 15, 2026

Fill and submit web forms with dropdowns, checkboxes, radio buttons, file uploads, and directly editable fields. Check unclear fields before acting, inspect visual states when needed, and verify the result after submission.

  • Filling forms with dropdowns and checkboxes
  • Uploading files through web forms
  • Entering text in directly editable page fields
agent0ai/agent-zero19.5KUpdated Oct 15, 2026

See all skills by agent0ai

Report a problem with this skill