claude-subagents

claude-subagents is a skill for Codex from jnopareboateng/codex-claude-subagents. It costs 57 tokens per session (2,740 once invoked), scanned A, original, MIT.

A guide for coordinating Claude CLI workers as resumable subagents, meaning separate AI workers assigned limited tasks. It records their runs in local files outside version control.

In plain words
What is it for?
Starting or resuming Claude workers with a task, prompt, optional write directory, session ID, model, and reasoning effort; and tracking their results in .agent-runs/claude/.
Why use it?
It organizes delegated work, limits where workers may write, and preserves logs so interrupted tasks can be resumed.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: mentions CLAUDE.md; mentions subagents; names the NotebookEdit tool.

Good fit Starting or resuming Claude workers with a task, prompt, optional write directory, session ID, model, and reasoning effort; and tracking their results in .agent-runs/claude/.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/jnopareboateng/codex-claude-subagents/claude-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 jnopareboateng/codex-claude-subagents --skill claude-subagents
Clone the repo
git clone --depth 1 https://github.com/jnopareboateng/codex-claude-subagents

Made for: 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 claude-subagents

README.md
[![agentmods](https://agentmods.dev/badge/skills/jnopareboateng/codex-claude-subagents/claude-subagents/github.svg)](https://agentmods.dev/skills/jnopareboateng/codex-claude-subagents/claude-subagents)
Your own site
<a href="https://agentmods.dev/skills/jnopareboateng/codex-claude-subagents/claude-subagents"><img src="https://agentmods.dev/badge/skills/jnopareboateng/codex-claude-subagents/claude-subagents/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for claude-subagents

Your own site · 80×15
<a href="https://agentmods.dev/skills/jnopareboateng/codex-claude-subagents/claude-subagents"><img src="https://agentmods.dev/badge/skills/jnopareboateng/codex-claude-subagents/claude-subagents.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 57 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,740 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.00057 $0.02740
Opus 5.5 $0.00023 $0.01096
Sonnet 5.5 $0.00011 $0.00548
Haiku 4.5 $0.00006 $0.00274

Measured 29d ago against content hash 58adc987f15e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

claude-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 29d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/csa.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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/claude-subagents/SKILL.md · 151 lines

How it starts

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

claude-subagents

Codex leads. A Claude worker does one bounded task non-interactively and returns a final message. scripts/csa.py (stdlib Python, WSL/Linux only) starts, supervises, reconciles and records every run. The worker never asks questions: anything not pre-approved is denied.

When to delegate

  • Cross-vendor review of Codex's own changes (a worker never approves its own output).
  • Bounded implementation in a scope disjoint from what Codex is editing.
  • Second opinion on a design, bug, or plan.
  • Not: native-app GUI checks (Codex Desktop computer use), anything needing a human approval mid-task, work that needs the web, or work that is faster to do inline. Keep those with Codex.

Invocation (exactly two forms)

WSL shell:

python3 ~/.codex/skills/claude-subagents/scripts/csa.py <verb> --cwd /home/<you>/projects/<repo> ...

Windows Codex Desktop (PowerShell):

wsl.exe -d Ubuntu-22.04 -e python3 /home/<you>/.codex/skills/claude-subagents/scripts/csa.py <verb> --cwd /home/<you>/projects/<repo> ...

-e runs no shell, so nothing is expanded: use absolute Linux paths, never ~ or $VAR. --cwd, --prompt and --schema also accept \\wsl.localhost\Ubuntu-22.04\... paths (one or two leading backslashes). Write each prompt as UTF-8 to <repo>/.agent-runs/prompts/<task>.md (git-ignored) and pass that path; --prompt - reads stdin (WSL shells). JSON output is ASCII-only. A --cwd on /mnt/<drive>/ or C:\ is refused unless --allow-windows-fs.

Verbs

Verb Use
start --task ID --prompt FILE|- [--mode review|write] [--scope REL]... [--allow-bash PREFIX]... [--worktree] [--schema FILE|none] [--browser] [--model M] [--effort E] [--max-turns N] [--budget-usd X] [--timeout-min M] [--detach] New task. ID matches ^[a-z0-9][a-z0-9-]{0,63}$; a used ID is refused (use resume or a new ID).
resume --task ID --prompt FILE|- [--allow-bash PREFIX]... [--browser] [--model M] [--effort E] [caps] [--detach] New attempt in the same Claude session (claude --resume). Terminal tasks only. --allow-bash/--browser are added for this and later attempts; each attempt records its own in run.json.
status [--task ID] [--wait SEC] [--json] Reconciles liveness, then reports. --wait long-polls and returns on the first transition, or at once if nothing is running.
result --task ID [--json] Final message and structured_output of the latest attempt.
cancel --task ID Only the attempt running when called: SIGINT to its process group, SIGTERM after 15 s, SIGKILL 10 s later; status cancelled.
list [--active] [--json] All tasks of the repo.
doctor Checks every flag and option value the launcher emits against the installed claude (no API calls; permission-rule strings are not validated).

Read the full file on GitHub · 151 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 29d ago Changed · -48 lines · +27 tokens per session 58adc987f15e
  2. 1mo ago Changed · +22 lines ed1b52d9725a
  3. 1mo ago Changed · +10 lines 22d757820c12
  4. 1mo ago Changed · +98 lines 42d124367a54
  5. 2mo ago First seen · 69 lines · 30 tokens per session scan A 9deb4c9b0c62

Subscribe to this mod's changes

claude-subagents is a skill published in the GitHub repository jnopareboateng/codex-claude-subagents (15 stars, last pushed 1mo ago), licensed MIT. It adds 57 tokens to every session and 2,740 once invoked, about $0.0002 per session on Opus 5.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

claude-subagents compared with skills from other repositories

claude-subagents next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
claude-subagentsjnopareboateng/codex-claude-subagentsSkill151mo agoMITA57Codex
skill-routerhussi9/skill-routerSkill312d agoMITA69Claude Code
psy-exp-reviewersoupandpsy/amazing-psycoder-skillsSkill382mo agoMITA112Codex
amazing-psycodersoupandpsy/amazing-psycoder-skillsSkill382mo agoMITA110Codex
psy-ana-designersoupandpsy/amazing-psycoder-skillsSkill382mo agoMITA105Codex
psy-exp-codersoupandpsy/amazing-psycoder-skillsSkill382mo agoMITA102Codex
psy-ana-codersoupandpsy/amazing-psycoder-skillsSkill382mo agoMITA94Codex