에이전트 플러그인 사양 v1.0.0에 대 한 복사 가능한 참조 패키지.

이 저장소는 휴대용 코어를 설명하고 클라이언트 별 형식의 기존 플러그인을 마이그레이션하는 데 도움이 에이전트 기술이 포함되어 있습니다. 참고 예제, 규범 사양에 대 한 대용 하지; 그들은 다른 경우, 사양 승리.

배치

가장 작은 유효한 플러그인은 plugin.json만 필요합니다. 이 예제에는 기술이 포함되어 있으므로 구조적으로 환상적입니다.

휴대용 핵심

Agent Plugins v1은 두 가지 휴대용 구성 요소 유형을 정의합니다.

• skills/의 즉각적인 자녀 감독 아래 에이전트 스킬.
• 매칭 v1.0.0 MCP 스키마를 사용하여 선택적인 루트 mcp.json에 있는 MCP 서버.

루트 plugin.json 스키마가 닫힙니다. hooks, agents], commands], mcpServers], lspServers], 또는 상위 레벨의 임의 클라이언트 필드를 추가하지 마십시오. mcp.json]에서 휴대용 MCP 구성 및 extensions 내부의 클라이언트 소유의 표 데이터를 넣어.

플러그인의 표현, 기술, MCP 서버 및 클라이언트 확장에 대한 권한 문서 참조.

클라이언트 별 기능을 안전하게 추가하십시오

걸이와 유사한 기능은 휴대용 v1 성분이 아닙니다.

Agent Plugins Example

A copyable reference package for the Agent Plugins Specification v1.0.0.

This repository demonstrates the portable core and includes an Agent Skill that helps migrate existing plugins from client-specific formats. It is a reference example, not a substitute for the normative specification; if they differ, the specification wins.

Layout

agent-plugins-example/
├── plugin.json                         # Required portable manifest
├── skills/                             # Portable Agent Skills
│   └── migrate-agent-plugin/
│       ├── SKILL.md
│       └── references/
│           ├── client-extensions.md
│           ├── migration-guide.md
│           └── validation-checklist.md
├── README.md
└── LICENSE

The smallest valid plugin needs only plugin.json. This example includes a skill so it is useful as well as structurally illustrative.

The portable core

Agent Plugins v1 defines two portable component types:

• Agent Skills under immediate child directories of skills/.
• MCP servers in an optional root mcp.json using the matching v1.0.0 MCP schema.

The root plugin.json schema is closed. Do not add hooks, agents, commands, mcpServers, lspServers, or arbitrary client fields at its top level. Put portable MCP configuration in mcp.json and client-owned manifest data inside extensions.

See the authoritative documentation for the plugin manifest, skills, MCP servers, and client extensions.

Add client-specific capabilities safely

Hooks and similar capabilities are not portable v1 components. A client can add them through a reverse-domain extension namespace it owns and documents:

your-plugin/
├── plugin.json
├── skills/
├── mcp.json                            # Optional portable MCP configuration
└── com.vendor.client/                  # Optional client extension
    └── hooks/
        └── hooks.json

If a client uses both manifest data and files, plugin.json can contain an extension object:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "your-plugin",
  "extensions": {
    "com.vendor.client": {
      "settingDefinedByThatClient": true
    }
  }
}

com.vendor.client is illustrative. Use only a namespace and fields documented by the client that owns them. Other clients ignore an extension they do not implement, leaving the portable skills and MCP configuration usable.

Migrate without breaking the existing plugin

Use an additive migration:

1. Add and validate the root plugin.json without deleting working platform files.
2. Move or copy reusable skills into skills//SKILL.md.