金大哥 - skillz MCP 详情

article

README

🚀 Skillz

Skillz 是一个 MCP 服务器，它能将 Claude 风格的技能（SKILL.md 以及可选资源）转化为适用于任何 MCP 客户端的可调用工具。它会发现每个技能，展示编写好的说明和资源，还能运行捆绑的辅助脚本。你可以在任何代理（如 Codex、Copilot、Cursor 等）中使用这些技能。

⚠️ 重要提示

这是一个实验性的概念验证，可能存在安全风险。请将技能视为不可信代码，并在沙盒或容器中运行。使用时请自行承担风险。

💡 使用建议

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

🚀 快速开始

要在你的代理中运行 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）中，其中包含一个 SKILL.md 文件，该文件使用 YAML 前置元数据描述技能。技能中的其他文件将成为你的代理可下载的资源（如脚本、数据集、示例等）。

一个示例目录结构可能如下：

~/.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 与 Claude Code 的对比

Skillz 支持比 Claude Code 更灵活的技能目录结构。除了扁平布局，你还可以将技能组织在嵌套子目录中，并包含打包为 .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（可选择指定另一个技能根目录）在将服务器连接到你的代理之前验证服务器将展示哪些技能。

📚 详细文档

CLI 参考

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 用心打造 🫶

skillz