agent-registryMANDATORY agent discovery system for token-efficient agent loading. Claude MUST use this skill instead of loading agents directly from ~/.claude/agents/ or ....
Install via ClawdBot CLI:
clawdbot install MaTriXy/agent-registryLazy-loading system for Claude Code agents. Eliminates the "~16k tokens" warning by loading agents on-demand.
NEVER assume agents are pre-loaded. Always use this registry to discover and load agents.
User Request ā search_agents(intent) ā select best match ā get_agent(name) ā execute with agent| 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 |
bun bin/search.js "" bun bin/get.js User: "Can you review my authentication code for security issues?"
# 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 taskQuick Install (Recommended):
# Using Skills CLI (recommended)
npx skills add MaTriXy/Agent-Registry@agent-registry
# Discover skills interactively
npx skills find
# Update existing skills
npx skills updateTraditional Install:
# User-level installation
./install.sh
# OR project-level installation
./install.sh --project
# Optional: install enhanced interactive UI dependency
./install.sh --install-depsWhat install.sh does:
~/.claude/skills/agent-registry/--install-deps (@clack/prompts for enhanced UI)Run the interactive migration script:
cd ~/.claude/skills/agent-registry
bun bin/init.js
# Optional destructive mode:
bun bin/init.js --moveInteractive selection modes:
1,3,5)all to migrate everythingWhat init.js does:
~/.claude/agents/ and .claude/agents/ for agent files--move is explicit opt-in)registry.json)./install.sh --install-deps)~/.claude/skills/agent-registry/.claude/skills/agent-registry/ (optional override)Agents not migrated remain in their original locations and load normally (contributing to token overhead).
Generated Mar 1, 2026
A development team needs to review pull requests for security vulnerabilities and best practices. The agent registry allows lazy-loading specialized agents like security-auditor or code-reviewer based on the code's domain, reducing token overhead by 95% compared to loading all agents upfront. This ensures efficient, on-demand expertise for tasks such as authentication code audits.
A customer service platform uses AI agents to handle diverse inquiries, from billing issues to technical troubleshooting. The registry enables searching for agents matching specific intents, such as 'billing dispute' or 'network error', and loading only the relevant agent to provide accurate, token-efficient responses without pre-loading all agents.
A healthcare organization employs AI agents to analyze patient data for insights like disease prediction or treatment recommendations. Using the registry, analysts can search for agents specialized in areas like 'clinical trial matching' or 'symptom checker', loading them on-demand to maintain compliance and reduce computational overhead in sensitive environments.
A financial institution monitors transactions for fraud and regulatory compliance. The registry allows lazy-loading agents such as 'fraud-detector' or 'aml-auditor' based on transaction patterns, enabling efficient, real-time analysis without the token cost of pre-loading all compliance agents, crucial for high-volume data processing.
An e-learning platform personalizes lessons for students based on their learning styles and subjects. Instructors use the registry to search for agents like 'math-tutor' or 'language-helper', loading them only when needed to provide tailored assistance, optimizing resource usage in dynamic educational workflows.
Offer the agent registry as a cloud-based service with tiered subscriptions based on usage, such as number of agents or search queries. This model generates recurring revenue by providing enterprises with scalable, token-efficient AI agent management, including premium features like enhanced UI and analytics.
Provide professional services to help organizations migrate their existing agents to the registry and customize workflows. Revenue comes from one-time project fees or ongoing support contracts, targeting businesses needing tailored solutions for complex AI agent deployments in industries like finance or healthcare.
Release the core registry as open-source software to build a community, then monetize through premium add-ons like advanced search algorithms, enterprise support, or proprietary agents. This model drives adoption while generating revenue from upsells to larger organizations requiring enhanced functionality.
š¬ Integration Tip
Always use the search tool first to find relevant agents based on user intent keywords, then load only the best match to minimize token usage and follow the agent's instructions for execution.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection