create-gemini-cli-subagents

Installation
SKILL.md

Create Gemini CLI Subagents

This skill provides the instructions for creating custom Subagents (specialist agents) within the Gemini CLI.

1. Agent Definition

Subagents are defined as Markdown files (.md) with YAML frontmatter. These files act as the system instructions for a new specialist agent that can be invoked as a tool.

Location

  • Project-level: .gemini/agents/*.md (shared with the team via git).
  • User-level: ~/.gemini/agents/*.md (personal agents available in all sessions).

File Format

The file MUST start with YAML frontmatter. The body of the markdown file becomes the agent's System Prompt.

Related skills

More from paulirish/dotfiles

Installs
7
GitHub Stars
4.3K
First Seen
Mar 15, 2026