A single Claude Code skill — one markdown instruction file (SKILL.md) named antigravity-agents. Skills are capabilities Claude Code loads on demand. This one teaches it to hand off work to the Google Antigravity CLI (agy), an autonomous terminal coding agent powered by Gemini and other models.

With the skill loaded, Claude Code stops being a single worker and becomes an orchestrator: it writes a self-contained brief, launches an agy job in the background, keeps working on your task, then collects and verifies the result before trusting a line of it.

Contents

• Why you'd want this
• How it works
• Prerequisites
• Install the skill
• Usage
• Safety model
• Attribution

Why you'd want this

• Save your tokens. Full-repo audits, big refactors, and research sweeps are expensive to run inside a Claude session. Offload them to Antigravity instead of burning your Claude context and subscription tokens on the grind work.
• Broaden your model choice. Run a job on Gemini (or whatever Antigravity offers) for a genuinely independent second opinion — or just to put the right model on the right task.
• Work in parallel. Fan out several sub-agent jobs at once while Claude Code stays responsive to you. More gets done per unit of wall-clock time.

How it works

Claude writes the brief, launches the job non-interactively (agy -p "<task>"), and immediately returns to your work. The sub-agent runs on its own. When it finishes, Claude reads the output and verifies it — git diff, typecheck, build — before any of it is trusted or merged.

flowchart LR
    A[Claude Code<br/>orchestrator] -->|writes self-contained brief| B["agy -p '&lt;task&gt;'"]
    B -->|launched in background| C{Job type}
    C -->|read-only| D[Sandbox mode<br/>runs concurrently]
    C -->|writes files| E[Isolated worktree<br/>or separate repo]
    A -. keeps building your task .-> A
    D --> F[Result]
    E --> F[Result]
    F -->|git diff · typecheck · build| G[Claude verifies]
    G -->|trusted| H[Folded into your work]

Prerequisites

Two one-time steps.

1. Install the Antigravity CLI.

On macOS / Linux:

curl -fsSL https://antigravity.google/cli/install.sh | bash

On Windows (PowerShell):

irm https://antigravity.google/cli/install.ps1 | iex

Full details are in the official guide: https://antigravity.google/docs/cli/getting-started

2. Sign in to Google.

Run agy once in a terminal and complete the one-time Google OAuth sign-in in your browser:

agy

After that, Claude Code can launch agy jobs non-interactively — no further prompts.

Install the skill

Clone this repo and copy the antigravity-agents folder into your Claude Code skills directory. Claude Code auto-discovers it on the next run.

macOS / Linux

git clone https://github.com/markfulton/claude-antigravity-agents.git
cp -r claude-antigravity-agents/antigravity-agents ~/.claude/skills/

Windows (PowerShell)

git clone https://github.com/markfulton/claude-antigravity-agents.git
Copy-Item -Recurse claude-antigravity-agents\antigravity-agents "$env:USERPROFILE\.claude\skills\"

That's it. Start a Claude Code session and ask it to delegate something — the skill loads on demand.

Usage

Just talk to Claude Code the way you already do. A few prompts that trigger the skill:

"Have Antigravity review my current branch diff for bugs while you keep building the checkout flow."

"Spin up a sub-agent to audit this repo's dependencies for known vulnerabilities and report back."

"Get a second opinion from Gemini on this caching design, and keep working on the API in the meantime."

Claude decides the job type, picks the right isolation mode, launches it in the background, and reports back once it has collected and verified the result.

Safety model

Delegation only helps if you can trust what comes back. One rule sits above everything else:

An Antigravity job never writes to the same files Claude Code is editing at that moment.

That rule drives how every job runs:

Everything is verified before it's trusted — Claude inspects the git diff and runs the project's typecheck / build on any returned work before folding it in. No sub-agent change is taken on faith. Keep a task in Claude when it's small, tightly coupled to what you're editing right now, or needs live back-and-forth; delegation shines on the heavy, separable work.

Attribution

• Created by Mark Fulton
• Founder of the Vibe Coding is Life community (316k+ members)
• Co-authored by Claude Fable 5

License

Released under the MIT License.