Agent Registry
MANDATORY agent discovery system for token-efficient agent loading. Claude MUST use this skill instead of loading agents directly from ~/.claude/agents/ or ....
MANDATORY agent discovery system for token-efficient agent loading. Claude MUST use this skill instead of loading agents directly from ~/.claude/agents/ or ....
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Lazy-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 |
|---|---|---|
| User asks "what agents do I have" or needs overview | |
| Find agents matching user intent (ALWAYS do this first) | |
| Paged search for large registries (300+ agents) | |
| Load a specific agent's full instructions | |
bun bin/search.js "<keywords>"bun bin/get.js <agent-name>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 task
Quick Install (Recommended):
# Using Skills CLI (recommended) npx skills add MaTriXy/Agent-Registry@agent-registryDiscover skills interactively
npx skills find
Update existing skills
npx skills update
Traditional Install:
# User-level installation ./install.shOR project-level installation
./install.sh --project
Optional: install enhanced interactive UI dependency
./install.sh --install-deps
What 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 --move
Interactive selection modes:
With @clack/prompts (default): Beautiful checkbox UI with category grouping, token indicators, and paging
Fallback: Text-based number input
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).
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.