create-or-audit-subagent

What problem does it solve?

This Skill eliminates the risk of cluttering the .claude/agents directory with generic subagents that duplicate Claude's built-in capabilities or lack project-specific knowledge. It ensures every custom agent is justified, properly scoped, and grounded in the actual architecture and patterns of the codebase.

Core Features & Use Cases

• Build New Subagents: Guides engineers through validating the need for isolation, investigating codebase-specific patterns, and writing a system prompt that teaches the agent about real file paths, helper functions, and project conventions.
• Audit Existing Subagents: Runs a comprehensive quality gate including specificity tests, overlap checks with built-in agents, tool scoping validation, and token budget analysis to identify redundant or misconfigured agents.
• Use Case: Imagine your team has accumulated a dozen custom agents, many of which are generic code reviewers or debuggers that add no value. Use this Skill to audit the directory, remove redundant agents, and ensure remaining agents have minimal tool access and proper configuration.

Quick Start

Use the create-or-audit-subagent skill to audit all subagents in the .claude/agents directory and generate a report recommending which agents to keep, revise, or remove.