Introducing Agent Plugins 1.0.0

Today, Agent Plugins 1.0.0 is publicly available. is an open, vendor-neutral standard for plugins that extend AI agents. Agent Plugins

provide reusable instructions and resources for AI agents. connect agents to tools and services. Both can be reused across clients, but clients often package and discover them differently.Agent SkillsMCP servers

Agent Plugins gives compatible clients a common format: a directory with a manifest and fixed locations for its components. The format is intentionally small and easy to implement, and it leaves installation, distribution, policy, user experience, and client-specific capabilities to each client.plugin.json

Extension authors often adapt the same component to several client formats. Even though the underlying Skill or MCP server is identical, clients often expect different top-level metadata, discovery paths, or MCP configuration.

Agent Plugins gives those shared components one predictable, structured home:

A minimal JSON manifest () identifies the specification version and names the plugin:plugin.json

Those two fields are the minimum requirement for the manifest, and the rest of the contract is represented in the file structure of the directory itself. A reusable component should not need to be repackaged for every client, so the format specifies only what a client needs to discover and load what is inside.

Every compatible client checks for at the plugin root. Clients that support Skills discover them under . Clients that support MCP servers read their configuration from . A client can support either component type or both. After the client validates the manifest, components are validated independently, so one invalid component does not disable unrelated ones.plugin.jsonskills/mcp.json

For plugin authors, that means fewer client-specific conventions for the same component. For client implementers, the specification defines a small, deterministic contract for discovery, validation, and loading.

Agent Plugins defines the portable contract for a plugin and leaves the behavior of the client up to each client.

Version 1 focuses that contract on two component types: Agent Skills and MCP servers. Both already have specifications and meaningful adoption of their own, and Agent Plugins does not attempt to redefine them. Agent Plugins provides a shared definition of how clients find the components together in a distributable plugin.

Other components, such as commands, hooks, and agents, remain with clients. The Technical Steering Committee may consider additional component types in future versions as semantics converge and a demonstrated portability need emerges.

Keeping the boundary small makes the format easier to implement and gives the ecosystem room to converge before adding more portable surface area.

Clients need freedom to innovate while a shared format evolves, so Agent Plugins includes a namespaced extension mechanism for client-specific data and files.

Extensions remain outside the portable contract. Each client defines its own namespace, and other clients ignore it. This prevents client-specific behavior from leaking into the common format or blocking adoption of the shared components. A client-specific capability can remain client-specific until there is reason and consensus to standardize it.

Vercel initiated the proposal, which representatives from Amazon Web Services (AWS), Anysphere, GitHub, Microsoft, OpenAI, and Vercel refined collaboratively into Agent Plugins 1.0.0.

The initial Technical Steering Committee includes Core Maintainers from AWS, Cursor, Microsoft, OpenAI, and Vercel.

The project is openly licensed, and its maintainers, contribution process, and technical decisions are public. No single company's product roadmap sets the format's direction.

The specification, its JSON Schemas, and guides for plugin authors and client implementers are available at . Governance and the contribution process live in the on GitHub.agent-plugins.orgAgent Plugins specification repository

If you author agent extensions, you can use the specification to package Skills and MCP servers behind one portable manifest. If you build an agent client, the specification's conformance checklist defines the minimum requirements for discovering and loading Agent Plugins.

At launch, Agent Plugins are supported across:

Plugin authors can package components once, and their plugin will automatically carry between supporting clients.

Agent Plugins is a contract between the authors who build extensions for agents and the clients that load them. That contract is now defined and open for both sides to shape.

Read more

One package for the portable parts

Small on purpose

Clients retain flexibility

An open, multi-vendor project

Build with Agent Plugins 1.0.0

• ChatGPT and Codex

• Cursor

• GitHub Copilot

• Kiro

• VS Code