mcpField
A
agent-registry

agent-registry

github.com/matrixyエージェントワークフロー937 回インストール21 週間前に更新
リポジトリ

agent-registry について

agent-registry は、Agent を必要に応じて検索・読み込みする Claude Code 向けスキルです。すべての指示を事前に読み込まずに運用できます。

主な機能

  1. 01意図に基づく Agent 検索
  2. 02名前による指示の読み込み
  3. 03大規模な登録簿のページ検索
  4. 04既存 Agent の対話型移行

活用シーン

  1. 01タスクに合う Agent の検索
  2. 02コードレビュー Agent の読み込み
  3. 03既存 Agent ファイルの登録簿への移行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/matrixy/agent-registry --skill agent-registry

インストール後、Claude Code で/agent-registryを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
CLAUDE.md
README.md
package.json
package-lock.json
install.sh
bin/
rebuild.js
list.js
get.js
init.js
build-release-artifact.sh
search-paged.js
cli.js
search.js
docs/plans/
ctx-inspired-improvements.md
docs/releases/
v2.0.1.md
hooks/
user_prompt_search.js
lib/
parse.js
search.js
registry.js
telemetry.js
tests/
parse.test.js
search.test.js
cli.test.js
registry.test.js
telemetry.test.js

詳細

エージェントレジストリ

Claude Code エージェントの遅延読み込みシステムです。必要に応じてエージェントを読み込むことで、「約16kトークン」という警告を解消します。

重要なルール

エージェントが事前に読み込まれていると決して想定しないでください。 エージェントの検索と読み込みには、必ずこのレジストリを使用してください。

ワークフロー

User Request → search_agents(intent) → select best match → get_agent(name) → execute with agent

利用可能なコマンド

コマンド使用するタイミング例
list.jsユーザーから「どんなエージェントがある？」と聞かれた場合や、概要が必要な場合bun bin/list.js
search.jsユーザーの意図に合うエージェントを検索する場合（必ず最初に実行）bun bin/search.js "code review security"
search-paged.js大規模なレジストリ（エージェント300件以上）をページ分割して検索する場合bun bin/search-paged.js "query" --page 1 --page-size 10
get.js特定のエージェントの指示をすべて読み込む場合bun bin/get.js code-reviewer

まず検索する手順

  1. ユーザーのリクエストから意図を表すキーワードを抽出します
  2. 検索を実行します：bun bin/search.js "<keywords>"
  3. 検索結果を確認します：関連度スコア（0.0～1.0）を確認します
  4. 必要に応じて読み込みます：bun bin/get.js <agent-name>
  5. 実行します：読み込んだエージェントの指示に従います

例

ユーザー：「認証コードにセキュリティ上の問題がないか確認してもらえますか？」

# Step 1: Search for relevant agents
bun bin/search.js "code review security authentication"

# Output:
# Found 2 matching agents:
#   1. security-auditor (score: 0.89) - Analyzes code for security vulnerabilities
#   2. code-reviewer (score: 0.71) - General code review and best practices

# Step 2: Load the best match
bun bin/get.js security-auditor

# Step 3: Follow loaded agent instructions for the task

インストール

ステップ1：スキルをインストールする

クイックインストール（推奨）：

# Using Skills CLI (recommended)
npx skills add MaTriXy/Agent-Registry@agent-registry

# Discover skills interactively
npx skills find

# Update existing skills
npx skills update

従来のインストール方法：

# User-level installation
./install.sh

# OR project-level installation
./install.sh --project

# Optional: install enhanced interactive UI dependency
./install.sh --install-deps

install.sh の動作：

  1. スキルファイルを ~/.claude/skills/agent-registry/ にコピーします
  2. 空のレジストリ構造を作成します
  3. --install-deps を指定すると、依存関係を任意でインストールします（UI を強化する @clack/prompts）
ステップ2：エージェントを移行する

対話型の移行スクリプトを実行します：

cd ~/.claude/skills/agent-registry
bun bin/init.js
# Optional destructive mode:
bun bin/init.js --move

対話型選択モード：

  • @clack/prompts を使用（デフォルト）：カテゴリ別のグループ化、トークン数の表示、ページ送りに対応した、見やすいチェックボックス UI

    • 矢印キーで移動、スペースキーで切り替え、Enter キーで確定します
    • 視覚的な表示：[緑] 1k トークン未満、[黄] 1～3k、[赤] 3k 超
    • サブディレクトリごとにグループ化されます

  • フォールバック：テキスト形式の番号入力

    • カンマ区切りの番号を入力します（例：1,3,5）
    • すべてを移行するには all と入力します

init.js の動作：

  1. ~/.claude/agents/ と .claude/agents/ をスキャンしてエージェントファイルを探します
  2. 利用可能なエージェントをメタデータとともに表示します
  3. 移行するエージェントを対話形式で選択できます
  4. 選択したエージェントをデフォルトでレジストリにコピーします（--move を指定した場合のみ移動します）
  5. 検索インデックス（registry.json）を構築します

依存関係

  • Bun（Claude Code に同梱）— コア機能には追加の依存関係は不要です
  • @clack/prompts：対話型選択 UI を強化するオプション機能です（./install.sh --install-deps でインストールできます）

レジストリの場所

  • グローバル：~/.claude/skills/agent-registry/
  • プロジェクト：.claude/skills/agent-registry/（任意のオーバーライド）

移行されなかったエージェントは元の場所に残り、通常どおり読み込まれます（トークンの使用量が増加します）。

コメント

Markdown 対応