Back to Skills

create-subagents

Expert guidance for creating, building, and using Claude Code subagents and the Task tool. Use when working with subagents, setting up agent configurations, understanding how agents work, or using the Task tool to launch specialized agents.

1,297stars349forksUpdated 2/9/2026

Security Assessment

Safe(100/100)
Security Score100/100

About create-subagents

The 'create-subagents' skill provides expert guidance for creating, building, and managing Claude Code subagents, as well as utilizing the Task tool for orchestrating specialized workflows. It addresses the need for isolated, specialized agents capable of handling specific tasks autonomously without requiring direct user interaction. These subagents operate in a controlled context, allowing the main conversation to remain focused while delegating complex, context-heavy operations to subagents.

Key features of this skill include the ability to define subagents with unique configurations, such as their name, description, tools, and model. Users can write system prompts to instruct subagents on their responsibilities and configure specific tool access for each agent. Additionally, subagents can be utilized in multi-agent workflows using the Task tool, providing a seamless way to automate tasks like research, code generation, and analysis. The skill also allows for different agent scopes, such as project-level or user-level, with a clear hierarchy determining priority.

This skill is ideal for developers and teams seeking to automate specific processes and tasks in a controlled and efficient manner. Its target users include those working in environments that require highly specialized tasks to be performed autonomously, such as in code reviews, security analysis, or automated testing.

FAQ

How do I create a new subagent?

To create a new subagent, run the `/agents` command, select 'Create New Agent,' and then define the subagent's name, description, tools, and model. Write the system prompt to instruct the subagent on its role.

What are the limitations of subagents?

Subagents operate in isolated contexts and cannot interact with users. They cannot use tools that require user interaction, such as AskUserQuestion, or present options to the user. They also do not allow visibility into their intermediate steps.

Can I use custom tools with subagents?

Yes, you can specify a comma-separated list of tools for the subagent. If omitted, the subagent inherits all tools from the main conversation. You can also view available tools using the `/agents` interface.

Can subagents be used across different projects?

Subagents can be defined at both project-level and user-level. Project-level subagents override user-level ones when there are naming conflicts. User-level subagents are available across all projects.

Install create-subagents

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill