list-agents

Enumerate custom agents under .claude/agents/custom and aggregate metadata.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ste-bah/archon --skill list-agents-ste-bah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: list-agents
Source: https://github.com/ste-bah/archon/tree/main/.claude/agents/.claude/skills/list-agents
Command: npx skills add https://github.com/ste-bah/archon --skill list-agents-ste-bah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams quickly identify and audit their custom agents by presenting creation dates, last used timestamps, and invocation counts in a single view.

Core Features & Use Cases

  • Enumerates all custom agents under .claude/agents/custom, excluding templates like _template and _behavior_schema.
  • Reads meta.json when available to surface agent metadata, or falls back to filesystem data when meta.json is missing.
  • Indicates archive status when --all is used and supports filtering or highlighting invalid agents.

Quick Start

List all custom agents with their basic metadata.

Frequently Asked Questions about list-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list custom agents and their metadata in Claude?

To list custom agents, this tool enumerates every agent under the .claude/agents/custom directory and aggregates metadata like creation date, last used timestamp, and invocation counts into a single view.

How do I audit custom agent usage and invocation counts?

You can audit custom agent usage by running a listing command that parses meta.json files to surface creation dates, last used timestamps, and invocation counts for maintenance and onboarding workflows.

Can I include archived agents when listing custom agent metadata?

Yes, you can include archived agents by using the --all flag, which extends the enumeration to show archive status alongside the standard metadata for all custom agents.

What happens if metadata is missing for a custom agent?

When metadata is missing, the tool falls back to reading filesystem data and the first lines of agent.md for summaries, explicitly marking the agent as invalid in the output.

Does the agent listing tool exclude template files?

Yes, the enumeration automatically excludes template files such as _template and _behavior_schema, ensuring only active custom agents are listed in the audit output.

What is the best way to onboard new team members to existing custom agents?

The best way to onboard members is to generate a custom agent audit that lists all available agents with their summaries, creation dates, and last used timestamps for a quick overview.