.agents/skills/*.md → /<skill-name>

Local or global markdown skills automatically become their own /<skill-name> slash commands.

A markdown file with frontmatter (name, description) plus agent instructions in .agents/skills/ at the workspace root gets compiled the next time agy starts and is then available as /<skill-name> in the prompt box. The same applies globally to markdown files in ~/.gemini/antigravity-cli/skills/ — these are automatically imported as a global slash command across all workspaces. Migrating from Gemini CLI changes the paths: workspace-local moves from .gemini/skills/ to .agents/skills/, global moves from ~/.gemini/skills/ to ~/.gemini/antigravity-cli/skills/.

✅ WHEN TO USE IT?

Turn a recurring workflow into its own command for the project

Add format-tests.md with frontmatter to .agents/skills/ so /format-tests shows up in the prompt box

Use a skill across every project

Put the skill file in ~/.gemini/antigravity-cli/skills/ instead

⛔ WHEN NOT TO?

Skills migrated from Gemini CLI still sit at the old path (.gemini/skills/ or ~/.gemini/skills/)

Antigravity CLI only recognizes skills at the new paths (.agents/skills/ or ~/.gemini/antigravity-cli/skills/) — the old paths are no longer picked up.

Better: Move the skill files to the new path manually (agy plugin import gemini only converts extensions, not loose skill files)

SOURCES

Antigravity CLI Doku: Plugins ↗ antigravity.google
Antigravity CLI Doku: Gemini CLI Migration ↗ antigravity.google