Antigravity Skills
How Agent Skills work in Google Antigravity. Skill discovery, SKILL.md format, frontmatter fields, folder structure, progressive disclosure, and best practices for creating skills.
For official documentation, see Antigravity Skills. For rules and workflows, see Antigravity Rules & Workflows.
What Are Skills?
Skills are reusable packages of knowledge that enhance what the agent can do. Each skill includes:
- Instructions for handling a specific type of task
- Best practices and conventions to follow
- Optional scripts and resources for the agent to use
When you begin a conversation, the agent will show a list of available skills along with their names and descriptions. If a skill fits your task, the agent will read the full instructions and follow them.
Where Skills Live
Antigravity supports two places for skills:
Path: <workspace-root>/.agent/skills/<skill-folder>/
These are project-specific workflows like your team's deployment process, testing conventions, or specific patterns related to the codebase.
Creating a Skill
Frontmatter Fields
| Field | Required | Description |
|---|---|---|
| name | No | A unique identifier for the skill (lowercase, hyphens for spaces). Defaults to the folder name if not provided. |
| description | Yes | A clear description of what the skill does and when to use it. This is what the agent sees when deciding whether to apply the skill. |
Write your description in third person and include keywords that help the agent understand when the skill is relevant. For example: "Generates unit tests for Python code using pytest conventions."
Skill Folder Structure
While SKILL.md is the only required file, you can add more resources:
The agent can read these files while following your skill's instructions.
How the Agent Uses Skills
Skills follow a progressive disclosure pattern:
Discovery
When a conversation starts, the agent sees a list of available skills along with their names and descriptions.
Activation
If a skill seems relevant to your task, the agent reads the full SKILL.md content.
Execution
The agent follows the skill's instructions as it works on your task.
You don't need to specifically tell the agent to use a skill. It decides based on the context. However, you can mention a skill by name if you want to ensure it is used.
Best Practices
Example: A Code Review Skill
Selling Antigravity Skills on Skly
When creating skills for the Skly marketplace that target Google Antigravity:
- List "Antigravity" as a supported AI tool so buyers can find compatible skills.
- Follow the Agent Skills format — Antigravity expects
SKILL.mdwith YAML frontmatter. - Include example files — Antigravity's agent learns well from concrete demonstrations.
- Test with semantic matching — verify your skill's description triggers activation for the right prompts.
- Bundle scripts for reliability — use
scripts/for operations that need predictable behavior.