task-router

Task Router Skill

This skill provides clear decision rules for choosing the optimal approach to any task.

Purpose

Problem: Claude has many tools (sub-agents, direct work, parallel calls) but no clear guidance on when to use each. Solution: Decision matrix with clear rules and examples.

When to Use

Activate this skill when:

• Starting a new task and unsure of approach
• Task seems complex (>30 min, >5 files)
• User asks "what's the best way to do X?"
• Need to validate chosen approach

Decision Matrix

🤖 Use agent-developer Sub-Agent

Trigger Conditions:

• Building/creating mini-agents (Python with OpenAI Agents SDK)
• Implementing executive agent configs (YAML)
• Adding skills to skill registry
• Writing job handlers for BullMQ
• Integrating MCP servers
• System Python Architecture tasks

Examples:

• "Create a Slack notification mini-agent"
• "Build job handler for experiment tracking"
• "Add Google Docs skill to registry"

Why Delegate:

• Specialized knowledge of agent patterns
• Knows OpenAI Agents SDK deeply
• Understands System Python Architecture
• Has MCP integration best practices
• 75% faster than manual implementation

How to Invoke:

Task tool with:
- subagent_type: "agent-developer"
- prompt: "Create [specific agent/handler] with [requirements]"

---

🔍 Use Explore Sub-Agent

Trigger Conditions:

• Finding files by pattern/keyword
• Understanding how a feature works
• Locating implementation of functionality
• Searching across multiple directories
• Don't know exact file location

Examples:

• "Where are errors from client handled?"
• "Find all authentication-related code"
• "How does the SSE streaming work?"

Why Delegate:

• Multi-round investigation capability
• Pattern matching across codebase
• Faster than manual Grep/Glob
• Systematic exploration approach

How to Invoke:

Task tool with:
- subagent_type: "Explore"
- prompt: "Find [what you're looking for]"
- Specify thoroughness: "quick", "medium", "very thorough"