Find specialized agents by task and load only the relevant instructions when needed. The registry supports browsing available agents, searching by intent, and retrieving a selected agent's full guidance, helping reduce upfront context use.
MANDATORY agent discovery system for token-efficient agent loading. Claude MUST use this skill instead of loading agents directly from ~/.claude/agents/ or .claude/agents/. Provides lazy loading via search_agents and get_agent tools. Use when: (1) user task may benefit from specialized agent expertise, (2) user asks about available agents, (3) starting complex workflows that historically used agents. This skill reduces context window usage by ~95% compared to loading all agents upfront.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
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 |
|---|---|---|
list_agents.py | User asks "what agents do I have" or needs overview | python scripts/list_agents.py |
search_agents.py | Find agents matching user intent (ALWAYS do this first) | python scripts/search_agents.py "code review security" |
search_agents_paged.py | Paged search for large registries (300+ agents) | python scripts/search_agents_paged.py "query" --page 1 --page-size 10 |
get_agent.py | Load a specific agent's full instructions | python scripts/get_agent.py code-reviewer |
python scripts/search_agents.py "<keywords>"python scripts/get_agent.py <agent-name>User: "Can you review my authentication code for security issues?"
# Step 1: Search for relevant agents
python scripts/search_agents.py "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
python scripts/get_agent.py security-auditor
# Step 3: Follow loaded agent instructions for the task
Quick Install (Recommended):
# NPX with add-skill (recommended)
npx add-skill MaTriXy/Agent-Registry
# OR npm directly
npm install -g @claude-code/agent-registry
Traditional Install:
# User-level installation
./install.sh
# OR project-level installation
./install.sh --project
What install.sh does:
~/.claude/skills/agent-registry/questionary Python package (for interactive UI)pip3 not availableNote: All installation methods support Python-based migration and CLI tools
Run the interactive migration script:
cd ~/.claude/skills/agent-registry
python scripts/init_registry.py
Interactive selection modes:
With questionary (recommended): Checkbox UI with category grouping, token indicators, and paging
Without questionary (fallback): Text-based number input
1,3,5)all to migrate everythingWhat init_registry.py does:
~/.claude/agents/ and .claude/agents/ for agent filesregistry.json)The installer automatically installs questionary. If installation fails or pip3 is unavailable, the migration script falls back to text-based input mode.
Manual installation:
pip3 install questionary
~/.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 reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Set up and use the 1Password command-line tool `op` to sign in, verify account access, and work with vault data. The skill covers single or multiple accounts and shows how to run commands or fill templates with secrets while limiting exposure in logs and files.
Check live prices, price changes, and trading volume for Shanghai, Shenzhen, and Beijing stocks. Review intraday volume patterns and possible large-investor activity, and manage holdings with cost, quantity, and profit or loss summaries.
Scan HTML or JSX files and directories for accessibility issues such as missing image descriptions, form labels, and keyboard access problems. The skill identifies WCAG guideline failures and provides suggested code fixes alongside its findings.
Plan A/B tests that compare page or product changes, with clear hypotheses, sample sizes, success metrics, and traffic allocation. Get a structured test plan and guidance for interpreting results and deciding what to try next.
Turn LinkedIn profile URLs into coordinated account-based outreach. The workflow gathers profile details, enriches contacts with email and phone data, looks up mailing addresses, and prepares email, LinkedIn, and handwritten-letter touches with the specified services.
Work with Apple Calendar on macOS to list calendars, find and view events, and check busy time slots across calendars. Create, update, or delete events with details such as dates, locations, and descriptions.