pi-subagents

pi-subagents is a skill for Claude Code, Codex from ethanolivertroy/my-agent-stuff. It costs 68 tokens per session (10,019 once invoked), scanned A, original, MIT.

A coordination tool for delegating coding and review work to specialized helper agents. It supports individual, chained, parallel, background, and coordinated workflows.

In plain words
What is it for?
Use it for code reviews, planning, implementation handoffs, parallel investigation, long-running tasks, and creating or adjusting helper agents and workflows.
Why use it?
It helps divide complex work, gather independent reviews, and keep one main agent responsible for combining results and approving changes.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions subagents; mentions Codex.

Good fit Use it for code reviews, planning, implementation handoffs, parallel investigation, long-running tasks, and creating or adjusting helper agents and workflows.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/ethanolivertroy/my-agent-stuff/pi-subagents
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add ethanolivertroy/my-agent-stuff --skill pi-subagents
Clone the repo
git clone --depth 1 https://github.com/ethanolivertroy/my-agent-stuff

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for pi-subagents

README.md
[![agentmods](https://agentmods.dev/badge/skills/ethanolivertroy/my-agent-stuff/pi-subagents.svg)](https://agentmods.dev/skills/ethanolivertroy/my-agent-stuff/pi-subagents)
Your own site
<a href="https://agentmods.dev/skills/ethanolivertroy/my-agent-stuff/pi-subagents"><img src="https://agentmods.dev/badge/skills/ethanolivertroy/my-agent-stuff/pi-subagents.svg" alt="Measured on agentmods" height="20"></a>
Per session 68 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 10,019 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00068 $0.10019
Opus 5 $0.00034 $0.05010
Sonnet 5 $0.00014 $0.02004
Haiku 4.5 $0.00007 $0.01002

Measured 8d ago against content hash 07f10d115a50, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

pi-subagents scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/pi-subagents/SKILL.md · 778 lines

How it starts

The opening of the file, as written. The whole thing — 778 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Pi Subagents

This skill is for the main parent orchestrator only. Do not inject or follow it inside spawned child subagents. The parent session owns delegation, orchestration, review fanout, and final fix-worker launches; child subagents should receive concrete role-specific tasks and should not run their own subagent workflows.

Use this skill when the parent orchestrator needs to launch a specialized subagent, compose multiple agents into a workflow, or create/edit agents and chains on demand.

When to Use

  • Advisory review: use fresh-context reviewer agents for adversarial code review, or fork to oracle when inherited decisions and drift matter
  • Implementation handoff: have oracle advise, then worker implement only after an approved direction
  • Recon and planning: use scout or context-builder, then planner
  • Parallel exploration: run multiple non-conflicting tasks concurrently
  • Long-running work: launch async/background runs and inspect them later
  • Subagent control: watch needs-attention signals and soft-interrupt only when a delegated run is genuinely blocked
  • Agent authoring: create, update, or override agents and chains for a project

Tool vs Slash Commands

Agents can use the subagent(...) tool directly for execution, management, status, and control. Humans often use the slash-command layer instead:

  • /run — launch a single agent
  • /chain — launch a chain of steps
  • /parallel — launch top-level parallel tasks
  • /run-chain — launch a saved .chain.md workflow
  • /subagents-doctor — diagnose setup, discovery, async paths, and intercom bridge state

Prefer the tool when you are writing agent logic. Prefer the slash commands when you are guiding a human through an interactive flow.

Packaged prompt shortcuts are also available for repeatable workflows. Treat them as reusable orchestration recipes, not just human slash commands. When the user asks for one of these shapes, or when the workflow clearly fits, apply the same pattern directly with subagent(...) and other tools:

  • /parallel-review — fresh-context reviewers with distinct review angles, then synthesis
  • /review-loop — parent-orchestrated worker, fresh-reviewer, and fix-worker cycles until clean or capped
  • /parallel-research — combine researcher and scout for external evidence plus local code context
  • /parallel-context-build — parallel context-builder passes that produce planning handoff context and meta-prompts
  • /parallel-handoff-plan — external-reference research plus local context-builder passes, followed by a synthesis handoff plan and implementation-ready meta-prompt
  • /gather-context-and-clarify — scout/research first, then ask the user clarifying questions with interview
  • /parallel-cleanup — two fresh-context reviewers (deslop + verbosity passes) for an adversarial cleanup review of the current diff

Read the full file on GitHub · 778 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 778 lines · 68 tokens per session scan A 07f10d115a50

Subscribe to this mod's changes

pi-subagents is a skill published in the GitHub repository ethanolivertroy/my-agent-stuff (11 stars, last pushed 2mo ago), licensed MIT. It adds 68 tokens to every session and 10,019 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

duckduckgo-search

Free keyless web, news, and image search via ddgs.

NousResearch/hermes-agent · 19 tokens

mcporter

List, auth, and call MCP servers/tools from the terminal.

NousResearch/hermes-agent · 16 tokens

mem0-oss-to-platform

Plan and then execute a migration of a project from the mem0 open-source / self-hosted SDK (the local Memory class) to the mem0 Platform / hosted / managed SDK (the MemoryClient class). Use this whenever a developer wants to move, switch, or migrate their mem0 usage off OSS/self-hosted to the hosted API — e.g.…

mem0ai/mem0 · 273 tokens

deploy-docker-compose

Run the Omnigent server as a Docker compose stack (server + Postgres) on any Docker host — your laptop, a VPS, EC2 by hand, or as the base layer of any container-platform deploy. Invoke when the user wants to build the image, bring up the compose stack, debug the stack on a host they already have, or extend the stack…

omnigent-ai/omnigent · 84 tokens

mapping-to-snomed

Maps clinical concept spans extracted by OpenMed to SNOMED CT concepts through a USER-SUPPLIED terminology server (the user's own Ontoserver, Snowstorm, or UMLS/UTS), never a bundled vocabulary. Use when the user wants to code findings, disorders, procedures, body structures, or substances to SNOMED CT, run an ECL…

maziyarpanahi/openmed · 205 tokens

auditing-subgroup-fairness

Audit an OpenMed NER or de-identification model for performance disparities across demographic subgroups (sex, age band, race/ethnicity when available) using openmed.eval.fairnessreport. Use when the user wants per-subgroup recall and leakage, wants to check whether de-identification under-protects a group, wants to…

maziyarpanahi/openmed · 148 tokens