Agent プラグインの仕様 v1.0.0 のコピー可能なリファレンスパッケージ。

このリポジトリは、ポータブルコアを実証し、クライアント固有のフォーマットから既存のプラグインを移行するのに役立つエージェントスキルを含みます。 規範的な仕様の代替ではなく、参照例です。それらが異なる場合は、仕様が勝ちます。

レイアウト

最小限の有効なプラグインは plugin.json のみを必要とします。 この例では、機能的なイラストだけでなく、機能的にも役立つスキルが含まれています。

ポータブルコア

Agent Plugins v1 は、2 つのポータブルコンポーネントタイプを定義します。

• [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.