What is a Claude Code subagent?

A subagent is a specialized, independent instance of Claude Code launched by a parent agent to execute a specific, well-defined task in an isolated environment with its own context window.

Does the subagent track token usage?

Yes, the skill includes mandatory token measurement logic that tracks cumulative usage across the subagent session and reports it back to the parent agent via .completion.json.

How does this skill manage subagent output?

Subagents run unsupervised; all instructions provided by the main agent must be mechanical and include fail-fast conditions to report status back to the parent agent upon completion or blockage.

Can subagents make architectural decisions?

No, the skill enforces a 'Zero Decision Delegation' policy. All architectural choices and ambiguities must be resolved by the main agent before the subagent is spawned.

Why are git worktrees used for subagents?

Git worktrees provide an isolated filesystem environment, allowing subagents to modify code and run tests without interfering with the parent agent's current workspace or file state.

Subagent Spawner

Name: Subagent Spawner
Author: cowwoc

bycowwoc

•

Productividad y Flujo de Trabajo

Orchestrates autonomous Claude Code subagents in isolated git worktrees for concurrent, mechanical task execution.

The spawn-subagent skill enables complex task delegation by launching independent Claude Code instances in isolated git worktrees. This allows a parent agent to maintain high-level coordination while subagents handle specific, well-defined implementation or planning tasks. It features robust token tracking, fail-fast mechanics, and strict state management to ensure subagents operate reliably without real-time user supervision. By isolating execution, it prevents context window bloat and allows for parallel development workflows.

Características Principales

01Strict token tracking and measurement across subagent sessions

02Two-stage planning subagents for maximum token efficiency

03Isolated Git worktrees for concurrent and sandboxed task execution

04Mandatory fail-fast conditions to prevent autonomous error loops

05Automatic project hook inheritance for consistent rule enforcement

062 GitHub stars

Casos de Uso

01Offloading time-intensive implementation tasks to subagents while the main agent handles coordination

02Performing routine code updates and refactors in a sandboxed environment to preserve main context

03Executing multi-stage planning where subagents generate and refine detailed technical specs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cowwoc/claude-code-cat spawn-subagent

For use in Claude.ai and ChatGPT

Download Skill