← 文件Markdown登入

技能與示例

建立、複製並整理技能與示例。

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。