Agent Plugins is an open, vendor-neutral specification 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.
Agent Plugins Specification 1.0.0 is a working draft and has not been published.
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.