Skillry MCP 工具參考

在已連接的 MCP 用戶端中呼叫這些工具。通常由 Agent 填入參數；本文供你確認呼叫或開發整合時參考。

skillry-cli@lateststdioskills:read

核對日期：2026 年 10 月 26 日

連接用戶端

呼叫工具前

加入你的用戶端

Skillry 使用本機 stdio 服務，支援 macOS 或 Windows，需要 Node.js 22+。憑證儲存在系統鑰匙圈中。網站的 /mcp 是設定頁面，並非遠端 MCP 端點。

帳號與授權

帳號操作使用瀏覽器授權，權限為 skills:read。目前憑證 7 天後到期，尚無自動續期。同一電腦的 CLI 與 MCP 共用同一服務網址的憑證，中斷連接會撤銷這份憑證。

安裝前先查看需求與存取權限，保留使用者選定的 Skill 與版本。安裝不會執行 Skill、購買存取權限或支付外部服務費用。

將 <skill-slug> 替換為 search_skills 回傳的 slug，將 <published-version> 替換為選定的發布版本。目錄須使用你自己電腦上的絕對路徑。

搜尋與探索

search_skills

公開存取

依目標產出與明確需求搜尋已發布的 Skill。預設使用關鍵字檢索，符合結果不代表能在你的環境中執行。

參數9

querystring選填

描述目標產出，或提供精確名稱／slug。作為輸入的 PDF 或網址不決定輸出類型。

maxLength: 200 · 預設值 ""

outputTypestring選填

依目標產出篩選；簡報類在 API 中使用 presentation。

deliveryScopestring選填

選擇完整作品或元件。缺少交付範圍資訊時仍須確認。

complete | component

avoidVoiceoverboolean選填

設為 true，排除已聲明核心流程需要配音的候選項目。

allowApiKeysboolean選填

設為 false，排除已聲明必須提供服務商 Key 的候選項目。未聲明的仍視為未知。

allowExternalCostsboolean選填

設為 false，排除已聲明外部費用的候選項目。未知費用仍須確認。

limitinteger選填

每次呼叫的最大結果數，以該工具顯示的範圍與預設值為準。

≥ 1 · ≤ 20 · 預設值 5

offsetinteger選填

分頁位移量，繼續查詢時使用回傳的 nextOffset。

≥ 0 · ≤ 10000 · 預設值 0

localestring選填

內容語言，使用精確的 API 值，包括 zh-CN、zh-TW 和 pt-BR。

en | zh-CN | zh-TW | ja | ko | es | pt-BR | de | fr · 預設值 "en"

參數範例 · JSON

{
  "query": "product presentation",
  "outputType": "presentation",
  "avoidVoiceover": true,
  "allowApiKeys": false,
  "allowExternalCosts": false,
  "limit": 3
}

回傳結果與行為

回傳 skills、nextOffset 與檢索／待確認狀態。查看 appliedRequirements、requirementReview、costNotice 和 clarificationQuestion。未知需求仍須確認；constraintsStatus: unconfirmed 表示伺服器未確認限制已生效。分數不是機率。

帳號與授權

connect_account

瀏覽器授權流程

使用者要求連接時，開始瀏覽器帳號授權；若已有等待中的流程，則沿用該流程。

參數不需要參數，傳入空物件即可。

回傳結果與行為

回傳 verificationUrl、userCode、expiresAt、browserOpened 和 pollAfterSeconds。向使用者顯示連結與驗證碼，不回傳憑證。

connection_status

瀏覽器授權流程

繼續等待中的授權流程，依回傳的 pollAfterSeconds 間隔再次查詢。

參數不需要參數，傳入空物件即可。

回傳結果與行為

狀態為 not_started、pending、denied、expired 或 connected。核准後將憑證存入系統鑰匙圈，請遵守輪詢間隔。

account_status

需要帳號

查看目前會員狀態、授權到期時間、權限範圍與每日下載配額。

參數不需要參數，傳入空物件即可。

回傳結果與行為

回傳 connected、entitlement、scope、sessionExpiresAt、quota 和 pricingUrl，不包含個人身分資訊或憑證。

