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