Gemini CLI Skills: How to Create a Gemini Agent Skill (SKILL.md)
Gemini CLI and Google Antigravity support agent skills in the open SKILL.md format. This guide shows how to write one, where Gemini looks for skills, how to install it, and why Gemini "Gems" are a different thing.
Does Gemini support SKILL.md? Gemini CLI and Antigravity
Yes. Gemini CLI adopted the open Agent Skills SKILL.md format, so the same skill you write for Claude or Codex also runs in Gemini. Note the tooling shift: Google retired the standalone Gemini CLI in June 2026 and folded it into the Antigravity CLI — your SKILL.md files transfer unchanged, so everything here applies to both.
Gemini CLI skills vs Gemini Gems vs Antigravity
These sound alike but are not the same:
- Gemini CLI / Antigravity skills — installable
SKILL.mdagent skills that extend the CLI. This is what this guide covers. - Gemini Gems — a no-code custom chatbot you build at gemini.google.com. A Gem is not an installable
SKILL.mdand can't be shared as a file. If you searched "Gemini Gems," that's a different product. - Antigravity — the current home of the CLI; the skills model is the same.
What is a Gemini Agent Skill?
A folder with a SKILL.md: YAML frontmatter (a kebab-case name and a description of what it does + when to trigger) plus a markdown body of instructions. New to the concept? Read what agent skills are.
Where Gemini CLI / Antigravity skills live
Since the move to Antigravity, skills load from two places: personal skills in ~/.gemini/config/skills/ (available everywhere) and project skills in .agents/skills/ inside a repo — the same project folder Codex uses:
mkdir -p ~/.gemini/config/skills/pr-summary
# add ~/.gemini/config/skills/pr-summary/SKILL.mdHow to create a Gemini CLI skill step by step
Follow the steps below, then install and run it.
Install and run your skill
There is no install subcommand — a skill is "installed" by placing its folder in a skills directory. Drop it in ~/.gemini/config/skills/ (personal) or .agents/skills/ (project):
# personal: ~/.gemini/config/skills/pr-summary/SKILL.md
# project: .agents/skills/pr-summary/SKILL.mdIn the Antigravity CLI (agy), run /skills to list the skills it has loaded. Once it's there, the agent invokes the skill automatically when a task matches its description.
A complete Gemini SKILL.md you can copy
---
name: pr-summary
description: Summarizes a pull request into a short review-ready overview. Use when the user asks to summarize a PR or diff.
---
# PR Summary
1. Read the diff and the PR description.
2. Summarize the intent in one or two sentences.
3. List notable changes grouped by area.
4. Call out anything risky a reviewer should check first.One SKILL.md, every agent: portability
The same file works in Gemini CLI / Antigravity, Claude Code (~/.claude/skills), and Codex (~/.agents/skills). Write once, run anywhere — that's the point of the open standard.
Build a Gemini skill without hand-writing YAML
Use the free Skill Builder to generate a standard SKILL.md that installs into Gemini, Claude, and Codex, or browse ready-made skills.