ProfessorGPTProfessorGPT

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.md agent 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.md and 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.md

How 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.md

In 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.

Frequently asked questions

Does Gemini support SKILL.md skills?+
Yes. Gemini CLI (now part of the Antigravity CLI) supports the open Agent Skills SKILL.md format. Your skill files transfer between Gemini CLI and Antigravity unchanged.
Are Gemini Gems the same as agent skills?+
No. Gems are no-code custom chatbots built at gemini.google.com; they are not installable SKILL.md files. Gemini CLI / Antigravity skills are the SKILL.md-based agent skills this guide covers.
Where does Gemini store skills?+
Personal skills go in ~/.gemini/config/skills/ and project skills in .agents/skills/ (the same project folder Codex uses). There is no install command — placing the folder installs it; run /skills in the Antigravity CLI to list loaded skills.
Can I use the same skill in Claude and Codex?+
Yes — SKILL.md is an open standard. The same file installs into Claude (~/.claude/skills) and Codex (~/.agents/skills); only the install folder differs.

Build your skill now

Generate a standard SKILL.md in seconds — no YAML by hand.