MCP2Skill logoMCP2Skill 文档
MCP2Skill logoMCP2Skill 文档
首页MCP2Skill 帮助手册
生成与安装 Skills管理已安装 Skills
Skills

生成与安装 Skills

从 MCP 服务或工作区生成 Skill,并安装到目标 AI Agent

生成与安装 Skills

如果你希望真正发挥 MCP2Skill 的主价值,这一篇是最重要的章节之一。

MCP2Skill 的核心初衷,是把 MCP 工具转换成可复用的 Skills,让 AI Agent 不必每次都直接面向一整套 MCP 工具运行,从而借助按需加载减少重复上下文和无效消耗。

截图占位:从 MCP 服务详情页或工作区详情页打开 Skill 预览弹窗,展示文件树和导出安装按钮。

视频占位:从工作区生成 Skill,预览文件,然后安装到某个 AI Agent 的完整演示视频。

Skill 从哪里生成

当前版本支持两个来源:

  • 从单个 MCP 服务 生成
  • 从单个 工作区 生成

如果你只想导出某个服务的原始能力,用 MCP 服务生成更合适;如果你已经在工作区中做过工具筛选,通常更适合从工作区生成。

工作区 Skill 的两种生成模式

从工作区生成 Skill 时,产物结构由工作区里的 聚合生成 Skill 开关决定。

非聚合模式:每个 MCP 服务一个 Skill

默认情况下,聚合生成 Skill 是关闭的。此时从工作区预览、导出或安装 Skill,会按工作区里的成员 MCP 服务分别生成多个独立 Skill。

这种模式的特点是:

  • 每个 MCP 服务对应一个 Skill,名称与单独从该 MCP 服务生成时保持一致
  • SKILL.md 直接包含该服务的工具说明,不再额外生成 references 目录
  • 调用脚本仍然指向工作区端点,而不是单 MCP 服务端点
  • 工作区级别禁用的工具不会暴露给这些 Skill

如果多个 MCP 服务里存在同名工具,MCP2Skill 会使用工作区里的完整工具名,避免调用时混淆。

聚合模式:整个工作区一个 Skill

开启 聚合生成 Skill 后,从工作区生成 Skill 时会得到一个代表整个工作区的 Skill。

这种模式会把工作区中的可用工具聚合到同一个 Skill 里,更适合把一个工作区当作完整任务工具箱来使用。

只有聚合模式会使用工作区自己的 Skill 描述。非聚合模式会复用每个 MCP 服务自己的 Skill 描述。

为什么 Skill 能帮助节省 Token

这里说的节省,不是抽象的“更稳定”,而是使用方式本身发生了变化:

MCP 是直接工具暴露

直接接入 MCP 时,AI 面对的是一组可调用工具。这样的方式很适合兼容接入,但不一定是最节省上下文的路径。

Skills 是按需激活

把 MCP 工具转换成 Skill 之后,AI 通常先只看到 Skill 的名称和用途说明。只有任务真的匹配时,才继续读取完整 SKILL.md、脚本和参考资料。

MCP2Skill 的价值不是只做管理

MCP2Skill 的核心价值,不只是把工具收纳到一个地方,而是把 MCP 工具转换成 Skills,让 AI 在需要时再加载完整说明和资源。

你可以把节省 Token 理解为下面三点:

  • 先把原本直接暴露的 MCP 工具转换成 Skill
  • 让 AI 先看到少量描述信息,而不是一开始就加载完整说明和资源
  • 只在真正需要时才读取完整内容,减少无关上下文进入模型

Skill 路径更像“转换为可按需加载的 Skills”,网关路径更像“统一转发和复用 MCP”。

前者更适合长期复用和成本控制,后者更适合兼容多客户端接入。

生成前需要先准备什么

在安装 Skills 之前,先确认:

  • 目标 MCP 服务或工作区已经配置完成
  • 如果要安装到 AI Agent,已经在 设置 > AI Agents 中配置了目标目录

如果还没配置 AI Agent 目录,可以先只做预览或导出到本地目录。

