✓ Verified 💻 Development ✓ Enhanced Data

Agent Registry

MANDATORY agent discovery system for token-efficient agent.

Rating
4.4 (117 reviews)
Downloads
515 downloads
Version
1.0.0

Overview

MANDATORY agent discovery system for token-efficient agent.

✨Key Features

1

Install the Skill

2

Migrate Your Agents

Complete Documentation

View Source →

Agent Registry

Lazy-loading system for Claude Code agents. Eliminates the "~16k tokens" warning by loading agents on-demand.

CRITICAL RULE

NEVER assume agents are pre-loaded. Always use this registry to discover and load agents.

Workflow

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

Available Commands

CommandWhen to UseExample
list.jsUser asks "what agents do I have" or needs overviewbun bin/list.js
search.jsFind agents matching user intent (ALWAYS do this first)bun bin/search.js "code review security"
search-paged.jsPaged search for large registries (300+ agents)bun bin/search-paged.js "query" --page 1 --page-size 10
get.jsLoad a specific agent's full instructionsbun bin/get.js code-reviewer

Search First Pattern

  • Extract intent keywords from user request
  • Run search: bun bin/search.js ""
  • Review results: Check relevance scores (0.0-1.0)
  • Load if needed: bun bin/get.js
  • Execute: Follow the loaded agent's instructions

Example

User: "Can you review my authentication code for security issues?"

bash
# 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

Installation

Step 1: Install the Skill

Quick Install (Recommended):

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

# Discover skills interactively
npx skills find

# Update existing skills
npx skills update

Traditional Install:

bash
# User-level installation
./install.sh

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

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

What install.sh does:

  • Copies skill files to ~/.claude/skills/agent-registry/
  • Creates empty registry structure
  • Optionally installs dependencies via --install-deps (@clack/prompts for enhanced UI)

Step 2: Migrate Your Agents

Run the interactive migration script:

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

Interactive selection modes:

  • With @clack/prompts (default): Beautiful checkbox UI with category grouping, token indicators, and paging
  • Arrow keys navigate, Space toggle, Enter confirm
  • Visual indicators: [green] <1k tokens, [yellow] 1-3k, [red] >3k
  • Grouped by subdirectory
  • Fallback: Text-based number input
  • Enter comma-separated numbers (e.g., 1,3,5)
  • Type all to migrate everything
What init.js does:
  • Scans ~/.claude/agents/ and .claude/agents/ for agent files
  • Displays available agents with metadata
  • Lets you interactively select which to migrate
  • Copies selected agents to the registry by default (--move is explicit opt-in)
  • Builds search index (registry.json)

Dependencies

  • Bun (ships with Claude Code) — zero additional dependencies for core functionality
  • @clack/prompts: Optional enhanced interactive selection UI (install via ./install.sh --install-deps)

Registry Location

  • Global: ~/.claude/skills/agent-registry/
  • Project: .claude/skills/agent-registry/ (optional override)
Agents not migrated remain in their original locations and load normally (contributing to token overhead).

Installation

Terminal bash 

openclaw install agent-registry
Copied!

💻Code Examples

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

user-request--searchagentsintent--select-best-match--getagentname--execute-with-agent.txt
## Available Commands

| Command | When to Use | Example |
|---------|-------------|---------|
| `list.js` | User asks "what agents do I have" or needs overview | `bun bin/list.js` |
| `search.js` | Find agents matching user intent (ALWAYS do this first) | `bun bin/search.js "code review security"` |
| `search-paged.js` | Paged search for large registries (300+ agents) | `bun bin/search-paged.js "query" --page 1 --page-size 10` |
| `get.js` | Load a specific agent's full instructions | `bun bin/get.js code-reviewer` |

## Search First Pattern

1. **Extract intent keywords** from user request
2. **Run search**: `bun bin/search.js "<keywords>"`
3. **Review results**: Check relevance scores (0.0-1.0)
4. **Load if needed**: `bun bin/get.js <agent-name>`
5. **Execute**: Follow the loaded agent's instructions

## Example

User: "Can you review my authentication code for security issues?"

# Step 3: Follow loaded agent instructions for the task

-step-3-follow-loaded-agent-instructions-for-the-task.txt
## Installation

### Step 1: Install the Skill

**Quick Install (Recommended):**

./install.sh --install-deps

installsh---install-deps.txt
**What install.sh does:**
1. Copies skill files to `~/.claude/skills/agent-registry/`
2. Creates empty registry structure
3. Optionally installs dependencies via `--install-deps` (`@clack/prompts` for enhanced UI)

### Step 2: Migrate Your Agents

Run the interactive migration script:
example.sh
# 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
example.sh
# Using Skills CLI (recommended)
npx skills add MaTriXy/Agent-Registry@agent-registry

# Discover skills interactively
npx skills find

# Update existing skills
npx skills update
example.sh
# User-level installation
./install.sh

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

# Optional: install enhanced interactive UI dependency
./install.sh --install-deps
example.sh
cd ~/.claude/skills/agent-registry
bun bin/init.js
# Optional destructive mode:
bun bin/init.js --move

Tags

#ai_and-llms

Quick Info

Category Development
Model Claude 3.5
Complexity Multi-Agent
Author matrixy
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install agent-registry

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0