Skip to main content
Everything SuperAntigravity installs is plain Markdown files on your filesystem. You can edit any of them directly — no build step, no tooling required.

​
Where files are installed

The installer places files into three directories under ~/.gemini/antigravity/: A fourth file, ~/.gemini/GEMINI.md, holds the bootstrap block that instructs the agent to use SuperAntigravity at the start of every session.

​
Editing an existing skill

Each skill is a directory with a single SKILL.md file. The frontmatter controls when Antigravity loads it; the body controls what the agent does.
1

Find the skill

Navigate to the skill’s directory:
Each subdirectory is a skill. Open the one you want to change.
2

Edit SKILL.md

Open ~/.gemini/antigravity/skills/<skill-name>/SKILL.md in any editor and change the content. The description field in the frontmatter controls when the skill auto-triggers — edit it to change the matching behavior.
3

Restart Antigravity

Antigravity reads skills at the start of each session. Restart it for your changes to take effect.

​
Skill frontmatter format

Every SKILL.md starts with a YAML frontmatter block:
The description field is the most important part of a skill. Antigravity uses it to determine whether the skill applies to the current task. A well-written description means the skill fires at the right time; a vague one means it fires too often or not at all.

​
Creating a new skill

SuperAntigravity ships with a writing-skills skill that teaches the skill format and guides you through creating new ones. To use it, start a conversation in Antigravity and ask it to create a new skill — the writing-skills skill will load automatically and walk you through the process. You can also create a skill manually:
  1. Create a new directory under ~/.gemini/antigravity/skills/your-skill-name/
  2. Add a SKILL.md file with valid frontmatter and body content
  3. Restart Antigravity

​
Editing workflows

Slash commands like /brainstorm and /implement are backed by workflow files in ~/.gemini/antigravity/global_workflows/. Each file is a .md named after the command. To change what /implement does, edit ~/.gemini/antigravity/global_workflows/implement.md. Changes take effect after restarting Antigravity.

​
Customizing agents

Specialist agents live in ~/.gemini/antigravity/agents/. Each agent is a .md file describing the agent’s role, behavior, and constraints.
Edit any agent file to change how it reasons, what it focuses on, or how it formats output. Restart Antigravity after saving.

​
The GEMINI.md bootstrap block

During install, a block is appended to ~/.gemini/GEMINI.md starting with the marker # SuperAntigravity Skills. This block is what makes SuperAntigravity always-on: Antigravity reads GEMINI.md at the start of every session, so the agent always knows it has skills and must check them before acting. The block looks like this (abbreviated):
You can edit this block to change global agent behavior — for example, to adjust the skill priority rules or the red-flags table. It is plain Markdown and behaves like any other instruction in GEMINI.md.
If you edit the # SuperAntigravity Skills block manually and then run the installer again, it will detect the marker and skip re-adding the block. Run uninstall.sh first to remove the old block cleanly before reinstalling with a fresh copy.