100 lines
2.7 KiB
Markdown
100 lines
2.7 KiB
Markdown
# 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):**
|
||
```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 | 15–25% |
|
||
| Full flow (auth, API, UI) | 30–45% |
|
||
|
||
---
|
||
|
||
## 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
|