/SKILL.md，並將該資料夾內部的內容交由 Agent Skills 規格處理。這是相同的樹狀結構。
以下是我們早已寫好的 skill，封裝時完全不需要修改：
```
---
name: summarize-report
description: Summarize a quarterly revenue report into an executive brief.
Use when the user asks to summarize, condense, or brief a financial report.
---
# Summarize a revenue report
## Steps
1. Fetch the report with the `reports` MCP server's `fetch_report` tool.
2. Load `references/house-style.md` and follow its tone rules.
3. Produce three sections: Headline, Numbers That Moved, Risks.
4. Keep the brief under 300 words.
## Rules
- Never estimate a figure the report does not state.
- Quote every percentage with its comparison period.
- If a quarter is missing, say so rather than interpolating.
```
請注意 Steps 第 1 行的前提：MCP 伺服器必須正在執行。封裝要解決的正是這項相依性。
遷移只需要在根目錄新增一個檔案：
```json
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "acme.reports"
}
```
這兩個欄位都是必要欄位，而這就是最小需求。名稱長度必須介於 1 到 64 個字元之間，只能包含小寫英數字元、連字號和句點，且必須以英數字元開頭和結尾，也不能包含 `--` 或 `...`。因此 `acme.reports` 沒問題，但 `My-Plugin`、`-start` 和 `has--double` 都不符合規定。
準備好要發布，而不是只做測試時，manifest 也可以加入中繼資料。這個結構描述採封閉設計：只允許十個頂層欄位，不能有其他欄位（完整欄位參考）。
```json
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "acme.reports",
"version": "1.2.0",
"description": "Revenue reporting skills and the MCP server they call.",
"author": { "name": "Acme Data", "url": "https://acme.example" },
"homepage": "https://acme.example/reports-plugin",
"repository": "https://github.com/acme/reports-plugin",
"license": "Apache-2.0",
"keywords": ["reports", "finance", "bigquery"]
}
```
這是十個欄位中的九個。最後一個是 extensions，用於放置客戶端專屬資料，稍後會再介紹。author 也可以選擇性加入 email。
version 應該使用 SemVer，license 則應該使用 SPDX；不過，如果字串格式不正確，客戶端不會因此拒絕你。JSON 型別錯誤則是另一回事：即使是選用欄位，該是字串的地方放了數字，也會造成致命錯誤。只有兩種結構描述違規不會造成致命錯誤：未知的頂層欄位，以及不是物件的 extensions 值。這兩者都會被回報並忽略，plugin 仍然可以載入。其他所有錯誤都是致命錯誤，客戶端會拒絕整個套件。
有一項規則常讓正在遷移大型 skill 程式庫的人踩雷。探索只會深入一層：客戶端會讀取 skills/ 的直接子資料夾，不會遞迴搜尋（探索規則）。如果你過去將 skill 分組放在分類資料夾中，那些 skill 在封裝後就會直接消失，而且不會有錯誤說明原因。
展開畫面重點
畫面頂部標題：「You have already built most of one」
副標題：「A skill folder plus one manifest is a plugin」
左側方框內容：「Your skill folder」下方標示「skills/ + SKILL.md」，方框下方有綠色橫條。
中間有加號（+），接著是方框標示「plugin.json」，下方有黃色橫條。
右側有等號（=），接著是方框標示「An Agent Plugin」，下方有藍色橫條。
底部文字：「The migration is a single file.」
展開畫面重點
- 頂部標題：「What travels together」
- 副標題：「Expertise and tools in one package」
- 容器區塊標題：「reports-plugin/」
- 左側子區塊：
- 標題：「skills/」
- 描述：「what the agent knows」
- 右側子區塊：
- 標題：「mcp.json」
- 描述：「what the agent can do」
- 底部標題：「One folder carries both.」
展開畫面重點
頂端標題文字：
Components fail independently
A dead server does not take your skills down
中央區塊（標題：reports-plugin/）：
- 第一個項目：plugin.json，右側帶有綠色打勾圖示與文字「loads」以及綠色底線。
- 第二個項目：skills/summarize-report/，右側帶有綠色打勾圖示與文字「loads」以及綠色底線。
- 第三個項目：mcp.json，呈灰色字樣，右側帶有紅色打叉圖示與文字「skipped, reported」以及紅色底線。
底端說明文字：
The package degrades in parts, not all at once.
展開畫面重點
Portable core, client extensions
Clients ignore namespaces they do not recognise
Portable core
skills/
mcp.json
Client extensions
com.example.client/
com.other.client/
Everyone reads the core. Only its owner reads the namespace.
展開畫面重點
畫面為一張標題為「Deciding what to package」的流程圖，副標題為「Not everything needs to be a plugin」。
流程圖內容如下：
- 頂層判斷：「Does it need tools?」
- 若為「no」：導向「Ship a Skill」（下方有綠色橫條）。
- 若為「yes」：導向下一步判斷：「More than one client?」
- 若為「no」：導向「Ship mcp.json」（下方有黃色橫條）。
- 若為「yes」：導向「Ship a Plugin」（下方有藍色橫條）。
底部文字為：「Reach for a plugin when instructions and tools must arrive together.」