subagent-creator

name

subagent-creator

description

Guide for creating AI subagents with isolated context for complex multi-step workflows. Use when users want to create a subagent, specialized agent, verifier, debugger, or orchestrator that requires isolated context and deep specialization. Works with any agent that supports subagent delegation. Triggers on "create subagent", "new agent", "specialized assistant", "create verifier". Do NOT use for Cursor-specific subagents (use cursor-subagent-creator instead).

Subagent Creator

This skill provides guidance for creating effective, agent-agnostic subagents.

What are Subagents?

Subagents are specialized assistants that an AI agent can delegate tasks to. Characteristics:

• Isolated context: Each subagent has its own context window
• Parallel execution: Multiple subagents can run simultaneously
• Specialization: Configured with specific prompts and expertise
• Reusable: Defined once, used in multiple contexts

When to Use Subagents vs Skills

Is the task complex with multiple steps?
├─ YES → Does it require isolated context?
│         ├─ YES → Use SUBAGENT
│         └─ NO → Use SKILL
│
└─ NO → Use SKILL

Use Subagents for:

• Complex workflows requiring isolated context
• Long-running tasks that benefit from specialization
• Verification and auditing (independent perspective)
• Parallel workstreams

Use Skills for:

• Quick, one-off actions
• Domain knowledge without context isolation
• Reusable procedures that don't need isolation

Subagent Structure

A subagent is typically a markdown file with frontmatter metadata:

---
name: agent-name
description: Description of when to use this subagent.
model: inherit # or fast, or specific model ID


You are an [expert in X].

When invoked:

 [Step 1]
 [Step 2]
 [Step 3]

[Detailed instructions about expected behavior]

Report [type of expected result]:

 [Output format]
 [Metrics or specific information]