Agent skill

Subagent Orchestrator

by sickn33 in sickn33/agentic-awesome-skills

Coordinate quota-aware parallel subagents for large, multi-file Antigravity tasks.

MITAuto-check passedAgent Workflows

Install Subagent Orchestrator

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill subagent-orchestrator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills subagent-orchestrator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/subagent-orchestrator .claude/skills/subagent-orchestrator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
subagent-orchestrator
GitHub stars
47k
Used in
1 other repo
Token cost
~1.6k tokens
SKILL.md length
602 words
Files
8 (incl. scripts)
Skills in repo
1,493
Repo updated
First seen
Licence
MIT

At a glance

Coordinate quota-aware parallel subagents for large, multi-file Antigravity tasks.

  • Works in 6 steps: DECOMPOSE (before any agent runs) → QUOTA ROUTING → CONTEXT ISOLATION → …
  • Tasks that involve Subagents
  • SKILL.md covers Use this skill when, Do not use this skill when, Phase 1 — DECOMPOSE (before… and Phase 2 — QUOTA ROUTING, plus 8 more sections
  • Runs JavaScript scripts from its folder; calls npm

What it does

Subagent Orchestrator is an agent skill from sickn33/agentic-awesome-skills. Coordinate quota-aware parallel subagents for large, multi-file Antigravity tasks.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts (for example `README.md`, `examples/api-plus-frontend.md` and `examples/debug-mission.md`).

It sits in Agent Workflows, covering Subagents. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

When your agent uses it

  • Tasks that involve Subagents

Example prompts

  • “/subagent-orchestrator”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. DECOMPOSE (before any agent runs)
  2. QUOTA ROUTING
  3. CONTEXT ISOLATION
  4. PARALLEL EXECUTION
  5. ERROR RECOVERY
  6. INTEGRATION CHECK

What it can do on your machine

Read from SKILL.md and the folder at commit 680176d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Subagent Orchestrator loads about 1.6k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 602 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit 680176d, republished under its MIT licence (© sickn33). 602 words, ~1,577 tokens.

Download SKILL.mdSave it as .claude/skills/subagent-orchestrator/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
subagent-orchestrator
description
Coordinate quota-aware parallel subagents for large, multi-file Antigravity tasks.
risk
safe
source
community
date_added
2026-09-04
version
1.0.0
author
community
tags
subagents, orchestration, quota, parallel, multi-agent

Subagent Orchestrator

A quota-aware, parallel subagent coordination skill for Antigravity 2.0. Turns one big task into a set of isolated, efficient agent missions — without burning your weekly quota.


Use this skill when

  • A task spans 3+ files or components
  • You want multiple agents working at the same time
  • You've hit quota issues mid-task before
  • The task involves both planning AND building
  • You need browser agent + code agent + terminal agent running together

Do not use this skill when

  • Editing a single file or fixing one bug
  • Writing a quick script under 50 lines
  • Asking a question or generating a plan only

Phase 1 — DECOMPOSE (before any agent runs)

Before spawning any subagent, the orchestrator MUST produce a Mission Brief. Announce:

"Running subagent-orchestrator skill. Decomposing task into isolated missions."

Then output a Mission Brief in this format:

MISSION BRIEF
─────────────────────────────────────────
Goal: [one sentence, what done looks like]
Total Agents: [N]
Quota Strategy: [FLASH / SONNET / MIXED]
Expected Token Cost: [LOW / MEDIUM / HIGH]

AGENTS:
[1] ID: agent-001
    Role: [e.g. Planner / Builder / Tester / Browser]
    Scope: [exact files or URLs this agent touches]
    Model: [Gemini Flash / Claude Sonnet]
    Input: [what it receives]
    Output: [what it produces]
    Depends on: [none / agent-001]

[2] ...
─────────────────────────────────────────

Wait for user to approve the Mission Brief before proceeding. If the user edits it, update and re-confirm. Never skip this step.


Phase 2 — QUOTA ROUTING

Before assigning models, apply this decision tree:

Is this task > 20 files OR > 500 lines of new code?
  YES → Use Gemini Flash for all agents. Reserve Sonnet for final review only.
  NO  → Is this task creative UI / complex logic / API design?
          YES → Use Sonnet for builder agent, Flash for all others.
          NO  → Use Gemini Flash for everything.

Model cost rules (never violate these):

  • Claude Opus → NEVER use in subagents. Too expensive.
  • Claude Sonnet → Max 1 subagent per mission.
  • Gemini Flash → Default for all subagents. Fast, cheap, separate quota pool.
  • Browser subagent → Always runs on its own pool. Use sparingly (1 per mission max).

Phase 3 — CONTEXT ISOLATION

Each subagent gets a scoped context packet. Never give all agents the full codebase.

For each agent, prepare:

AGENT CONTEXT PACKET — agent-[ID]
Files to read: [list only what this agent needs]
Files to write: [list only what this agent will create/edit]
Do NOT read: [explicitly exclude irrelevant files]
Knowledge: [paste only the relevant section of GEMINI.md]

Rule: If an agent doesn't need node_modules, package-lock.json, .next/, or dist/ — add them to a .antigravityignore before the agent runs.


Phase 4 — PARALLEL EXECUTION

Spawn agents in dependency order:

Round 1 (no dependencies): Run agents in parallel
Round 2 (depends on Round 1): Wait for all Round 1 outputs, then run
Round 3 (final): Integrate + verify

Between rounds, the orchestrator MUST:

  1. Collect each agent's output artifact
  2. Run a 3-point spot check:
    • Did the agent stay within its assigned scope?
    • Are there any import/export conflicts with other agents' outputs?
    • Did any agent produce a placeholder ("TODO", "implement later")?
  3. If any check fails → re-run that agent with corrected context. Do NOT continue.

Phase 5 — ERROR RECOVERY

If a subagent fails or produces broken output:

RECOVERY PROTOCOL
─────────────────────────────────────────
1. Do NOT re-run the full mission.
2. Identify the exact failure point.
3. Spawn a single repair agent with:
   - Only the broken file(s) as scope
   - The error message as context
   - Model: Gemini Flash (cheapest for repairs)
4. Validate the repair before continuing.
─────────────────────────────────────────

Never cascade a broken output to the next agent. Always fix before moving forward.


Show full SKILL.md (264 more words)Show less

Phase 6 — INTEGRATION CHECK

After all agents complete, run a final integration sweep:

  • All imports resolve correctly
  • No duplicate function/variable names across files
  • No hardcoded values that should be env variables
  • No console.log left in production files
  • Types are consistent across components (TypeScript)
  • Build would succeed (npm run build mentally verified)

If any check fails, spawn one final repair agent scoped to the exact issue.


Quota Monitoring Rules

Track estimated usage throughout the mission:

EventQuota Impact
Agent spawnedLOW (setup)
File indexed (each)LOW
Tool call (file read/write)MEDIUM
Terminal commandMEDIUM
Browser subagent activatedHIGH
Thinking mode enabledVERY HIGH

If estimated usage crosses 60% of sprint quota mid-mission:

  • Pause and report: "Quota checkpoint: ~60% of sprint used. Continue or defer remaining agents?"
  • Switch remaining agents to Gemini Flash
  • Disable browser subagent if not yet started

Communication Rules

  • Announce which agent is running at all times
  • Show a compact progress bar between rounds:
    Mission Progress: ████████░░ 4/5 agents complete
    Quota Status: ▓▓▓▓░░░░░░ ~40% sprint used
  • Never go silent for more than one agent turn
  • If blocked, say why explicitly — never just stop

Examples

See examples/ folder:

  • nextjs-feature.md — Building a full Next.js feature with 3 parallel agents
  • api-plus-frontend.md — Backend API agent + Frontend UI agent running in parallel
  • debug-mission.md — Repair mission for a broken build using minimal quota

Limitations

  • This skill coordinates agent planning; it does not provide a runtime scheduler or enforce quota limits automatically.
  • Parallel agents still need explicit scoping, review, and integration by the parent agent.
  • Do not use it when a single focused edit or direct answer would be faster and clearer.

© sickn33, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts) in skills/subagent-orchestrator of sickn33/agentic-awesome-skills.

  • SKILL.md
  • README.md
  • examples/api-plus-frontend.md
  • examples/debug-mission.md
  • examples/nextjs-feature.md
  • resources/mission-brief-template.md
  • resources/quota-reference.md
  • scripts/install.js

