Gemini CLI Skills: Getting Started With SKILL.md
How to install and use SKILL.md skills with Google Gemini CLI — paths, setup, and cross-agent compatibility.
Google's Gemini CLI supports the SKILL.md standard, meaning the same skills that work in Claude Code and Codex CLI work here without modification. Here's how to set them up.
Quick Answer: Gemini CLI stores personal skills in
~/.gemini/skills/and project-specific skills in.gemini/skills/within the project root. Skills are directory-based, each containing aSKILL.mdfile, which is compatible across Claude Code and Codex CLI.
Where Gemini CLI stores skills
Personal skills: ~/.gemini/skills/
Project skills: .gemini/skills/ in your project root.
The directory structure is identical to Claude Code — each skill is a folder containing a SKILL.md file:
~/.gemini/skills/
├── code-reviewer/
│ └── SKILL.md
└── test-generator/
└── SKILL.md
Recommended skills
designing-hybrid-context-layers
by https://loreto.io · 16
Architects the right retrieval strategy for every query — teaching your agent wh…
ai-automation-qa-pack
by Roy Yuen · 10
Professional QA & UAT documentation generator for AI automation agencies and com…
World-Class Site & App Design
by Aman Garg · 10
Every AI-built UI looks generic and templated. This skill teaches your agent to…
Installing your first skill
# Create the skills directory
mkdir -p ~/.gemini/skills/
# Download a skill from Agensi
unzip code-reviewer.zip -d ~/.gemini/skills/
# Verify
ls ~/.gemini/skills/code-reviewer/SKILL.md
Start a new Gemini CLI session. The skill is active.
Cross-agent compatibility
Because Claude Code, Codex CLI, and Gemini CLI all use SKILL.md, you can share skills across all three with symlinks:
# Use Claude Code skills as the source of truth
ln -s ~/.claude/skills/ ~/.gemini/skills
ln -s ~/.claude/skills/ ~/.codex/skills
One set of skills, every agent. This is the core value of the SKILL.md open standard — no vendor lock-in.
Differences from Claude Code
The SKILL.md format is identical. The only differences:
- Skills path:
~/.gemini/skills/instead of~/.claude/skills/ - Underlying model: Gemini instead of Claude
- Activation behavior: May differ slightly in how aggressively skills are matched to tasks
Most skills work identically across agents. Occasionally a skill written with Claude-specific assumptions (referencing Claude's tool use patterns or XML formatting preferences) might behave slightly differently in Gemini CLI. Well-written skills that use generic instructions work everywhere.
Finding skills for Gemini CLI
Every skill on Agensi works with Gemini CLI. The marketplace marks skills with their compatible agents. Filter by "Universal" to see skills tested across multiple agents.
Browse Gemini CLI compatible skills at Agensi.
Keep reading
- How to Build an MCP Server That Serves SKILL.md Skills
- Claude Code Skills Not Working? Troubleshooting Guide
- AI Agent Security: How to Audit Skills and MCP Servers Before Installing (2026)
- Using Claude Code for DevOps Automation: Complete Guide (2026)
- How to Customize Your AI Coding Agent: Complete Guide (2026)