How to Integrate google/skills with Antigravity CLI: A Step-by-Step Guide

Install the Antigravity CLI (agy), run agy plugin install with the Google Skills repository path, then verify activation with agy /mcp—no custom code required.

The google/skills repository provides production-ready conversational skills and MCP (Model Context Protocol) servers for Google Cloud products. Integrating these with the Antigravity CLI allows any Antigravity-powered agent to invoke Google APIs conversationally. This guide walks through the exact installation steps, architectural concepts, and verification commands based on the official source.

Understanding the Integration Architecture

Three components work together to enable zero-code integration:

• Antigravity CLI (agy) – Discovers, installs, and registers MCP servers. When you run agy plugin install, the CLI clones the plugin into ~/.agy/plugins/ and registers its MCP definition with your local agent harness.

• Google Skills – Markdown-based skill definitions (e.g., SKILL.md files) that describe prompts, tool usage, and output handling. These are runtime-agnostic; Antigravity interprets their mcp metadata to expose underlying APIs.

• MCP Server – Each skill optionally ships a small binary or script implementing actual API calls. Antigravity loads these on demand, enabling conversational access to Google Cloud services.

Step 1: Install the Antigravity CLI

The official installer is a one-line curl command:

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

Verify successful installation:

agy version

This prerequisite is documented in skills/cloud/agent-platform-migrate-from-ai-studio/SKILL.md, which provides migration guidance from Google AI Studio to Antigravity.

Step 2: Install a Google Skills Plugin

The generic command format from the repository README.md is:

agy plugin install https://github.com/google/skills/<plugin-path>

Installing from the Data Agent Kit

The plugins/cloud/data-agent-kit/README.md lists concrete plugin paths for Google Cloud products. Install individual services as submodules:

# Spanner

agy plugin install https://github.com/google/skills/plugins/cloud/data-agent-kit/spanner

# BigQuery

agy plugin install https://github.com/google/skills/plugins/cloud/data-agent-kit/bigquery

# AlloyDB

agy plugin install https://github.com/google/skills/plugins/cloud/data-agent-kit/alloydb

Each plugin contains a SKILL.md file (e.g., plugins/cloud/data-agent-kit/spanner/SKILL.md) defining the conversational skill and MCP metadata for that product.

Step 3: Verify MCP Activation

Confirm your skill is registered as an MCP tool:

agy /mcp

Expected output shows registered servers:

> agy /mcp
...
spanner   ▶  google-cloud-spanner-mcp  v0.3.5
bigquery  ▶  google-cloud-bigquery-mcp v0.2.1
...

Filter for specific tools:

agy /mcp | grep spanner

Detailed verification steps appear in skills/ads/google-ads-api-mcp-setup/SKILL.md, which documents the /mcp endpoint behavior and troubleshooting.

Using Installed Skills in Antigravity Sessions

Once activated, invoke skills conversationally through the CLI:

agy ask "List my Spanner databases in project my-project"

Antigravity automatically routes the request to the appropriate MCP server—no additional configuration needed.

Key Source Files Reference

File	Purpose
README.md (repo root)	Generic agy plugin install command format
plugins/cloud/data-agent-kit/README.md	Concrete plugin paths and version tags
skills/cloud/agent-platform-migrate-from-ai-studio/SKILL.md	Step-by-step CLI installation instructions
skills/ads/google-ads-api-mcp-setup/SKILL.md	MCP activation verification procedures
plugins/cloud/data-agent-kit/<service>/SKILL.md	Individual service skill definitions and MCP metadata

Summary

• Install once: curl -fsSL https://antigravity.google/install.sh | bash
• Add skills: agy plugin install https://github.com/google/skills/<path>
• Verify registration: agy /mcp lists active MCP tools
• Use immediately: Skills work conversationally via agy ask with zero additional code

The integration requires no custom glue code—the Antigravity CLI handles discovery, registration, and execution automatically.

Frequently Asked Questions

What is the Antigravity CLI (agy) entry point for loading Google Skills?

The agy command serves as the unified entry point. It installs skills via agy plugin install, verifies them through agy /mcp, and invokes them via agy ask. According to the google/skills source, this three-step workflow requires no custom implementation.

Do I need to write code to connect Google Skills to Antigravity?

No. The Antigravity CLI automatically clones plugins into ~/.agy/plugins/, parses their SKILL.md metadata, and registers contained MCP servers. The end-user only runs install and verification commands.

Where are Google Skills plugin paths documented?

Concrete paths appear in plugins/cloud/data-agent-kit/README.md, which lists submodule directories like plugins/cloud/data-agent-kit/spanner and plugins/cloud/data-agent-kit/bigquery. The repository root README.md provides the generic command template.

How do I troubleshoot a skill that doesn't appear in agy /mcp?

First confirm successful plugin installation by checking ~/.agy/plugins/ for the cloned repository. Then review the specific skill's SKILL.md file for MCP configuration requirements. The skills/ads/google-ads-api-mcp-setup/SKILL.md file contains detailed verification and debugging procedures.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}