Agent skill · software engineering · sundial-org
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 .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.
Why this skill is useful
Adds executable scripts for agent discovery and lazy loading that enhance the AI's capability to manage agents efficiently.
What it needs
Requires python, questionary installed locally. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
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 Available Commands Command When to Use Example --------- ------------- --------- listagents.py User asks "what agents do I have" or needs overview python scripts/listagents.py searchagents.py Find agents matching user intent (ALWAYS do this first) python scripts/searchagents.py "code review security" searchagentspaged.py Paged search for large registries (300+ agents) python scripts/searchagentspaged.py "query" --page 1 --page-size 10 getagent.py Load a specific agent's full instructions python scripts/getagent.py code-reviewer Search First Pattern 1. Extract intent keywords from user request 2. Run search: python scripts/searchagents.py "<keywords>" 3. Review results: Check relevance scores (0.0-1.0) 4. Load if needed: python scripts/getagent.py <agent-name> 5. Execute: Follow the loaded agent's instructions Example User: "Can you review my authentication code for security issues?" Installation Step 1: Install the Skill Quick Install (Recommended): Traditional Install: What install.sh does: 1. ✓ Copies skill files to ~/.claude/skills/agent-registry/ 2. ✓ Creates empty registry structure 3. ✓ Automatically installs questionary Python package (for interactive UI) 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/agent-registry