diff --git a/.antigravity/INSTALL.md b/.antigravity/INSTALL.md
new file mode 100644
index 000000000..6c296a5cf
--- /dev/null
+++ b/.antigravity/INSTALL.md
@@ -0,0 +1,113 @@
+# Installing Superpowers for Antigravity IDE
+
+Antigravity IDE has native Skills support. Follow these steps to install superpowers skills.
+
+## Installation
+
+### 1. Clone the repository
+
+**Linux/macOS:**
+```bash
+git clone https://github.com/obra/superpowers.git ~/.gemini/antigravity/superpowers
+```
+
+**Windows:**
+```powershell
+git clone https://github.com/obra/superpowers.git "$env:USERPROFILE\.gemini\antigravity\superpowers"
+```
+
+### 2. Copy skills to your project
+
+Copy the skills folder to your workspace's `.agent/skills` directory:
+
+**Linux/macOS:**
+```bash
+mkdir -p .agent
+cp -r ~/.gemini/antigravity/superpowers/skills .agent/skills
+```
+
+**Windows:**
+```powershell
+New-Item -ItemType Directory -Force -Path ".agent"
+Copy-Item -Recurse "$env:USERPROFILE\.gemini\antigravity\superpowers\skills" ".agent\skills"
+```
+
+### 3. Configure Global Rules
+
+Add the following content to your `~/.gemini/GEMINI.md` (Linux/macOS) or `$env:USERPROFILE\.gemini\GEMINI.md` (Windows) file:
+
+```markdown
+## Superpowers System
+
+<EXTREMELY_IMPORTANT>
+You have superpowers. Superpowers teach you new skills and capabilities.
+**RIGHT NOW** use: **using-superpowers** skill and follow the instructions it returns!!!
+</EXTREMELY_IMPORTANT>
+```
+
+### 4. Verify installation
+
+**Linux/macOS:**
+```bash
+ls .agent/skills/
+```
+
+**Windows:**
+```powershell
+Get-ChildItem ".agent\skills"
+```
+
+You should see skill folders like `brainstorming`, `writing-plans`, `test-driven-development`, etc.
+
+## Done!
+
+Skills are now available in Antigravity IDE. They activate automatically based on context.
+
+## Updating
+
+To update skills, pull the latest changes and copy again:
+
+```bash
+cd ~/.gemini/antigravity/superpowers && git pull
+```
+
+Then re-copy the skills folder to your project.
+
+---
+
+## Global Installation (Alternative)
+
+If you prefer to install skills globally (available across all projects):
+
+**Linux/macOS:**
+```bash
+cp -r ~/.gemini/antigravity/superpowers/skills ~/.gemini/antigravity/skills
+```
+
+**Windows:**
+```powershell
+Copy-Item -Recurse "$env:USERPROFILE\.gemini\antigravity\superpowers\skills" "$env:USERPROFILE\.gemini\antigravity\skills"
+```
+
+---
+
+## Personal Skills
+
+To add personal skills alongside superpowers, create new skill folders in `.agent/skills/`:
+
+```bash
+mkdir -p .agent/skills/my-skill
+```
+
+Create `.agent/skills/my-skill/SKILL.md`:
+
+```markdown
+---
+name: my-skill
+description: Use when [condition] - [what it does]
+---
+
+# My Skill
+
+[Your skill content here]
+```
diff --git a/README.md b/README.md
index 0e67aefcf..08a59a689 100644
--- a/README.md
+++ b/README.md
@@ -77,6 +77,16 @@ Fetch and follow instructions from https://raw.githubusercontent.com/obra/superp
 
 **Detailed docs:** [docs/README.opencode.md](docs/README.opencode.md)
 
+### Antigravity IDE
+
+Tell Antigravity:
+
+```
+Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.antigravity/INSTALL.md
+```
+
+**Detailed docs:** [docs/README.antigravity.md](docs/README.antigravity.md)
+
 ## The Basic Workflow
 
 1. **brainstorming** - Activates before writing code. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document.
diff --git a/docs/README.antigravity.md b/docs/README.antigravity.md
new file mode 100644
index 000000000..28e30f832
--- /dev/null
+++ b/docs/README.antigravity.md
@@ -0,0 +1,128 @@
+# Superpowers for Antigravity IDE
+
+Complete guide for using Superpowers with Antigravity IDE.
+
+## Quick Install
+
+Tell Antigravity:
+
+```
+Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.antigravity/INSTALL.md
+```
+
+## Manual Installation
+
+### Prerequisites
+
+- Antigravity IDE installed
+- Git installed
+
+### Installation Steps
+
+#### 1. Clone Superpowers
+
+**Linux/macOS:**
+```bash
+git clone https://github.com/obra/superpowers.git ~/.gemini/antigravity/superpowers
+```
+
+**Windows (PowerShell):**
+```powershell
+git clone https://github.com/obra/superpowers.git "$env:USERPROFILE\.gemini\antigravity\superpowers"
+```
+
+#### 2. Copy Skills
+
+Copy the skills folder to your workspace:
+
+**Linux/macOS:**
+```bash
+mkdir -p .agent
+cp -r ~/.gemini/antigravity/superpowers/skills .agent/skills
+```
+
+**Windows:**
+```powershell
+New-Item -ItemType Directory -Force -Path ".agent"
+Copy-Item -Recurse "$env:USERPROFILE\.gemini\antigravity\superpowers\skills" ".agent\skills"
+```
+
+#### 3. Configure Global Rules
+
+Add the following content to your `~/.gemini/GEMINI.md` (Linux/macOS) or `$env:USERPROFILE\.gemini\GEMINI.md` (Windows) file:
+
+```markdown
+## Superpowers System
+
+<EXTREMELY_IMPORTANT>
+You have superpowers. Superpowers teach you new skills and capabilities.
+**RIGHT NOW** use: **using-superpowers** skill and follow the instructions it returns!!!
+</EXTREMELY_IMPORTANT>
+```
+
+#### 4. Verify Installation
+
+In Antigravity, ask: "What skills are available?"
+
+You should see superpowers skills listed.
+
+## Usage
+
+Skills activate automatically based on context. For example:
+
+- Say "I want to build a new feature" → `brainstorming` skill activates
+- Say "I need to debug this issue" → `systematic-debugging` skill activates
+- Say "Let's implement this" → `test-driven-development` skill activates
+
+---
+
+## Global Installation (Alternative)
+
+If you prefer to install skills globally (available across all projects):
+
+**Linux/macOS:**
+```bash
+cp -r ~/.gemini/antigravity/superpowers/skills ~/.gemini/antigravity/skills
+```
+
+**Windows:**
+```powershell
+Copy-Item -Recurse "$env:USERPROFILE\.gemini\antigravity\superpowers\skills" "$env:USERPROFILE\.gemini\antigravity\skills"
+```
+
+---
+
+## Personal Skills
+
+To add personal skills, create new skill folders in `.agent/skills/`:
+
+```bash
+mkdir -p .agent/skills/my-skill
+```
+
+Create `.agent/skills/my-skill/SKILL.md`:
+
+```markdown
+---
+name: my-skill
+description: Use when [condition] - [what it does]
+---
+
+# My Skill
+
+[Your skill content here]
+```
+
+## Updating
+
+```bash
+cd ~/.gemini/antigravity/superpowers
+git pull
+```
+
+Then re-copy the skills folder to your project.
+
+## Getting Help
+
+- Report issues: https://github.com/obra/superpowers/issues
+- Main documentation: https://github.com/obra/superpowers