Agent skill

Google Antigravity SDK

by google-antigravity in google-antigravity/antigravity-sdk-python

Design, implement, and debug autonomous AI agents and multi-agent systems using the Google Antigravity (AGY) SDK.

Apache-2.0Auto-check: notesAgent Workflows

Install Google Antigravity SDK

skills CLI
$ npx skills add google-antigravity/antigravity-sdk-python --skill google-antigravity-sdk -a claude-code

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

GitHub CLI
$ gh skill install google-antigravity/antigravity-sdk-python google-antigravity-sdk --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/google-antigravity/antigravity-sdk-python.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/google-antigravity-sdk .claude/skills/google-antigravity-sdk && 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
google-antigravity-sdk
GitHub stars
3.7k
Token cost
~2.1k tokens
SKILL.md length
937 words
Files
29 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

Design, implement, and debug autonomous AI agents and multi-agent systems using the Google Antigravity (AGY) SDK.

  • Wants to create
  • SKILL.md covers Installation & Setup and Routing Table
  • Calls gcloud; reaches aistudio.google.com; needs GEMINI_API_KEY
  • Orchestrate Google Antigravity agents

What it does

Google Antigravity SDK is an agent skill from google-antigravity/antigravity-sdk-python. Design, implement, and debug autonomous AI agents and multi-agent systems using the Google Antigravity (AGY) SDK. ACTIVATE this skill when the user wants to create, configure, or orchestrate Google Antigravity agents.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 30 other files, including reference files (for example `examples/getting_started/agent_skills.md`, `examples/getting_started/app_data_dir_override.md` and `examples/getting_started/budget_limits.md`).

It sits in Agent Workflows. It works with Google Gemini, Python and Model Context Protocol. The repository describes itself as: A Python library for building AI agents that leverage the full power of Google Antigravity. The licence is Apache-2.0.

When your agent uses it

  • Wants to create
  • Orchestrate Google Antigravity agents

Example prompts

  • “/google-antigravity-sdk”

Requirements

  • Python 3
  • A credential in GEMINI_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit f61cb2f. 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

    Shell commands in SKILL.md call:

    • gcloud

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • aistudio.google.com

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GEMINI_API_KEY

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

Context cost

