How to Teach Antigravity New Skills

To teach me a new skill that persists across different sessions and folders, you can add it to your personal skills library.

1. Location

Skills are stored in your home directory under .gemini/antigravity/skills. I have just created this directory for you if it didn't exist: /Users/jenstandstad/.gemini/antigravity/skills

2. Structure

Each skill should be its own folder within the skills directory. The folder name should be the skill's identifier (e.g., react-best-practices or python-data-analysis).

Inside the skill folder, you MUST include a SKILL.md file.

Example structure:

/Users/jenstandstad/.gemini/antigravity/skills/
  └── my-custom-skill/
      ├── SKILL.md          (Required)
      ├── scripts/          (Optional: helper scripts)
      └── templates/        (Optional: code templates)

3. The `SKILL.md` Format

The SKILL.md file is the core of the skill. It must start with YAML frontmatter defining its name and description, followed by the markdown instructions.

Template:

---
name: [Skill Name]
description: [Short description of what this skill does and when I should use it]
---

# [Skill Name] Instructions

[Detailed instructions on how to perform the skill.]

## Guidelines
- Rule 1
- Rule 2

## Examples
...

4. How I Use Skills

When you ask me to perform a task, I will check your skills library. If a skill's description matches your request, I will read the SKILL.md file and follow its instructions.

Example: Creating a "Code Review" Skill

Create the folder: mkdir -p ~/.gemini/antigravity/skills/code-review
Create ~/.gemini/antigravity/skills/code-review/SKILL.md with:

---
name: Strict Code Review
description: Guidelines for performing a strict security and style validaton code review.
---

# Strict Code Review

When reviewing code, focus on:
1. **Security**: Check for injection vulnerabilities.
2. **Performance**: O(n^2) loops are banned.
3. **Style**: Use 4 spaces for indentation in Python.

Now, whenever you ask me to "review this code", I will apply these specific rules.

2.1 KiB Raw Permalink Blame History