技能管理工具

Skillz是一个MCP服务器,将Claude风格的技能转换为可调用工具,适用于任何MCP客户端。它支持发现技能、暴露授权指令和资源,并可以运行捆绑的帮助脚本。

  • by intellectronica
  • Python
  • 本地部署
  • 406 星标
  • 更新于
在 GitHub 查看 intellectronica/skillz

使用说明

斯基尔茨

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

⚠️ 概念的实验证明。可能不安全。将技能视为不受信任的代码,并在沙盒/容器中运行。使用风险自负。

斯基尔茨 是一个MCP服务器 克劳德风格技能 (SKILL.md 加上可选资源) 成为任何MCP客户端的可调用工具。它发现每种技能,公开编写的说明和资源,并可以运行捆绑的辅助脚本。

💡 您可以在以下网址找到安装技能 技能超市 目录。

快速开始

要在代理中运行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"
    ]
  }
}

Gemini CLI扩展

Gemini CLI扩展可在以下网址获得 intellectronica/双子座cli skillz.

安装时使用:

gemini extensions install https://github.com/intellectronica/gemini-cli-skillz

此扩展使用skillz MCP服务器在Gemini CLI中启用Anthropic风格的代理技能。

用法

Skillz在您提供的根目录中查找技能(默认为 ~/.skillz).每种技能都存在于自己的文件夹或zip存档中(.zip 或 .skill) 其中包括a SKILL.md 带有描述技能的YAML前端内容的文件。任何 技能中的其他文件成为您的代理的可下载资源(脚本, 数据集、示例等)。

示例目录可能如下:

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

将技能打包为zip存档时(.zip 或 .skill),包括 SKILL.md 位于存档的根目录或单个顶级目录中:

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

目录结构:Skillz与Claude代码

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

另一方面,Claude Code希望有一个扁平的技能目录:每个直接的子目录都是一个技能。未发现嵌套目录,以及 .zip 或 .skill 不支持文件。

如果你想让你的技能目录与Claude Code兼容(例如,这样你就可以在两个工具之间符号链接一个技能目录),你必须使用平面布局。

克劳德代码——兼容布局:

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

仅Skillz布局示例 (与克劳德代码不兼容):

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.

由...制作🫶 by @intellectronica