cli-skill-collector

概要

インストール済みの CLI コーディングツール（Claude Code、Codex、Cursor、Copilot、Cline など）を検出し、一致するエージェントスキルを GitHub で検索して、OmniRoute の組み込み API を使って検出されたツールにインストールします。

クイックインストール

npm install -g omniroute   # or: npx omniroute
omniroute --version

サブコマンド

autostart

例：

omniroute autostart

autostart enable

例：

omniroute autostart enable

autostart disable

例：

omniroute autostart disable

autostart toggle

例：

omniroute autostart toggle

autostart status

例：

omniroute autostart status

config

CLI ツールの設定を表示または更新します

例：

omniroute config

config list

すべての CLI ツールと設定の状態を一覧表示します

フラグ：

• --json

例：

omniroute config list

config get <tool>

ツールの現在の設定を表示します

フラグ：

• --json

例：

omniroute config get <tool>

config set <tool>

ツールの設定を書き込みます

フラグ：

• --model <model>
• --non-interactive
• --yes
• --allow-container-write

例：

omniroute config set <tool>

config validate <tool>

書き込まずに設定形式を検証します

フラグ：

• --model <model>
• --json

例：

omniroute config validate <tool>

config opencode

OpenCode の設定を生成します（以下のエイリアスです。

フラグ：

• --model <model>
• --non-interactive
• --yes
• --allow-container-write

例：

omniroute config opencode

config lang

例：

omniroute config lang

config get

フラグ：

• --json

例：

omniroute config get

config set <code>

フラグ：

• --force

例：

omniroute config set <code>

config list

フラグ：

• --json

例：

omniroute config list

env

環境変数を表示および管理します

例：

omniroute env

env show

現在の環境変数を表示します

フラグ：

• --json

例：

omniroute env show

env get <key>

単一の環境変数を取得します

例：

omniroute env get <key>

env set <key> <value>

環境変数を設定します（現在のセッションのみ）

例：

omniroute env set <key> <value>

setup

フラグ：

• --password <value>
• --add-provider
• --provider <id>
• --provider-name <name>
• --api-key <value>
• --default-model <model>
• --provider-base-url <url>
• --test-provider
• --non-interactive
• --list

例：

omniroute setup

update

フラグ：

• --check
• --apply
• --changelog
• --dry-run
• --no-backup
• --yes

例：

omniroute update

/cli-skill-collector — エージェントスキルコレクター

コーディング CLI ツール向けのエージェントスキルを見つけてインストールします。すべて OmniRoute の組み込み API を通じて行います。

このスキルでは、次の方法を説明します。

1. 検出 — このマシンにインストールされているコーディング CLI を確認します
2. 検索 — 関連するエージェントスキル（SKILL.md リポジトリ）を GitHub で検索します
3. インストール — 見つかったスキルを検出されたコーディングツールにインストールします

別途 Skill Collector アプリを用意する必要はありません。OmniRoute の CLI 検出機能と GitHub 検索機能ですべて処理できます。

---

ステップ 1 — インストール済みのコーディングツールを検出する

OmniRoute の CLI ツール検出機能を呼び出し、インストールされているコーディングエージェントを確認します。

curl -H "Authorization: Bearer $OMNIROUTE_API_KEY" http://localhost:20128/api/skills/collect/detect

次の情報が返されます。

• OmniRoute のカタログにあるすべての CLI ツール（CLI_TOOL_IDS：claude、codex、cursor、copilot、opencode、cline、kilocode、hermes、hermes-agent、openclaw、droid、continue、qwen、windsurf、devin、antigravity など）
• 各ツールがインストール済みかつ実行可能かどうか
• インストール済みのツールに一致した GitHub スキル（関連性に基づくスコア付き）

応答の例：

{
  "tools": {
    "codex": { "installed": true, "runnable": true, "command": "codex" },
    "claude": { "installed": true, "runnable": true, "command": "claude" },
    "cursor": { "installed": false, "runnable": false }
  },
  "installedToolIds": ["codex", "claude"],
  "matchedSkills": [
    { "toolId": "codex", "repo": "user/skill-codex-xxx", "score": 0.85, "stars": 120 },
    { "toolId": "claude", "repo": "user/claude-agent-rules", "score": 0.92, "stars": 340 }
  ],
  "totalSkills": 85
}

