Skillvad 遵循 Claude、Codex、Cursor 等所用的開放 Agent Skills 格式。一個技能就是一個資料夾:
pdf-processing/
├── SKILL.md instructions (required)
├── LICENSE.txt license terms (optional)
├── references/ docs the agent reads only when needed
├── scripts/ code the agent can run
└── assets/ templates and data
技能
- 標題:匯出時成為資料夾的
name(小寫、短橫線)。 - 描述(必填):技能做什麼,以及何時使用。智慧體先讀這段來決定是否載入該技能,因此請寫明場景和關鍵字。
- 說明:SKILL.md 的正文,使用 Markdown。儘量控制在約 500 行以內,長內容放到 references。
- 標籤(可選)。
- 授權(可選):MIT、Apache 2.0、CC BY 4.0、CC0、Proprietary,或其他。新增完整條款後會匯出為 LICENSE.txt。
- 要求(可選):僅當技能需要特定工具或存取權限時填寫,例如 "Needs Python 3.12 and internet access"。匯出為
compatibility。 - 可見性:Private(預設)、某個團隊、Unlisted 或 Public。詳見 /docs/visibility。
建立技能時貼上完整的 SKILL.md,標題、描述和授權會從前言(frontmatter)自動填入。
穩定 URL:/u/<username>/skills/<uuid>
參考檔案與其他檔案
開啟技能的 References 標籤,在 references/、scripts/ 或 assets/ 下新增檔案。在 SKILL.md 中按路徑提及每個檔案(例如 "For the full style rules, read references/style-guide.md"),以便智慧體知道何時開啟。僅支援文本檔案,每個最多 100 KB,每個技能最多 30 個。
示例
示例屬於某個技能,展示真實輸出。它們讓技能可信:隊友或智慧體能準確看到「好」的結果是什麼樣。
- 列表:
/app/skills/<uuid>/examples - 詳情:
/app/skills/<uuid>/<example-slug>
版本歷史
對說明、描述、標籤或授權的每次編輯都會儲存為帶編號的版本。Free 方案顯示最近 2 個;Pro 和 Team 顯示全部。
複製、下載、安裝
- 複製技能 複製完整的 SKILL.md 說明。
- 下載 .zip 提供整個資料夾(帶 frontmatter 的 SKILL.md、LICENSE.txt、references)。
安裝下載內容:
- Claude(應用): Settings → Capabilities → Skills → 上傳 zip。
- Claude Code: 解壓到
~/.claude/skills/(或專案中的.claude/skills/)。 - Codex / Cursor / 其他: 解壓到應用的 skills 資料夾(例如
~/.codex/skills/)。
也可以跳過下載,透過 MCP 連線智慧體,讓它始終讀取最新版本。詳見 /docs/connectors。