Google Antigravity SDK loads about 2.1k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 60 tokens; SKILL.md has 937 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:26
    environment variable or a `.env` file (required to access Gemini

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from google-antigravity/antigravity-sdk-python at commit f61cb2f, republished under its Apache-2.0 licence (© google-antigravity). 937 words, ~2,137 tokens.

Download SKILL.mdSave it as .claude/skills/google-antigravity-sdk/SKILL.md (or your agent's skills folder). This skill also uses 28 other files; get the full folder from GitHub.
name
google-antigravity-sdk
description
Design, implement, and debug autonomous AI agents and multi-agent systems using the Google Antigravity (AGY) SDK. ACTIVATE this skill when the user wants to create, configure, or orchestrate Google Antigravity agents.

Google Antigravity SDK

Installation & Setup

Before proceeding with any Google Antigravity tasks, ensure the environment is ready:

  • Verify Applicability: If operating in an existing codebase, verify that using this Python SDK is possible and appropriate for the project.
  • Check Dependencies: Check if google-antigravity is listed in the project's dependencies (e.g., requirements.txt, pyproject.toml).
  • Install Package: Ensure the google-antigravity Python package is installed.
  • Authentication Setup:
    • The SDK defaults to hosted Gemini models with an API key (LocalAgentConfig). When running on-device or without cloud connectivity is desired, local models (LiteRTAgentConfig or LocalOpenAIAgentConfig) can be used as an alternative without an API key or cloud credentials.
    • Hosted Models (Gemini - Default): Check for a valid GEMINI_API_KEY environment variable or a .env file (required to access Gemini models).
      • If credentials are missing, you MUST actively help the user get set up with an API key by providing the following link:
        • Default to Google AI Studio: https://aistudio.google.com/app/api-keys
      • Explain that the API key can be passed explicitly in code as shorthand (e.g., LocalAgentConfig(api_key="...")) or automatically read from the environment.
      • For Gemini Enterprise Agent Platform (formerly Vertex AI) authentication, the SDK supports both Standard Mode and Express Mode:
        • Standard Mode (ADC): Instruct the user to run gcloud auth application-default login and configure the agent with vertex=True along with project and location in LocalAgentConfig.
        • Express Mode (API Key): Configure the agent with vertex=True along with api_key="your-express-api-key" in LocalAgentConfig (no ADC or regional project/location needed).
    • Local Models (Alternative): For local models (LiteRTAgentConfig or LocalOpenAIAgentConfig), no API key or cloud credentials are needed. LiteRT is the supported on-device runtime for local models (such as Gemma 4 26B). See references/local_models.md and examples/getting_started/local_models.md for setup details.

Routing Table

Use the following information to dig deeper into specific topics based on the user request. Read the referenced files or explore the directories to find relevant information.

References
  • If the user needs to understand the high-level overview and core concepts of the Google Antigravity SDK (Agent, Conversation, Connection), read references/architecture.md.
  • If the user needs to perform advanced agent configuration (e.g., selecting appropriate models, configuring execution behavior via agent_behavior—defaulting to autonomous vs interactive—or configuring connection reliability), or understand the critical rules for model identifiers to avoid assumptions, read references/agent_configuration.md.
  • If the user needs to extend an agent's capabilities by integrating Model Context Protocol (MCP) servers, or configure tool permissions for the agent, read references/mcp_integration.md.
  • If the user needs to define safety policies, resolve execution order, restrict agent actions using predicates, or run terminal commands inside an OS-level sandbox, read references/safety_policies.md.
  • If the user needs to debug failed agents, stream logs, or implement error recovery using hooks to make agents robust, read references/error_handling.md.
  • If the user needs to monitor costs, track token usage (including thinking tokens), or build custom audit logs for advanced monitoring, read references/observability.md.
  • If the user needs to see a list of built-in tools and understand their default state, read references/built_in_tools.md.
  • If the user needs to run agents locally using on-device models (LiteRTAgentConfig for the supported on-device runtime, or LocalOpenAIAgentConfig for external OpenAI-compatible servers like Ollama/LM Studio), understand hardware requirements, or configure local execution, read references/local_models.md.
Show full SKILL.md (426 more words)Show less
Examples
  • If the user needs to implement basic agent behavior, streaming responses, or expose internal thoughts, read examples/getting_started/hello_world.md.
  • If the user needs to customize or override default retry behavior and exponential backoff for API errors or schema validation, read examples/getting_started/customizing_retries.md.
  • If the user needs to equip an agent with custom capabilities (tools) derived from Python functions, or maintain agent state across tool execution, read examples/getting_started/custom_tool.md.
  • If the user needs to shape an agent's persona, define its system instructions, or dynamically adapt its behavior, read examples/getting_started/persona_config.md.
  • If the user needs to build multimodal agents capable of processing images and PDFs, or generating visual content, read examples/getting_started/multimodal.md.
  • If the user needs to implement multi-agent delegation, allowing a main agent to spawn and orchestrate subagents, or configure multi-tier nested subagent hierarchies (using max_subagent_depth and allowed_subagents), read examples/getting_started/subagents.md.
  • If the user needs to author and execute deterministic multi-agent workflows using @beta.workflows.define (phase, log, agent, parallel, pipeline) and await agent.beta.run_workflow(...), read examples/getting_started/workflows.md.
  • If the user needs to connect an agent to external services via MCP (Stdio or SSE), read examples/getting_started/mcp_tools.md.
  • If the user needs to create proactive agents that respond to time-based events or file system triggers in the background, read examples/getting_started/periodic_trigger.md.
  • If the user needs to intercept agent lifecycle events (e.g., pre/post turn, stop, tool execution, errors) to customize execution flow, read examples/getting_started/hooks.md.
  • If the user needs to implement turn-level cancellation or programmatic stream aborts, read examples/getting_started/cancellation.md.
  • If the user needs to implement persistent agents that remember past interactions across sessions, read examples/getting_started/persistence.md.
  • If the user needs to override the default application data directory for agent artifacts, scratch files, and media storage, read examples/getting_started/app_data_dir_override.md.
  • If the user needs an agent to output structured data (e.g., JSON matching a Pydantic schema) for reliable integration, read examples/getting_started/structured_output.md.
  • If the user needs to add, configure, or load agent skills into the Google Antigravity SDK agent, read examples/getting_started/agent_skills.md.
  • If the user needs to enable and use built-in web tools (like Google Search or URL fetching) with the agent, read examples/getting_started/web_tools.md. (Note: when fetching massive web pages or articles, pair read_url_content with view_file to inspect cached disk files).
  • If the user needs to enforce session operational limits (model or tool calls) or proactive token budget controls (input, output, or total tokens) and handle StopReason, read examples/getting_started/budget_limits.md.
  • If the user needs to set up and run a local model agent (LiteRT, or an OpenAI-compatible server like Ollama), including model download, hardware requirements, and context compaction configuration, read examples/getting_started/local_models.md.
  • If the user needs to configure conversation context limits and compaction thresholds to handle long-running sessions, read examples/getting_started/compaction.md.

© google-antigravity, Apache-2.0. 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 28 other files (references) in skills/google-antigravity-sdk of google-antigravity/antigravity-sdk-python.

  • SKILL.md
  • examples/getting_started/agent_skills.md
  • examples/getting_started/app_data_dir_override.md
  • examples/getting_started/budget_limits.md
  • examples/getting_started/cancellation.md
  • examples/getting_started/compaction.md
  • examples/getting_started/custom_tool.md
  • examples/getting_started/customizing_retries.md
  • examples/getting_started/hello_world.md
  • examples/getting_started/hooks.md
  • examples/getting_started/local_models.md
  • examples/getting_started/mcp_tools.md
  • examples/getting_started/multimodal.md
  • examples/getting_started/periodic_trigger.md
  • examples/getting_started/persistence.md
  • examples/getting_started/persona_config.md
  • examples/getting_started/structured_output.md
  • examples/getting_started/subagents.md
  • examples/getting_started/web_tools.md
  • … and 10 more

Open the folder on GitHubat commit f61cb2f

Compare with similar skills

Google Antigravity SDK 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.

Google Antigravity SDK compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Antigravity SDK this skillgoogle-antigravity/antigravity-sdk-python3.7k—~2.1kAutomated safety check: NotesApache-2.0
Unraiddinglebear-ai/unraid135—~5.4kAutomated safety check: NotesMIT
Deep Research MCP Guidepminervini/deep-research-mcp113—~5.8kAutomated safety check: PassMIT
Gemini API Devaiskillstore/marketplace4302 repos~1.6kAutomated safety check: PassApache-2.0
Documentation Serverandrea9293/mcp-documentation-server343—~2.3kAutomated safety check: PassMIT
Unraiddinglebear-ai/unraid135—~2.8kAutomated safety check: PassMIT

Similar skills

  • Unraid

    dinglebear-ai/unraid

    This skill should be used when the user mentions Unraid, asks to check server health, monitor array or disk status, list or restart Docker containers, start or stop VMs, read system logs, check…

    135 GitHub stars~5.4k tokensUpdated 5 days ago
    DevOps & CloudAuto-check: notes
  • Deep Research MCP Guide

    pminervini/deep-research-mcp

    Explains how to run, integrate and debug the deep-research-mcp project through its CLI, Python API or MCP server, with OpenAI, Gemini and DR-Tulu backends.

    113 GitHub stars~5.8k tokensUpdated 11 days ago
    Research & ScienceAuto-check passed
  • Gemini API Dev

    aiskillstore/marketplace

    A skill your agent uses when building applications with Gemini API hosted models, including Gemini and Gemma 4, working with multimodal content (text, images, audio, video), implementing function…

    430 GitHub starsUsed in 2 repos~1.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Documentation Server

    andrea9293/mcp-documentation-server

    A skill your agent uses when you need to store, retrieve, search, or manage documents in a local knowledge base with semantic search and hybrid (vector + full-text) retrieval.

    343 GitHub stars~2.3k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Unraid

    dinglebear-ai/unraid

    Query and monitor an Unraid NAS/homelab server — array health, disk temperatures, Docker containers, virtual machines, system metrics, notifications, alerts, shares, UPS status, log files, network…

    135 GitHub stars~2.8k tokensUpdated 5 days ago
    DevOps & CloudAuto-check passed
  • Mcpa Certification

    fancyboi999/ai-engineering-from-scratch-zh

    AI Engineering from Scratch 中文版中的 MCPA(Model Context Protocol Associate)AI 原生导师与入门流程。学习者需要备考 MCPA、继续认证路线、 交互式学习下一课、运行并验证实践实验、参加诊断或全真模拟、根据薄弱领域 补弱时使用。适用于 Claude Code、Codex、ChatGPT、Cursor 或其他 agent。

    1.2k GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check passed

Questions about Google Antigravity SDK

What does Google Antigravity SDK do?

Design, implement, and debug autonomous AI agents and multi-agent systems using the Google Antigravity (AGY) SDK. Google Antigravity SDK is an agent skill from google-antigravity/antigravity-sdk-python. Design, implement, and debug autonomous AI agents and multi-agent systems using the Google Antigravity (AGY) SDK.

When should I use Google Antigravity SDK?

Google Antigravity SDK fits situations like: wants to create; orchestrate Google Antigravity agents.

How do I install Google Antigravity SDK in Claude Code?

Run `npx skills add google-antigravity/antigravity-sdk-python --skill google-antigravity-sdk -a claude-code`. Or copy the skill folder (skills/google-antigravity-sdk in google-antigravity/antigravity-sdk-python) into .claude/skills/google-antigravity-sdk in your project. Claude Code loads it when a task matches its description.

How do I install Google Antigravity SDK in Codex?

Run `npx skills add google-antigravity/antigravity-sdk-python --skill google-antigravity-sdk -a codex`. Or copy the skill folder (skills/google-antigravity-sdk in google-antigravity/antigravity-sdk-python) into .agents/skills/google-antigravity-sdk in your project. Codex loads it when a task matches its description.

Can I use Google Antigravity SDK 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 google-antigravity/antigravity-sdk-python --skill google-antigravity-sdk -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-antigravity-sdk, .gemini/skills/google-antigravity-sdk, .github/skills/google-antigravity-sdk and .opencode/skills/google-antigravity-sdk in your project.

What does Google Antigravity SDK need to run?

Going by SKILL.md and its folder, Google Antigravity SDK needs the command-line tools its instructions call (gcloud) and credentials named GEMINI_API_KEY. Our summary lists: Python 3; A credential in GEMINI_API_KEY.

Does Google Antigravity SDK access the network?

SKILL.md names 1 domain. In commands or code: aistudio.google.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Google Antigravity SDK safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Google Antigravity SDK use?

Google Antigravity SDK is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Antigravity SDK use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to Google Antigravity SDK?

Skills that share tags, products or a category with Google Antigravity SDK: Unraid (dinglebear-ai/unraid, 135 stars), Deep Research MCP Guide (pminervini/deep-research-mcp, 113 stars), Gemini API Dev (aiskillstore/marketplace, 430 stars) and Documentation Server (andrea9293/mcp-documentation-server, 343 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Antigravity SDK?

google-antigravity (a GitHub organization) maintains it in google-antigravity/antigravity-sdk-python, which has 3,673 GitHub stars. The repository was last updated on October 7, 2026.

Source: google-antigravity/antigravity-sdk-python on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.