disconnect_account

需要帳號

取消等待中的授權，撤銷 CLI/MCP 共用憑證，並從系統鑰匙圈移除。

參數不需要參數，傳入空物件即可。

回傳結果與行為

查看 serverRevoked。若遠端撤銷失敗，本機憑證仍會刪除，但伺服器憑證可能在到期前持續有效。

get_skill_access

需要帳號

下載前檢查一個已發布 Skill 的存取權限，此檢查不預留或消耗配額。

參數1

slugstring必填

使用者選中的已發布 Skill 精確 slug，使用小寫連字號形式，最長 64 個字元。

minLength: 1 · maxLength: 64

參數範例 · JSON

{
  "slug": "<skill-slug>"
}

回傳結果與行為

回傳 access（free、purchased、member 或 purchase_required）、canDownload、reason、purchaseUrl、version 和 quota，下載時會再次檢查權限。

下載、安裝與更新

download_skill

需要帳號修改本機檔案

將驗證過的 Skill ZIP 儲存到指定的絕對目錄，不覆寫既有檔案。

參數3

slugstring必填

使用者選中的已發布 Skill 精確 slug，使用小寫連字號形式，最長 64 個字元。

minLength: 1 · maxLength: 64

downloadDirectorystring必填

用於儲存 ZIP 的明確絕對目錄，不使用 Agent 或安裝範圍參數。

maxLength: 4096

expectedVersionstring選填

選定的發布版本。更新時必填，安裝／下載時選填；發布版本變更後，須重新確認再繼續。

minLength: 1 · maxLength: 64

參數範例 · JSON

{
  "slug": "<skill-slug>",
  "downloadDirectory": "/absolute/path/downloads",
  "expectedVersion": "<published-version>"
}

回傳結果與行為

ZIP 完整性與版本檢查通過後，回傳 archivePath、slug、version 和 sha256。不會安裝，也不回報安裝完成。

install_skill

需要帳號修改本機檔案

把選定版本安裝到明確指定的 Agent 與範圍，不覆寫既有 Skill 目錄。

參數5

slugstring必填

使用者選中的已發布 Skill 精確 slug，使用小寫連字號形式，最長 64 個字元。

minLength: 1 · maxLength: 64

agentstring必填

安裝目標，與 MCP 宿主名稱分開。全域安裝使用對應的 Skills 目錄；專案範圍僅接受 shared 或 claude-code。

scopestring選填

global 表示為目前系統使用者安裝；project 表示安裝到明確指定的 projectDirectory 下。

global | project · 預設值 "global"

projectDirectorystring選填

專案絕對路徑。scope: project 時必填，scope: global 時不允許傳入。shared 使用 .agents/skills，claude-code 使用 .claude/skills。

maxLength: 4096

expectedVersionstring選填

選定的發布版本。更新時必填，安裝／下載時選填；發布版本變更後，須重新確認再繼續。

minLength: 1 · maxLength: 64

參數範例 · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

回傳結果與行為

回傳 targetPath、skillFile、version、completionReported 和 inventoryRecorded。執行前請閱讀 SKILL.md 並確認費用。

list_installed_skills

本機檔案

讀取指定本機目錄中的 Skill。只有 Skillry 管理的安裝紀錄才有發布版本。

參數3

agentstring必填

安裝目標，與 MCP 宿主名稱分開。全域安裝使用對應的 Skills 目錄；專案範圍僅接受 shared 或 claude-code。

scopestring選填

global 表示為目前系統使用者安裝；project 表示安裝到明確指定的 projectDirectory 下。

global | project · 預設值 "global"

projectDirectorystring選填

專案絕對路徑。scope: project 時必填，scope: global 時不允許傳入。shared 使用 .agents/skills，claude-code 使用 .claude/skills。

maxLength: 4096

參數範例 · JSON

{
  "agent": "shared",
  "scope": "global"
}

回傳結果與行為

回傳本機項目及 managed/version 狀態。非受管理 Skill 的版本未知，不能靜默升級。

check_updates

本機檔案

比較受管理的安裝與已發布版本，檢查本身不會下載或安裝更新。

