# Agy Customizations

> Comprehensive guide and reference for the Antigravity Customization System. Use to author skills, contextual rules, plugins, hooks, and MCP servers with correct priority loading.

- Skill: `pedroiff0/agy-customizations` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pedroiff0/agy-customizations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pedroiff0/agy-customizations/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: pedroiff0 (https://skillmd.com/u/pedroiff0)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/pedroiff0/agy-customizations

---


# Antigravity Customization System

This skill explains how customizations work within Antigravity (AGY), their discovery mechanisms, loading priorities, and best practices for creating skills, rules, plugins, and MCP servers.

## When to Use

- Writing new custom skills for Antigravity workspaces.
- Adding repository rules (`.agent/rules/*.md` or `AGENTS.md`).
- Configuring Model Context Protocol (MCP) servers (`~/.gemini/antigravity-cli/mcp/`).
- Building lifecycle hooks and terminal integration extensions.

## Discovery & Loading Priority

Customizations are discovered and merged in the following order of precedence (highest to lowest):

1. **Workspace Local**: `<workspace_root>/.agent/skills/`
2. **Global User**: `~/.gemini/antigravity-cli/skills/`
3. **Built-in System**: `antigravity-cli/builtin/skills/`

## Authoring Canonical SKILL.md

Every skill must have a root `SKILL.md` with standard YAML frontmatter with `name` and `description`.