What is a Skill?
Skills are reusable packages of knowledge and instructions that help the agent perform specific tasks more effectively. They allow you to define:
Specialized Behaviors
Define specific workflows tailored to your project needs.
Project Knowledge
Encode domain-specific information the agent can reference.
Reusable Workflows
Share complex procedures across different projects.
Skill Structure
Skills are organized in folders and can be stored in two locations:
🏠 Workspace Skills
.agent/skills/<skill-folder>/Project-specific skills
🌍 Global Skills
~/.gemini/antigravity/skills/<skill-folder>/Available across all projects
Folder Structure
.agent/skills/my-skill/
├── SKILL.md # Required: Main instruction file
├── scripts/ # Optional: Implementation scripts
├── examples/ # Optional: Reference examples
└── resources/ # Optional: Additional dataSKILL.md Format
---
name: skill-name (optional)
description: A clear description of what the skill does and when to use it (required)
---
# Skill Instructions
Detailed instructions for the agent go here.Creating a Skill
Create a Folder
Place it in .agent/skills/ (workspace) or ~/.gemini/antigravity/skills/ (global).
Create SKILL.md
Define the skill's purpose in the YAML frontmatter's description field.
Write Instructions
Add specific, actionable guidelines in markdown format within the SKILL.md file.
How Skills Work
The agent manages skills through a mechanism called Progressive Disclosure:
1. Discovery
The agent scans all available skills and reads their names and descriptions.
2. Activation
When a task matches a skill's description, the agent "activates" it by loading the full SKILL.md content.
3. Application
The agent incorporates the skill's instructions into its reasoning process to complete the task.
Best Practices
Be Descriptive
A clear description is crucial for the discovery phase, as it's what the agent uses to decide whether to activate the skill.
Be Specific
Provide step-by-step instructions. Vague guidelines lead to inconsistent results.
Include Examples
Use the examples/ folder to show the agent the expected output format or behavior.
Decision Trees
For complex tasks, include sections that help the agent choose the best approach based on specific conditions.
Complete Example
Here's a complete example of a Code Review skill:
📍 Location: .agent/skills/code-review/SKILL.md
---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality.
---
# Code Review Skill
When reviewing code, follow these steps:
## Review checklist
1. **Correctness**: Does the code do what it's supposed to?
2. **Edge cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Are there obvious inefficiencies?
## How to provide feedback
- Be specific about what needs to change.
- Explain why, not just what.
- Suggest alternatives when possible.Superpowers Skills Library
Inspired by Claude Code Superpowers, we have built a complete development workflow skills library for Antigravity:
📋 Recommended Workflow
Planning
brainstormingIdea generation, requirement clarification & solution design
writing-plansCreate detailed implementation plans
Testing
test-driven-developmentRED-GREEN-REFACTOR TDD cycle
Debugging
systematic-debugging4-phase systematic root cause analysis
verification-before-completionThorough verification before task completion
Collaboration
code-reviewCode review checklist & feedback guidelines
Meta Skills
writing-skillsGuide on how to create new skills
using-superpowersIntroduction to the Superpowers system
🎉 We have built a complete Superpowers library for Antigravity!
⭐ GitHub: antigravity-superpowers →Clone to your .agent/ directory to start using them.
Ready to Create Your First Skill?
Start enhancing your Antigravity agent with custom skills tailored to your workflow.
Read Official Documentation→