Open the folder on GitHubat commit 680176d

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Subagent Orchestrator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Subagent Orchestrator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Subagent Orchestrator this skillsickn33/agentic-awesome-skills47k1 repos~1.6kAutomated safety check: PassMIT
Claude Code Agent Developmentanthropics/claude-plugins-official38k7 repos~2.8kAutomated safety check: PassApache-2.0
Subagent Driven DevelopmentAsvarox/allkaraoke26137 repos~1.2kAutomated safety check: PassNone
Dispatching Parallel Agentsultralisp/ultralisp25840 repos~1.5kAutomated safety check: PassNone
Paseo Advisor Second Opiniongetpaseo/paseo20k1 repos~756Automated safety check: PassCustom licence
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~12kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Subagent Driven Development

    Asvarox/allkaraoke

    A skill your agent uses when executing implementation plans with independent tasks in the current session

    261 GitHub starsUsed in 37 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Dispatching Parallel Agents

    ultralisp/ultralisp

    A skill your agent uses when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

    258 GitHub starsUsed in 40 repos~1.5k tokens
    Agent WorkflowsAuto-check passed
  • Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.

    20k GitHub starsUsed in 1 repo~756 tokens
    Agent WorkflowsAuto-check passed
  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~12k tokens
    Agent WorkflowsAuto-check passed
  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,493 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Categories