什么时候优先生成 Skill,什么时候优先走 MCP 网关

场景更推荐的方式
想降低 AI 工作流中的 Token 消耗生成 Skill
想把高频 MCP 工具转换给 AI Agent 长期使用生成 Skill
想让多个 AI 客户端共用一套 MCP 配置MCP 网关
想快速兼容现有客户端的 MCP 接入方式MCP 网关
想同时获得长期复用和兼容性先整理 MCP,再同时保留 Skill 路径和网关路径

常见操作流程

  1. 打开某个 MCP 服务详情页,或某个工作区详情页
  2. 点击生成 Skill
  3. 查看预览内容
  4. 选择导出到目录,或安装到 AI Agent

预览步骤非常值得保留,因为它能帮助你在真正写入之前先确认内容是否符合预期。

如果工作区处于非聚合模式,预览窗口会按 Skill 分组展示多个生成结果;你可以展开不同 Skill 检查各自的 SKILL.md 和脚本文件。

推荐工作流

如果你想把 MCP2Skill 用得更稳,推荐顺序是:

  1. 先整理 MCP 服务,确保连接和工具都正常
  2. 按任务或能力边界整理工作区
  3. 选择合适的来源生成 Skill
  4. 安装到目标 AI Agent
  5. 再视需要保留网关路径给其他客户端复用

这样你得到的不是临时配置,而是一套可以长期复用的能力层。

导出到目录

适合:

  • 先保存一份 Skill 产物
  • 想手动检查文件结构
  • 想把结果交给其他环境使用

导出时,MCP2Skill 会让你选择输出目录,然后把生成文件写入该目录。

安装到 AI Agent

适合:

  • 你已经明确某个 AI Agent 的 Skills 目录位置
  • 你希望直接落到目标目录,减少手动复制

安装前,MCP2Skill 会先检测当前已配置的 AI Agent 目标。你只需要选择安装到哪些目标即可。

什么时候更适合从工作区生成

如果你已经在工作区中完成了下面这些整理:

  • 只保留了一部分 MCP 服务
  • 对工具做了筛选
  • 想面向某个具体任务打包能力

那通常直接从工作区生成更合适,因为它更接近你最终想交付给 AI Agent 的能力边界。

如果这个工作区包含多个用途不同的 MCP 服务,建议保持默认的非聚合模式;如果这个工作区本身就是一个强绑定的任务工具箱,再考虑开启聚合模式。

什么时候更适合从单个服务生成

如果你只是想保留某个服务本身的独立能力,例如:

  • 单独封装一个检索类服务
  • 单独封装一个代码生成类服务
  • 对某个服务做单独测试

那就优先从该服务生成。

生成后建议做什么

生成或安装完成后,建议马上:

  1. 打开 Skills 页面确认是否已经出现
  2. 检查 Skill 名称和数量是否符合预期
  3. 预览 SKILL.md 和其他文件
  4. 在实际 AI Agent 中做一次调用验证

相关章节

  • 想配置安装目标:看 常规与 MCP 设置
  • 想查看已安装 Skills:看 管理已安装 Skills
  • 想先整理工作区:看 工作区基础
  • 想了解作为第二路径的网关模式:看 连接外部 AI 客户端

界面导览

按当前界面结构快速认识 MCP2Skill 的主要页面和入口

管理已安装 Skills

在 Skills 页面查看、预览、定位和删除已安装的 Skill

目录

生成与安装 Skills
Skill 从哪里生成
工作区 Skill 的两种生成模式
非聚合模式:每个 MCP 服务一个 Skill
聚合模式:整个工作区一个 Skill
为什么 Skill 能帮助节省 Token
MCP 是直接工具暴露
Skills 是按需激活
MCP2Skill 的价值不是只做管理
生成前需要先准备什么
什么时候优先生成 Skill,什么时候优先走 MCP 网关
常见操作流程
推荐工作流
导出到目录
安装到 AI Agent
什么时候更适合从工作区生成
什么时候更适合从单个服务生成
生成后建议做什么
相关章节