參數5

agentstring必填

安裝目標，與 MCP 宿主名稱分開。全域安裝使用對應的 Skills 目錄；專案範圍僅接受 shared 或 claude-code。

scopestring選填

global 表示為目前系統使用者安裝；project 表示安裝到明確指定的 projectDirectory 下。

global | project · 預設值 "global"

projectDirectorystring選填

專案絕對路徑。scope: project 時必填，scope: global 時不允許傳入。shared 使用 .agents/skills，claude-code 使用 .claude/skills。

maxLength: 4096

offsetinteger選填

分頁位移量，繼續查詢時使用回傳的 nextOffset。

≥ 0 · ≤ 9007199254740991 · 預設值 0

limitinteger選填

每次呼叫的最大結果數，以該工具顯示的範圍與預設值為準。

≥ 1 · ≤ 5 · 預設值 5

參數範例 · JSON

{
  "agent": "shared",
  "scope": "global",
  "offset": 0,
  "limit": 5
}

回傳結果與行為

每項狀態為 current、update_available、unavailable 或 unmanaged，並回傳 nextOffset。繼續查詢時使用相同 Agent 與範圍。

update_skill

需要帳號修改本機檔案

將電腦上由 Skillry 管理的已安裝 Skill 更新至使用者明確核准的版本，完整備份原目錄，包括本機修改。

參數5

agentstring必填

安裝目標，與 MCP 宿主名稱分開。全域安裝使用對應的 Skills 目錄；專案範圍僅接受 shared 或 claude-code。

scopestring選填

global 表示為目前系統使用者安裝；project 表示安裝到明確指定的 projectDirectory 下。

global | project · 預設值 "global"

projectDirectorystring選填

專案絕對路徑。scope: project 時必填，scope: global 時不允許傳入。shared 使用 .agents/skills，claude-code 使用 .claude/skills。

maxLength: 4096

slugstring必填

使用者選中的已發布 Skill 精確 slug，使用小寫連字號形式，最長 64 個字元。

minLength: 1 · maxLength: 64

expectedVersionstring必填

選定的發布版本。更新時必填，安裝／下載時選填；發布版本變更後，須重新確認再繼續。

minLength: 1 · maxLength: 64

參數範例 · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

回傳結果與行為

發生替換時回傳安裝版本與 backupPath；若已是指定版本，則直接回傳，不做替換。

安裝目錄

全域安裝：shared、codex、cursor、gemini-cli、opencode、kimi-code 使用 ~/.agents/skills；claude-code 使用 ~/.claude/skills；antigravity 使用 ~/.gemini/config/skills。專案安裝使用 <projectDirectory>/.agents/skills 或 <projectDirectory>/.claude/skills。不要從 MCP 程序的工作目錄推斷專案位置。

參數範例 · install_skill

{
  "slug": "<skill-slug>",
  "agent": "claude-code",
  "scope": "project",
  "projectDirectory": "/absolute/path/project",
  "expectedVersion": "<published-version>"
}

狀態與疑難排解

帳號尚未授權或授權已到期: 遇到 authentication_required 或 session_expired，先詢問使用者是否連接，再呼叫 connect_account，顯示連結與驗證碼，依指定間隔查詢 connection_status。核准後重試原操作。
Skill 目錄已存在: 遇到 skill_already_installed，以 list_installed_skills 和 check_updates 檢查同一目標。將受管理的安裝更新到選定的新版本前，先徵求確認。MCP 沒有 force 參數。
需要購買或每日配額已用完: purchase_required 或 premium_required 時，使用回傳的 purchaseUrl/actionUrl；daily_download_limit 時，顯示 resetsAt。同一天重複下載同一個 Skill 不額外占用不同 Skill 的名額，每日於 UTC 00:00 重設。
沒有出現 Skillry 工具: 檢查 Node.js 22+、所選系統設定與用戶端記錄。加入服務後重新啟動或載入用戶端。目前接入方式不支援純瀏覽器或 Linux 環境。

延伸閱讀

連接用戶端連接 Skillry MCP Model Context Protocol