cli2skill は何をしますか？
🔧 任意のCLIやMCPサーバーをエージェントスキルに変換 — プロセスオーバーヘッドゼロ、トークン消費を98%削減。MCPゾンビプロセスを排除。Claude Code、Codex、Gemini CLIなど26以上のプラットフォームで動作。
概要
cli2skill は、既存のCLIツールやMCPサーバーを、AIエージェントが直接利用できる「スキル」に変換するユーティリティです。従来のアプローチと比較して、以下の利点があります：
- プロセスオーバーヘッドゼロ: リクエストごとにプロセスを起動せず、エージェントプロセス内で直接実行
- トークン消費を98%削減: 不要なプロトコルオーバーヘッドを排除
- ゾンビプロセスなし: プロセス管理の手間から解放
- 26以上のプラットフォーム対応: Claude Code, Codex, Gemini CLI, Cursor, Windsurf など
インストール
npm install -g cli2skill
# または
git clone https://github.com/2233admin/cli2skill.git
cd cli2skill
npm install
使い方
1. スキルの定義
プロジェクトルートに skill.json ファイルを作成します：
{
"name": "my-cli-skill",
"description": "マイCLIツールをエージェントスキルとして提供",
"tools": [
{
"name": "greet",
"description": "指定された名前に対して挨拶を生成",
"command": "echo Hello, $NAME!"
},
{
"name": "file-stats",
"description": "ファイルの統計情報を取得",
"command": "wc -l $FILE",
"args": {
"FILE": {
"type": "string",
"description": "調査するファイルパス"
}
}
}
]
}
2. スキルの実行
cli2skill run --tool greet --name "World"
# 出力: Hello, World!
対応プラットフォーム
- Claude Code (
claude_code) - Codex (
codex) - Gemini CLI (
gemini_cli) - Cursor (
cursor) - Windsurf (
windsurf) - その他 20以上のプラットフォーム（自動検出）
高度な設定
skill.json では以下のオプションがサポートされています：
| フィールド | 型 | 説明 |
|---|---|---|
timeout | 数値 | コマンドのタイムアウト時間（ミリ秒） |
cwd | 文字列 | 作業ディレクトリ |
env | オブジェクト | 環境変数 |
interactive | ブーリアン | インタラクティブモードを有効化 |
outputType | 文字列 | 出力形式（text, json, raw） |
トラブルシューティング
コマンドが見つからない
command フィールドのパスが正しいか確認してください。絶対パス、もしくは $PATH に含まれている必要があります。
権限エラー
実行ユーザーに適切な権限があるか確認してください。
ライセンス
MIT