Subagent System
Create and manage specialized Claude Code subagents for task-specific workflows. Use when delegating work to specialized agents, configuring agent permissions, or understanding subagent architecture and best practices.
Security Assessment
About Subagent System
The Subagent System in Claude Code allows you to create and manage specialized AI agents, known as subagents, that handle specific tasks within a project or across multiple projects. These subagents are designed to delegate work to agents with specialized knowledge, ensuring more efficient task execution and context preservation. Each subagent is a pre-configured AI personality with a distinct set of capabilities, which helps in maintaining focus within the main conversation by operating in its own context window. This system allows you to configure agents with specific tools, define clear responsibilities, and manage permissions across various tasks or projects.
FAQ
How do I create a subagent?
Subagents are created by writing a Markdown file with YAML frontmatter in either the `.claude/agents/` or `~/.claude/agents/` directories. The file includes details such as the subagent's name, description, tools, and model.
Can subagents be used across different projects?
Yes, subagents can be project-specific or user-specific. Project-level subagents are stored in `.claude/agents/` and are specific to the current project, while user-level subagents are stored in `~/.claude/agents/` and can be shared across all projects.
Can I manage subagents without the command menu?
Yes, subagents can be managed manually by editing the corresponding Markdown files directly. However, using the `/agents` command is recommended for an interactive management experience.
What happens if multiple subagents have the same name?
Project-level subagents take precedence over user-level subagents when names conflict.
Are there any limitations regarding tool access?
Yes, you can limit each subagent's tool access by specifying the tools in the YAML frontmatter. If no tools are specified, the subagent inherits all available tools.
Install Subagent System
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
CaptainCrouton89/.claude