Skillz

🚀 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]

由 @intellectronica 用心打造 🫶