Skip to content

Install agents, skills and tools as plugins.

A plugin is a versioned package you install in oz0. It can provide agents, skills, tools or checks, or group other plugins. Use an existing plugin or build your own.

One package. Instructions and actions.

Take the GitHub plugin. It includes an agent that understands GitHub work and a tool that can read files, inspect pull requests and post comments.

github/One plugin, installed as a package
oz0-plugin.yaml
The packing list

Lists what is in the plugin and what access it needs. This file is called the manifest.

agents/
The agent: instructions for the task

Defines its instructions, model and permitted tools. The agent chooses what to do next as it works.

oz0_github/Read a file
Read a pull request
Post a comment
The tool: code that performs actions

Each operation it offers is a tool action, called a function in the docs. A tool call requests one action with specific arguments. Your rules decide whether that call may run.

Simplified folder view of the GitHub plugin. Actions are shown by what they do, not as filenames. Other plugins can contain different parts.

How those parts work together

  1. 01 · YOU ASK

    “Summarize this pull request.”

  2. 02 · THE AGENT WORKS

    It uses the tool to read the changes.

  3. 03 · YOU GET THE RESULT

    The agent explains what changed.

If you ask it to post a comment, the GitHub plugin asks for approval by default. An authorized person reviews the tool call in oz0 Console → Approvals.

Go deeper:plugin files and structure

Different plugins have different jobs.

These four labels describe a plugin’s purpose. They are not four parts you need to put inside every plugin.

Connect to a systemConnector plugin · GitHub
Connects to one outside system or agent runtime and provides the tool actions agents can use there.
Complete a taskCapability plugin · Merge when green
Packages a task. For example, check a pull request and request approval to merge it, using the GitHub plugin’s tool actions.
Apply shared checksPolicy plugin · Guardrails
Adds checks around agent work, such as looking for secrets in results. These checks have documented limits.
Install plugins togetherPlugin set · Essentials
Groups existing plugins into one install. It does not add agents or tools of its own.

You can use the same GitHub plugin for several tasks. Each task reuses its actions instead of needing another GitHub connection.

Agent, tool, job: the words we use

Go deeper:plugin kinds and their rules