Developer Tutorial
15 min read
Updated March 2026

How to Use Antigravity Skills: Complete 2026 GitHub Guide

Learn how to use Google Antigravity skills instantly. Our 2026 complete guide covers installation, top GitHub repository examples, and building custom developer workflows.

Published on March 08, 2026 • Updated for Antigravity Global Skills v2.0

Quick Answer

To use Antigravity skills, install the global CLI via npm install -g antigravity-cli. Then, run antigravity add skills in your project directory to fetch popular packages from the romin irani/antigravity-skills GitHub repository.

⏱️ TL;DR: Install the CLI, run the add command, configure your agent.

Before You Begin

Prerequisites Checklist

  • Google Gemini SDK installed (v2.0+)
  • Node.js v18 or later
  • A verified Google Gemini API Key
  • Basic knowledge of TypeScript or Python

Step 1: Install Antigravity Global Skills

The fastest way to get started is by utilizing the global Antigravity toolkit. This gives you access to the skill creator and repository manager directly from your terminal.

# Install the Antigravity global toolkit
npm install -g @google/antigravity-toolkit

# Verify installation
antigravity --version

Step 2: Add Awesome Antigravity Skills from GitHub

The community has built an incredible ecosystem of open-source skills. You can pull these directly from popular GitHub repositories like romin irani/antigravity-skills.

# Initialize Antigravity in your project
cd my-project
antigravity init

# Search and install popular skills
antigravity add skills --repo "romin-irani/antigravity-skills" --skill "typescript-refactor"

Top GitHub Repositories for Antigravity Skills

romin irani/antigravity-skills

The definitive community repository containing dozens of pre-built Google Antigravity skills for data analysis, web scraping, and code review.

4.2k
awesome antigravity skills github

A curated list of awesome Antigravity skills, libraries, and frameworks. Updated weekly by the open-source community.

2.8k
antigravity skills kit

The official starter kit for building your own custom Antigravity agent skills using TypeScript and the Gemini API.

1.5k

Step 3: Creating an Antigravity Skills MD File

To define how your Gemini agent behaves, you need to create a markdown definition file (e.g., antigravity-skills.md). This file acts as the prompt instruction manual for the agent.

---
name: my-custom-skill
description: Automatically reviews pull requests and checks for security vulnerabilities.
version: 1.0.0
---

# PR Review Agent Instructions

You are an expert security engineer. When triggered, use the `analyze_code` tool to review the provided pull request patch. Look specifically for:
1. SQL Injection vulnerabilities
2. Cross-Site Scripting (XSS)
3. Hardcoded secrets

Output your findings as a formalized markdown checklist.

For more details on crafting precise Markdown skill definitions, see our Complete Guide to Building Skills for Claude and Gemini.

✅ Do:

  • • Use the official Antigravity Skills Creator toolkit.
  • • Check Reddit and GitHub for verified skill templates.
  • • Structure your .md files with clear YAML frontmatter.

❌ Don't:

  • • Install unverified skills from unknown sources.
  • • Hardcode API keys inside your skill markdown files.
  • • Forget to update your global CLI tools regularly.

Frequently Asked Questions

What is an Antigravity skill?

An Antigravity skill is a packaged set of instructions, tools, and configurations that allows Google Gemini agents to perform specific tasks natively within an IDE or command line environment.

How do I install Antigravity skills?

You can install Antigravity skills directly from GitHub repositories using the Antigravity CLI, or by manually copying the skill definitions into your project's .gemini/skills folder.

Are Google Antigravity skills free to use?

The skills themselves, available on GitHub, are typically open source and free. However, running the Google Gemini agent utilizing these skills requires an active API key which may incur usage charges depending on your plan. Check our directory for free alternatives.

Is there an IDE integration for Antigravity skills?

Yes, Antigravity skills integrate natively into popular editors. The Antigravity IDE kit provides seamless support for triggering skills via keyboard shortcuts and inline code actions.

Start Building Antigravity Workflows

Take your AI development to the next level. Browse our complete directory of open-source agent skills or start creating your own using the Antigravity toolkit.