Skip to main content
Gemini CLI is Google’s terminal coding agent. Project skills use the vendor-neutral .agents/skills convention; global skills live under ~/.gemini/skills.

Paths

ResourcePath
Project skills.agents/skills (generic fallback)
Global skills~/.gemini/skills
MCP config~/.gemini/settings.json
Audit search (project).agents/skills, .github/skills, .claude/skills
Audit search (global)~/.gemini/skills, ~/.agents/skills, ~/.copilot/skills
Package-manager search~/.gemini/extensions

Skills example

gaal.yaml
skills:
  - source: anthropics/skills
    agents: [gemini-cli]
    global: true

MCP example

gaal.yaml
mcps:
  - name: filesystem
    target: ~/.gemini/settings.json
    inline:
      command: uvx
      args: [mcp-server-filesystem, ~/projects]

Configure skills

Configure MCP servers