Questions about Subagent Orchestrator

What does Subagent Orchestrator do?

Coordinate quota-aware parallel subagents for large, multi-file Antigravity tasks. Subagent Orchestrator is an agent skill from sickn33/agentic-awesome-skills. Coordinate quota-aware parallel subagents for large, multi-file Antigravity tasks.

When should I use Subagent Orchestrator?

Subagent Orchestrator fits situations like: tasks that involve Subagents.

How do I install Subagent Orchestrator in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill subagent-orchestrator -a claude-code`. Or copy the skill folder (skills/subagent-orchestrator in sickn33/agentic-awesome-skills) into .claude/skills/subagent-orchestrator in your project. Claude Code loads it when a task matches its description.

How do I install Subagent Orchestrator in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill subagent-orchestrator -a codex`. Or copy the skill folder (skills/subagent-orchestrator in sickn33/agentic-awesome-skills) into .agents/skills/subagent-orchestrator in your project. Codex loads it when a task matches its description.

Can I use Subagent Orchestrator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill subagent-orchestrator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/subagent-orchestrator, .gemini/skills/subagent-orchestrator, .github/skills/subagent-orchestrator and .opencode/skills/subagent-orchestrator in your project.

What does Subagent Orchestrator need to run?

Going by SKILL.md and its folder, Subagent Orchestrator needs JavaScript for the scripts in its folder and the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Subagent Orchestrator access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Subagent Orchestrator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Subagent Orchestrator use?

Subagent Orchestrator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Subagent Orchestrator use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Subagent Orchestrator?

Skills that share tags, products or a category with Subagent Orchestrator: Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Subagent Driven Development (Asvarox/allkaraoke, 261 stars), Dispatching Parallel Agents (ultralisp/ultralisp, 258 stars) and Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Subagent Orchestrator?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,379 GitHub stars. The repository holds 1,493 skills in this directory. The repository was last updated on October 9, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.