subagent-best-practices

Enforce subagent delegation best practices and provider selection in AI workflows.

Updated Dec 15, 2025
One-click install
npx skills add https://github.com/OpenSourceSam/v2_heras_garden --skill subagent-best-practices-opensourcesam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-best-practices
Source: https://github.com/OpenSourceSam/v2_heras_garden/tree/main/.claude/skills/subagent-best-practices
Command: npx skills add https://github.com/OpenSourceSam/v2_heras_garden --skill subagent-best-practices-opensourcesam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents costly mistakes and inefficiencies by enforcing best practices for using subagents, the Task tool, and parallel execution, especially when dealing with Claude models.

Core Features & Use Cases

  • Subagent Model Enforcement: Automatically flags and prevents the use of forbidden Claude models (Haiku, Sonnet, Opus) as subagents, recommending allowed alternatives.
  • Two-Tier Architecture Guidance: Reinforces the recommended orchestrator (Claude) and worker (subagent) roles.
  • Provider Selection: Guides the choice of the most suitable subagent provider (Kimi K2.5, GLM, MiniMax) based on task type.
  • Prompt Templating: Provides a standardized template for subagent prompts.
  • Parallel & Background Execution: Advises on efficient parallel task execution and the "fire-and-retrieve" pattern for background tasks to save tokens.

Quick Start

Use the subagent-best-practices skill to ensure all subagent calls avoid Claude models and use the recommended providers.

Frequently Asked Questions about subagent-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize subagent delegation to prevent high token costs?

Optimizing subagent delegation requires enforcing a two-tier architecture where Claude acts as the orchestrator and cost-effective providers like Kimi K2.5, GLM, or MiniMax function as workers. This structure prevents inefficient token usage and reduces operational overhead.

Why should I avoid using Claude models as subagents in parallel execution?

Avoiding Claude models like Haiku, Sonnet, and Opus as subagents prevents high execution costs and enforces the recommended two-tier architecture. Using allowed alternative providers such as Kimi K2.5 or GLM ensures efficient parallel task execution without sacrificing workflow quality.

What is the best way to select a provider for AI agent delegation tasks?

Selecting a provider for AI agent delegation involves matching the task type to recommended models like Kimi K2.5, GLM, or MiniMax. This guidance ensures optimal provider selection while maintaining the orchestrator and worker roles within the two-tier architecture.

How do I implement background task suspension and parallel execution in agent workflows?

Implementing background task suspension and parallel execution involves using a fire-and-retrieve pattern for subagent calls. This approach allows the orchestrator to dispatch multiple tasks simultaneously, saving tokens by retrieving results only when background processing completes.

Do I need a standardized prompt template for subagent calls?

A standardized prompt template is provided to structure subagent calls effectively. Using this template ensures clear communication between the orchestrator and worker agents, maintaining consistency across parallel execution and background task delegation workflows.