Agent Plugins

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.

Status

Agent Plugins Specification 1.0.0 is the current published release.

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
• Plugin manifest schema
• MCP configuration schema
• Technical Charter
• Future considerations