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: ```text hello-plugin/ ├── plugin.json └── skills/ └── greet/ └── SKILL.md ``` In `plugin.json`: ```json { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "hello-plugin" } ``` In `skills/greet/SKILL.md`: ```markdown --- 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](./spec/1.0.0.md) - [1.0.0 schemas](./schemas/1.0.0/) - [Agent Plugins Specification 1.1.0 (working draft)](./spec/1.1.0.md) - [1.1.0 schemas](./schemas/1.1.0/) - [Technical Charter](./GOVERNANCE.md) - [Future considerations](./FUTURE_CONSIDERATIONS.md)