By name: agent-discovery description: Discovers all Claude Code agents in the system including built-in, plugin, project, and user-level agents. Use when you need to find which agents are available, understand the agent ecosystem, or prepare agents for Actoris registration. allowed-tools: Read, Glob, Grep, Bash
Agent Discovery Skill
Use this skill to discover and catalog all Claude Code agents.
What You Can Find
Built-in Agents (Always Available)
| Agent | Model | Purpose |
|---|---|---|
| Explore | haiku | Fast codebase exploration |
| Plan | sonnet | Implementation planning |
| general-purpose | sonnet | Complex multi-step tasks |
| claude-code-guide | sonnet | Claude Code documentation |
| statusline-setup | haiku | Status line configuration |
Custom Agent Locations
- Project Agents:
.claude/agents/*.md - User Agents:
~/.claude/agents/*.md - Plugin Agents:
{plugin-root}/agents/*.md
Agent File Format
Custom agents are Markdown files with YAML frontmatter:
---
name: my-agent
description: What this agent does and when to use it
tools: Read, Write, Bash # Comma-separated
model: sonnet # sonnet, opus, haiku, or inherit
skills: skill1, skill2 # Optional
---
# Agent Instructions
Your agent prompt goes here...
Discovery Commands
Find Project Agents
ls -la .claude/agents/*.md 2>/dev/null
Find User Agents
ls -la ~/.claude/agents/*.md 2>/dev/null
Parse Agent Metadata
grep -A 5 "^---" .claude/agents/my-agent.md | head -10
MCP Integration
Use the Actoris MCP tool for structured discovery:
list_claude_code_agents(source="all", detailed=true)
Returns JSON with:
- Total agent count by source
- Agent name, description, tools, model
- File path for custom agents
After Discovery
Once agents are discovered, they can be:
- Registered with Actoris via
register_agent_with_actoris - Monitored for trust scores
- Tracked in the Darwinian leaderboard
- Included in AGDP calculations