---

ステップ 2 — 一致したスキルを確認する

インストール済みの各ツールについて、API は SKILL.md またはエージェント設定ファイルを含む関連する GitHub リポジトリを返します。優先順位付けには score フィールドを使います。

スコア	推奨度
0.80+	優秀 — メンテナンスが行き届き、スター数が多く、活発です
0.60+	良好 — 関連性があり、品質も十分です
0.40+	普通 — 確認が必要な場合があります
<0.40	品質が低いため、スキップしてください

手動で閲覧することもできます。

curl -H "Authorization: Bearer $OMNIROUTE_API_KEY" \
  "http://localhost:20128/api/github-skills?minStars=3&maxResults=50"

---

ステップ 3 — 検出されたツールにスキルをインストールする

選択したスキルを、検出された 1 つ以上のツールにインストールします。

curl -X POST http://localhost:20128/api/skills/collect/install \
  -H "Authorization: Bearer $OMNIROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "repoName": "user/skill-codex-xxx",
    "targets": ["codex", "claude"],
    "description": "Agent skill for coding workflows"
  }'

これにより、各対象ツールのインストール先パスが計画されます。

• claude → ~/.claude/skills/{category}/
• codex → ~/.codex/skills/{category}/
• hermes → ~/AppData/Local/hermes/skills/{category}/
• opencode → ~/.opencode/skills/{category}/
• gemini → ~/.gemini/skills/{category}/

実際のファイル同期（GitHub からのクローンと SKILL.md のコピー）は、エージェントが標準の curl + cp コマンドを使って行います。

---

ステップ 4 — インストールを確認する

インストール後、スキルが配置されていることを確認します。

# For Codex
ls -la ~/.codex/skills/imported-github/*/SKILL.md

# For Claude Code
ls -la ~/.claude/skills/imported-github/*/SKILL.md

# For Hermes (Windows)
ls -la ~/AppData/Local/hermes/skills/imported-github/*/SKILL.md

検出結果も再確認します。

curl -H "Authorization: Bearer $OMNIROUTE_API_KEY" http://localhost:20128/api/skills/collect/detect

---

クイックスタート（ワークフロー全体）

AUTH_HEADER="Authorization: Bearer $OMNIROUTE_API_KEY"

# 1. Detect
DETECT=$(curl -s -H "$AUTH_HEADER" http://localhost:20128/api/skills/collect/detect)

# 2. Pick top matched skill for first installed tool
TOOL=$(echo "$DETECT" | python3 -c "import sys,json;d=json.load(sys.stdin);print(d['installedToolIds'][0] if d['installedToolIds'] else '')")
SKILL=$(echo "$DETECT" | python3 -c "import sys,json;d=json.load(sys.stdin);ms=d.get('matchedSkills',[]);print(ms[0]['repo'] if ms else '')")

if [ -n "$TOOL" ] && [ -n "$SKILL" ]; then
  # 3. Install
  curl -s -X POST http://localhost:20128/api/skills/collect/install \
    -H "$AUTH_HEADER" \
    -H "Content-Type: application/json" \
    -d "{\"repoName\": \"$SKILL\", \"targets\": [\"$TOOL\"]}"
  echo "Installed $SKILL to $TOOL"
fi

---

注意事項

• OmniRoute はローカルのポート 20128（デフォルト）で実行されている必要があります。カスタムポートの設定については、docs/frameworks/SKILLS.md を参照してください。
• /api/skills/collect/* および /api/github-skills エンドポイントには、ほかのすべての /api/skills/* ルートと同様に、管理スコープの認証が必要です。認証には、ダッシュボードのセッション、ループバック CLI トークン、または manage スコープを持つ API キー（requireManagementAuth()）を使用します。認証がバイパスされるのは、サーバーにログイン要件も API キー要件も設定されていない場合に限られます。
• この機能は、単体で動作する Skill Collector Python アプリに代わるものです。すべてのロジックが OmniRoute 内に組み込まれています。