agent-audit

Cross-reference agent usage data with definitions to classify and report unused agents.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/leejaedus/pepcode --skill agent-audit-leejaedus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-audit
Source: https://github.com/leejaedus/pepcode/tree/main/skills/agent-audit
Command: npx skills add https://github.com/leejaedus/pepcode --skill agent-audit-leejaedus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

agent-audit analyzes cumulative agent usage data to identify unused, rarely-used, and deprecated agents, generating a usage report and recommending cleanup actions to reduce agent catalog bloat.

Core Features & Use Cases

  • Cross-reference usage data with the registered agent definitions to classify agents into tiers (heavy, moderate, light, unused, deprecated).
  • Generate a structured report with columns: Agent, Calls, Last Used, Avg Duration, Model, Status.
  • Present findings to the user and suggest safe cleanup actions, requiring explicit confirmation before any removal.

Quick Start

Run the agent audit to generate a usage report and identify cleanup candidates.

Frequently Asked Questions about agent-audit

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

FAQPage Schema
How do I identify unused agents in my catalog?

The agent audit works by cross-referencing cumulative usage data with registered agent definitions, classifying agents into tiers like heavy, moderate, light, unused, or deprecated to produce a structured usage report.

What's the best way to clean up deprecated agents without breaking core functionality?

The best way to clean up deprecated agents safely is to run an audit that classifies agents into tiers and suggests safe removal actions, requiring explicit confirmation before pruning any unused agents or deprecated stubs.

Do I need a specific analytics file to generate an agent usage report?

Yes, the agent audit requires reading the ~/.claude/analytics/agent-usage.json file and src/agents/definitions.ts to cross-reference usage data with registered agent definitions for classification.

Can I reduce agent catalog bloat by tracking agent usage data?

Yes, you can reduce agent catalog bloat by tracking usage data to identify unused and rarely-used agents, generating a report with columns like Calls, Last Used, and Status to recommend targeted cleanup actions.

What columns are included in an agent usage report?

An agent usage report includes the columns Agent, Calls, Last Used, Avg Duration, Model, and Status, providing a structured view to assess agent activity and identify cleanup candidates.

Does the agent audit automatically remove unused agents from the catalog?

No, the agent audit presents findings and suggests cleanup actions but requires explicit user confirmation before removing any unused agents, ensuring core functionality and deprecated stubs are preserved.