使用说明
斯基尔茨
👌 使用 技能 在任何代理人 (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