Central authority for Claude Code subagents (sub-agents). Covers agent file format, YAML frontmatter, tool access configuration, model selection (inherit, sonnet, haiku, opus), automatic delegation, agent lifecycle, resumption, command-line usage (/agents), Agent SDK programmatic agents, priority resolution, and built-in agents (Plan subagent). Assists with creating agents, configuring agent tools, understanding agent behavior, and troubleshooting agent issues. Delegates 100% to docs-management skill for official documentation.
View on GitHubmelodic-software/claude-code-plugins
claude-ecosystem
plugins/claude-ecosystem/skills/subagent-development/SKILL.md
January 21, 2026
Select agents to install to:
npx add-skill https://github.com/melodic-software/claude-code-plugins/blob/main/plugins/claude-ecosystem/skills/subagent-development/SKILL.md -a claude-code --skill subagent-developmentInstallation paths:
.claude/skills/subagent-development/# Subagents Meta Skill > ## 🚨 MANDATORY: Invoke docs-management First > > **STOP - Before providing ANY response about subagents/agents:** > > 1. **INVOKE** `docs-management` skill > 2. **QUERY** for the user's specific topic > 3. **BASE** all responses EXCLUSIVELY on official documentation loaded > > **Skipping this step results in outdated or incorrect information.** > > ### Verification Checkpoint > > Before responding, verify: > > - [ ] Did I invoke docs-management skill? > - [ ] Did official documentation load? > - [ ] Is my response based EXCLUSIVELY on official docs? > > If ANY checkbox is unchecked, STOP and invoke docs-management first. ## Overview Central authority for Claude Code subagents (also called sub-agents). This skill uses **100% delegation to docs-management** - it contains NO duplicated official documentation. **Architecture:** Pure delegation with keyword registry. All official documentation is accessed via docs-management skill queries. ## When to Use This Skill **Keywords:** subagents, sub-agents, agents, agent file, agent YAML, agent frontmatter, agent tools, agent model, automatic delegation, agent lifecycle, agent resumption, /agents command, programmatic agents, agent SDK, built-in agents, Plan subagent, agent configuration **Use this skill when:** - Creating new agent definition files - Configuring agent tool access - Selecting agent models (inherit, sonnet, haiku, opus) - Understanding automatic vs explicit agent invocation - Working with agent resumption and lifecycle - Using the /agents CLI command - Integrating agents with Agent SDK - Understanding priority resolution (project > CLI > user) - Working with built-in agents (Plan subagent) - Troubleshooting agent behavior ## Keyword Registry for docs-management Queries Use these keywords when querying docs-management skill for official documentation: ### Core Concepts | Topic | Keywords | | --- | --- | | Overview | "subagents", "sub-agents", "agent overview" | | File Format