Agent Skills

Gemini CLI

How Gemini CLI finds, installs and reads a skill, from its own docs, checked 26 Oct 2026.


Where it looks for skills

ScopeFolders it reads
This project.gemini/skills/ and .agents/skills/
All your projects~/.gemini/skills/ and ~/.agents/skills/

From Gemini CLI’s own docs, checked 26 Oct 2026.


Install a skill

  • Copy the skill’s folder, with its SKILL.md at the top, into .gemini/skills/ in your project, or into ~/.gemini/skills/ for all your projects.
  • Keep the folder named exactly as the name field in its SKILL.md, as The skill folder explains.
  • On qai.io/skills, every skill’s page has the steps for Gemini CLI, starting from Install skills in Gemini CLI.

Fields it reads

Only the six fields every SKILL.md can hold; its docs name no fields of its own.

SKILL.md sets out the six fields and their limits.


Watch out for

  • When .agents/skills and .gemini/skills hold skills with the same name, the .agents/skills one wins.
  • gemini skills install fetches the latest commit; it has no option to pin a version.
  • In a running session, run /skills reload to pick up a new skill.
  • Google replaced Gemini CLI with Antigravity CLI for unpaid-tier and Google One users on 18 June 2026.