Skillz

🚀 Skillz

Skillz は、任意のエージェント（Codex、Copilot、Cursor など）で Claude 形式のスキル（SKILL.md とオプションのリソース）を呼び出し可能なツールに変換する MCP サーバーです。各スキルを検出し、作成された指示とリソースを公開し、バンドルされたヘルパースクリプトを実行することができます。

⚠️ 重要提示

これは実験的な概念実証です。潜在的に危険です。スキルを信頼できないコードとして扱い、サンドボックスやコンテナ内で実行してください。自己責任で使用してください。

💡 使用建议

インストールするスキルは、Skills Supermarket ディレクトリで見つけることができます。

🚀 クイックスタート

エージェントで 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 アーカイブ（.zip または .skill）に格納され、その中にはスキルを説明する YAML フロントマター付きの SKILL.md ファイルが含まれています。スキル内の他のファイルは、エージェントのダウンロード可能なリソース（スクリプト、データセット、サンプルなど）になります。

例えば、以下のようなディレクトリ構造があります。

~/.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 Code の比較

Skillz は、Claude Code よりも柔軟なスキルディレクトリをサポートしています。フラットなレイアウトに加えて、ネストされたサブディレクトリにスキルを整理したり、.zip または .skill ファイルとしてパッケージ化されたスキルを含めることができます（上記の例を参照）。

一方、Claude Code はフラットなスキルディレクトリを期待します。すべての直下のサブディレクトリは単一のスキルです。ネストされたディレクトリは検出されず、.zip または .skill ファイルはサポートされていません。

スキルディレクトリを Claude Code と互換性のあるものにする場合（例えば、2つのツール間で1つのスキルディレクトリをシンボリックリンクで共有する場合）、フラットなレイアウトを使用する必要があります。

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]

Made with 🫶 by @intellectronica