Back to Skills

create-subagent

Guide for creating specialized Claude Code subagents with proper YAML frontmatter, focused descriptions, system prompts, and tool configurations. Use when the user wants to create a new subagent, custom agent, specialized AI assistant, or mentions creating/designing/building agents or subagents.

16starsUpdated 3/19/2026

Security Assessment

Safe(100/100)
Security Score100/100

About create-subagent

The 'create-subagent' skill provides a comprehensive guide for creating specialized Claude Code subagents that are tailored to handle specific tasks, domains, and expertise areas. It solves the challenge of designing AI assistants that operate with their own context windows and tool configurations, ensuring that each subagent is focused on particular needs. By following this skill, users can build subagents that align with best practices, enhancing the functionality and productivity of AI systems within a project or workflow.

FAQ

What is the purpose of the 'create-subagent' skill?

The skill helps users create specialized Claude Code subagents with tailored YAML configurations, system prompts, and tool access for specific tasks or domains.

Where should I save the subagent file?

Subagent files can be saved at project-level, user-level, or plugin-level. Project-level files take precedence, while user-level is for personal agents and plugin-level is used for distributing agents with plugins.

What models can be selected for the subagent?

The subagent can use one of the following models: Haiku (fast/cheap), Sonnet (balanced), Opus (advanced reasoning), or inherit the model from the main thread.

Are there any requirements for the description field?

Yes, descriptions should be specific and include 'Use PROACTIVELY' or 'MUST BE USED' for automatic delegation. Descriptions should clearly define the subagent's expertise and when to use it.

Install create-subagent

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