Claude-skill-registry agent-discovery

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.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/agent-discovery" ~/.claude/skills/majiayu000-claude-skill-registry-agent-discovery && rm -rf "$T"

manifest: skills/data/agent-discovery/SKILL.md

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