Skillz

👌 在任何代理中使用技能 (Codex, Copilot, Cursor 等)

⚠️ 实验性概念验证。可能存在风险。请像对待不可信代码一样处理技能，并在沙箱或容器中运行。自行承担风险。

Skillz 是一个MCP服务器，它将 Claude风格的技能（包括 SKILL.md 文件及可选资源）转换成任何MCP客户端可以调用的工具。它会发现每个技能，公开编写好的指令和资源，并能运行捆绑的帮助脚本。

💡 您可以在 Skills 超市 目录中找到要安装的技能。

快速开始

要在您的代理中运行MCP服务器，请使用以下配置（或等效配置）：

{
  "skillz": {
    "command": "uvx",
    "args": ["skillz@latest"]
  }
}

其中技能位于 ~/.skillz

或者

{
  "skillz": {
    "command": "uvx",
    "args": ["skillz@latest", "/path/to/skills/direcotry"]
  }
}

或者使用Docker

您可以使用Docker来隔离运行Skillz。该镜像可以在Docker Hub上找到，地址是 intellectronica/skillz。

要使用Docker挂载您的技能目录来运行Skillz MCP服务器，请按如下方式配置您的代理：

将 /path/to/skills 替换为您实际的技能目录路径。数组中的 intellectronica/skillz 后面的所有参数都会直接传递给Skillz CLI。

{
  "skillz": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-v",
      "/path/to/skills:/skillz",
      "intellectronica/skillz",
      "/skillz"
    ]
  }
}

使用方法

Skillz会在您提供的根目录内查找技能（默认为 ~/.skillz）。每个技能都位于自己的文件夹或压缩包（.zip 或 .skill）中，其中包括一个带有描述技能的YAML前缀的 SKILL.md 文件。技能中的其他文件将成为您的代理可以下载的资源（脚本、数据集、示例等）。

一个示例目录可能看起来像这样：

~/.skillz/
├── summarize-docs/
│   ├── SKILL.md
│   ├── summarize.py
│   └── prompts/example.txt
├── translate.zip
├── analyzer.skill
└── web-search/
    └── SKILL.md

当将技能打包为压缩包（.zip 或 .skill）时，应将 SKILL.md 放在存档的根目录或单个顶级目录中：

translate.zip
├── SKILL.md
└── helpers/
    └── translate.js

data-cleaner.zip
└── data-cleaner/
    ├── SKILL.md
    └── clean.py

目录结构：Skillz vs Claude Code

与Claude Code相比，Skillz支持更灵活的技能目录。除了扁平布局外，您还可以将技能组织在嵌套子目录中，并包含打包为 .zip 或 .skill 文件的技能（如上述示例所示）。

另一方面，Claude Code期望一个扁平的技能目录：每个直接子目录都是一个单独的技能。不发现嵌套目录，并且不支持 .zip 或 .skill 文件。

如果您希望您的技能目录与Claude Code兼容（例如，以便可以在两个工具之间链接一个技能目录），则必须使用扁平布局。

与Claude Code兼容的布局：

skills/
├── hello-world/
│   ├── SKILL.md
│   └── run.sh
└── summarize-text/
    ├── SKILL.md
    └── run.py

仅适用于Skillz的布局示例（不与Claude Code兼容）：

skills/
├── text-tools/
│   └── summarize-text/
│       ├── SKILL.md
│       └── run.py
├── image-processing.zip
└── data-analyzer.skill

您可以通过 skillz --list-skills（可选指向另一个技能根目录）来验证服务器将暴露哪些技能，然后再将其连接到您的代理。

命令行参考

skillz [skills_root] [options]

标志 / 选项	描述
位置参数 skills_root	可选的技能目录（默认为 ~/.skillz）。
--transport {stdio,http,sse}	选择FastMCP传输方式（默认为 stdio）。
--host HOST	绑定HTTP/SSE传输的地址。
--port PORT	HTTP/SSE传输的端口。
--path PATH	使用HTTP传输时的URL路径。
--list-skills	列出已发现的技能并退出。
--verbose	将调试日志输出到控制台。
--log	将详细的日志镜像到 /tmp/skillz.log。

---

由 @intellectronica 制作 🫶