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
| Scope | Folders 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.