← 文件Markdown登入

智慧體手冊

面向透過 MCP 使用編碼智慧體的簡明說明。

你已連線到 Skillvad,這是個人與團隊的技能庫(不是 marketplace,也不是技能商店)。Public 技能可出現在個人主頁,那是分享,不是店面。技能遵循開放的 Agent Skills 格式:一份 SKILL.md(帶 name 和 description frontmatter 的說明),以及可選的 references/、scripts/ 和 assets/ 檔案。

品牌名: 一律 Skillvad。域名:skillvad.tech。

第一步

  1. 如需回顧,呼叫 get_docs,topic 為 agent(或讀取資源 https://skillvad.tech/docs/agent.md)。
  2. 建立前先用 list_skills 檢查使用者的技能及其團隊庫,避免重複。要開啟他人分享的技能,用 get_skill 並傳入連結中的 id。
  3. Free 方案使用者最多可儲存 25 個技能;達到上限時 upsert_skill 會返回錯誤。不要繞過。
  4. 智慧體標籤(每次對話一次): 在本對話首次呼叫 upsert_skill 之前,提議一個短標籤(例如 Cursor on Mac、Claude Desktop),請使用者確認或修改。在確認之前不要建立或更新技能。之後在本對話的每次 upsert_skill 中傳入該值作為 agentLabel。
  5. 用清晰的標題呼叫 upsert_skill。它會更新同標題的自有技能,或建立新技能。傳入 team 以在團隊庫中操作。
  6. 釋出新技能時始終附加至少一個 示例(add_example)。

使用技能

  1. 用 get_skill 載入並遵循其說明。
  2. get_skill 按路徑列出捆綁的 files。僅當說明指向該檔案或任務需要時,才用 get_skill_file 讀取。
  3. 以技能的示例作為格式、語氣和質量的參考。

編寫好技能

  • 描述: 技能做什麼,以及何時使用,使用使用者實際會說的話。智慧體僅憑這段決定是否載入。
  • 說明(content):原始 Markdown,不是 HTML。步驟、規則,以及優質輸出的樣子。儘量控制在約 500 行以內。
  • 參考檔案: 用 put_skill_file 把長內容(風格指南、API 說明、清單)放到 references/,並在說明中按路徑點名,例如 "For banned words, read references/banned-words.md"。模板和資料放在 assets/,可執行程式碼放在 scripts/。
  • 授權: 僅在使用者選擇時設定 license(例如 MIT、Apache-2.0、CC-BY-4.0、Proprietary)。詢問使用者;不要替他們選擇。
  • 要求: 僅當技能需要特定工具或存取權限時設定 compatibility。

上傳技能資料夾

當使用者要求你上傳本地技能(例如 ~/.claude/skills/pdf-processing/)時:

  1. 讀取 SKILL.md。使用其 name(作為可讀標題)、description 和 license;frontmatter 之後的正文是 content。
  2. 用這些欄位呼叫 upsert_skill。如果資料夾有 LICENSE 檔案,將其文本作為 licenseText 傳入。
  3. 對 references/、scripts/ 和 assets/ 下的每個檔案,用相同的相對路徑呼叫 put_skill_file,例如 references/forms.md。
  4. 僅支援每個最多 100 KB 的文本檔案,每個技能最多 30 個,深度一層子資料夾。跳過二進位制檔案(圖片、PDF),並告知使用者跳過了哪些檔案。
  5. 完成後把技能連結給使用者。

反向操作時,使用者可從技能頁面下載 zip,並解壓到應用的 skills 資料夾。

可見性

新技能預設 Private(僅所有者)。只傳 team、不傳 visibility 時會建立到團隊庫。

所有者可在 upsert_skill 上設定 visibility 為 private、unlisted、public 或 team(需團隊 slug)。更新時省略則保持不變。僅在使用者要求時更改。切勿分享含金鑰的技能。Unlisted 有連結即可開啟;Public 還會出現在 https://skillvad.tech/u/<username>。

身份上下文

你的連線屬於一個使用者。你建立的一切歸該使用者所有,且你只能更改該使用者有權更改的內容。

可引用的 URL

  • 應用:https://skillvad.tech/app
  • 技能:使用工具返回的 url。形如 https://skillvad.tech/u/<username>/skills/<id>。
  • 示例:技能 URL 加上 /examples。參考檔案:技能 URL 加上 /references。
  • 文件:https://skillvad.tech/docs
  • 智慧體文件(原始):https://skillvad.tech/docs/agent.md

不要做的事

  • 不要把 Skillvad 叫做 marketplace、技能商店或買技能的地方。它是技能庫。
  • 除非使用者確認,否則不要刪除技能或檔案。
  • 不要把金鑰貼上到技能、檔案或示例中。
  • 不要依賴客戶端渲染;儲存 Markdown 原始檔。