agentplugins/agent-plugins-spec

What it solves

This project provides a vendor-neutral standard for packaging AI agent components, ensuring that skills and MCP servers can be shared and distributed as portable plugins across different agent platforms. It removes the need to create separate integrations for every single agent framework.

How it works

It defines a portable package format and a contract that clients can use to discover and load plugins. A basic plugin consists of a directory containing a plugin.json configuration file and a skills directory where individual skills are defined in Markdown files (e.g., SKILL.md) with metadata in the frontmatter.

Who it’s for

Developers building AI agent frameworks (clients) and developers creating reusable agent capabilities (plugin authors) who want a standardized way to distribute their tools.

Highlights

• Vendor-neutral standard for agent extensions.
• Supports both Agent Skills and MCP servers.
• Uses a simple, portable directory structure and JSON schemas for validation.
• Versioned specifications (1.0.0 and 1.1.0 draft) to ensure stability and stability across versions.