pi-subagents

Delegate tasks to builtin or custom subagents with single, chain, parallel, and intercom-coordinated workflows.

10|1|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/catalystctl/catcode --skill pi-subagents-catalystctl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pi-subagents
Source: https://github.com/catalystctl/catcode/tree/main/.catalyst-code/skills/pi-subagents
Command: npx skills add https://github.com/catalystctl/catcode --skill pi-subagents-catalystctl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Complex coding tasks often exceed what a single agent context can handle well, requiring focused delegation for recon, planning, implementation, and review without losing orchestrator control. ## Core Features & Use Cases - Builtin agent roster: Delegate to scout, researcher, planner, worker, reviewer, context-builder, oracle, or delegate agents, each with a focused role and tool allowlist. - Flexible execution modes: Run single agents, forked-context continuations, parallel task batches with concurrency limits, or sequential chains where each step receives the previous output. - Intercom coordination: Subagents can ask the orchestrator blocking questions via contact_supervisor and message peer subagents via intercom for collaborative decisions. - Monitoring and steering: Inspect running subagents with peek, redirect them mid-run with steer, and interrupt or resume runs as needed. - Use Case: Dispatch a scout to gather context on an unfamiliar module, chain it into a planner for an implementation plan, then hand off to a worker while a reviewer runs adversarial review in parallel. ## Quick Start Use the subagent tool to run a scout agent that gathers context on the authentication module, then chain a planner and worker to implement the refactor.

Frequently Asked Questions about pi-subagents

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

FAQPage Schema
How do I delegate a coding task to a subagent?

Call the subagent tool with an agent name and task, such as { agent: "worker", task: "refactor auth" }. You can also run parallel task arrays with a concurrency limit or sequential chains where each step receives the previous output.

What builtin subagents are available for code review and planning?

The builtin roster includes scout for codebase recon, planner for implementation plans, worker for writing code, reviewer for adversarial review, and oracle for second opinions. Use list and get actions to discover and inspect agents.

Can subagents ask me questions while running?

Yes, when intercom is enabled a subagent can call contact_supervisor with a need_decision reason, which blocks until you reply via the TUI prompt or intercom_reply. Subagents can also message peer subagents with the intercom tool.

How do I monitor or redirect a running subagent?

Use the peek action to inspect a run's conversation state, recent turns, and pending asks. Use steer to inject a directional message the subagent picks up on its next turn, or interrupt to stop the run entirely.

Can subagents spawn their own subagents?

Only if their tool allowlist includes the subagent tool and the depth cap permits it. By default children do not fan out further, keeping the orchestrator in control of delegation.