playbook/antigravity-awesome-skills/skills/subagent-orchestrator/README.md

2.7 KiB
Raw Permalink Blame History

Subagent Orchestrator — Antigravity 2.0 Skill

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 in 30 minutes.


What it does

  • Splits complex tasks into isolated agent missions before any code is written
  • Routes tasks to the cheapest model that can handle them (Flash by default)
  • Runs independent agents in parallel, not in sequence
  • Monitors quota usage throughout and pauses if limits are approaching
  • Recovers from agent failures without re-running the whole mission
  • Runs a final integration check before declaring the mission complete

Install

One command (Windows PowerShell):

node scripts/install.js

Manual install — copy this folder to:

Windows: %USERPROFILE%\.agents\skills\subagent-orchestrator\
Mac/Linux: ~/.agents/skills/subagent-orchestrator/

Then restart your Antigravity session.


Usage

The skill auto-activates when your task:

  • Spans 3+ files or components
  • Needs parallel agents (UI + API, planner + builder, etc.)
  • Has quota risk (large codebase, many tool calls expected)

Or trigger it manually:

"Use subagent-orchestrator to build the auth flow"

Folder structure

subagent-orchestrator/
├── SKILL.md                          ← Main skill (auto-loaded by Antigravity)
├── scripts/
│   └── install.js                    ← Installer script
├── examples/
│   ├── nextjs-feature.md             ← 3-agent parallel Next.js feature
│   ├── api-plus-frontend.md          ← Backend + frontend parallel build
│   └── debug-mission.md              ← Minimal quota repair mission
└── resources/
    ├── mission-brief-template.md     ← Copy-paste template for any mission
    └── quota-reference.md            ← Cost estimates for every action type

Quota reference (quick)

Model Cost
Gemini Flash 1x (default for all subagents)
Claude Sonnet ~4x (max 1 per mission)
Claude Opus Never use in subagents
Mission size Est. sprint used
1-file repair < 5%
Single feature 1525%
Full flow (auth, API, UI) 3045%

Contributing

This skill was built to fill a real gap — the community's existing subagent skills had no quota management, no parallel coordination, and no error recovery.

PRs welcome. Follow the SKILL.md format from the Antigravity docs. Submit to: https://github.com/sickn33/antigravity-awesome-skills


Compatibility

  • Antigravity 2.0+ (CLI and IDE)
  • Claude Code
  • Cursor (via SKILL.md standard)
  • OpenCode