Agent Plugins Spec

Agent Plugins

Agent Plugins is an open, vendor-neutral standard for packaging reusable components that extend AI agents into distributable plugins. It defines a portable package format for Agent Skills and MCP servers.

This README is a non-normative introduction. The versioned specification defines the portable contract.

Status

Agent Plugins Specification 1.0.0 is the current published release. Agent Plugins Specification 1.1.0 is a working draft.

Quick Start

The smallest useful plugin is a directory with one skill:

hello-plugin/
├── plugin.json
└── skills/
    └── greet/
        └── SKILL.md

In `plugin.json`:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hello-plugin"
}

In `skills/greet/SKILL.md`:

---
name: greet
description: Greet the user and offer help.
---

Greet the user and offer help.

A client that supports skills can load the plugin by reading `plugin.json` and discovering `skills/greet/SKILL.md`. How the client exposes the skill to users or models is outside the Agent Plugins specification.

Project Documents

• Agent Plugins Specification 1.0.0
• 1.0.0 schemas
• Agent Plugins Specification 1.1.0 (working draft)
• 1.1.0 schemas
• Technical Charter
• Future considerations