Skip to content
Open
113 changes: 113 additions & 0 deletions .antigravity/INSTALL.md
Original file line number Diff line number Diff line change
@@ -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]
```
10 changes: 10 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
128 changes: 128 additions & 0 deletions docs/README.antigravity.md
Original file line number Diff line number Diff line change
@@ -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
```
Comment on lines 99 to 101
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Provide Windows equivalents for personal skills setup.

The Personal Skills section only includes bash commands, but earlier sections consistently provided both Linux/macOS and Windows instructions. This inconsistency prevents Windows users from following the personal skills setup.

📝 Suggested fix to add Windows commands
 To add personal skills alongside superpowers:
 
+**Linux/macOS:**
 ```bash
 # Remove the symlink and create a directory
 rm .agent/skills
 mkdir -p .agent/skills
 
 # Link superpowers as a subdirectory
 ln -sf ~/.gemini/antigravity/superpowers/skills .agent/skills/superpowers
 
 # Add personal skills
 mkdir -p .agent/skills/my-skill

+Windows (PowerShell as Administrator):
+powershell +# Remove the symlink and create a directory +Remove-Item ".agent\skills" -Force +New-Item -ItemType Directory -Force -Path ".agent\skills" + +# Link superpowers as a subdirectory +cmd /c mklink /J ".agent\skills\superpowers" "$env:USERPROFILE\.gemini\antigravity\superpowers\skills" + +# Add personal skills +New-Item -ItemType Directory -Force -Path ".agent\skills\my-skill" +

Create .agent/skills/my-skill/SKILL.md:

</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

In @docs/README.antigravity.md around lines 86 - 96, Add Windows PowerShell
equivalents to the Personal Skills section: keep the existing bash block and add
a PowerShell block that uses Remove-Item to delete the existing .agent\skills,
New-Item to create the directory, cmd /c mklink /J to create a junction for the
superpowers subdirectory, and New-Item to create the my-skill folder; place the
new PowerShell snippet immediately after the bash snippet in the "Personal
Skills" section so Windows users have step-by-step parity with the Linux/macOS
instructions.


</details>

<!-- fingerprinting:phantom:triton:puma -->

<!-- This is an auto-generated comment by CodeRabbit -->


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
```
Comment on lines +118 to +121
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Provide Windows equivalents for update commands.

The Updating section only provides bash commands, inconsistent with the platform-specific approach used throughout the rest of the documentation. Windows users need equivalent PowerShell commands.

📝 Suggested fix to add Windows commands
 ## Updating
 
+**Linux/macOS:**
 ```bash
 cd ~/.gemini/antigravity/superpowers
 git pull

+Windows (PowerShell):
+powershell +cd "$env:USERPROFILE\.gemini\antigravity\superpowers" +git pull +

Symlinks automatically reflect the latest changes.

</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion
## Updating

**Linux/macOS:**
🤖 Prompt for AI Agents
In `@docs/README.antigravity.md` around lines 113 - 116, The README's Updating
section only shows Bash commands for pulling updates; add a Windows PowerShell
equivalent so Windows users have platform-specific instructions. Modify the code
block that currently contains the Bash snippet ("cd
~/.gemini/antigravity/superpowers" and "git pull") to include a second
subsection titled "Windows (PowerShell):" with the PowerShell commands to change
to the user's .gemini\antigravity\superpowers folder using $env:USERPROFILE and
run "git pull", keeping the existing Bash block intact and preserving the note
about symlinks.


Then re-copy the skills folder to your project.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Provide complete re-copy commands after update.

Line 110 instructs users to "re-copy the skills folder" but doesn't show how. This leaves users without clear next steps after pulling updates.

📝 Suggested fix to add platform-specific copy commands
-Then re-copy the skills folder to your project.
+Then re-copy the skills folder to your project:
+
+**Linux/macOS:**
+```bash
+cp -r ~/.gemini/antigravity/superpowers/skills .agent/skills
+```
+
+**Windows (PowerShell):**
+```powershell
+Copy-Item -Recurse -Force "$env:USERPROFILE\.gemini\antigravity\superpowers\skills" ".agent\skills"
+```
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Then re-copy the skills folder to your project.
Then re-copy the skills folder to your project:
**Linux/macOS:**
🤖 Prompt for AI Agents
In `@docs/README.antigravity.md` at line 110, Update the "Then re-copy the skills
folder to your project." instruction to include explicit platform-specific copy
commands: add a Unix/macOS/Linux cp command example to copy from
~/.gemini/antigravity/superpowers/skills into .agent/skills and a Windows
PowerShell Copy-Item -Recurse example using $env:USERPROFILE to source the same
path into .agent\skills so users have exact commands to run after pulling
updates.


## Getting Help

- Report issues: https://github.com/obra/superpowers/issues
- Main documentation: https://github.com/obra/superpowers
Comment on lines +127 to +128
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Use proper markdown link syntax for URLs.

Bare URLs should be formatted with markdown link syntax for better accessibility and rendering.

📝 Suggested fix
 ## Getting Help
 
-- Report issues: https://github.com/obra/superpowers/issues
-- Main documentation: https://github.com/obra/superpowers
+- [Report issues](https://github.com/obra/superpowers/issues)
+- [Main documentation](https://github.com/obra/superpowers)
🧰 Tools
🪛 markdownlint-cli2 (0.18.1)

114-114: Bare URL used

(MD034, no-bare-urls)


115-115: Bare URL used

(MD034, no-bare-urls)

🤖 Prompt for AI Agents
In `@docs/README.antigravity.md` around lines 114 - 115, Replace the bare URLs
with proper Markdown link syntax: change "Report issues:
https://github.com/obra/superpowers/issues" to use a labeled link like "Report
issues: [Superpowers issues](https://github.com/obra/superpowers/issues)" and
change "Main documentation: https://github.com/obra/superpowers" to a labeled
link like "Main documentation: [Superpowers
repo](https://github.com/obra/superpowers)"; ensure both links render correctly
in README.antigravity.md.