Agent File Format

Markdown with YAML Frontmatter

A plain Markdown file beginning with a YAML frontmatter block (delimited by triple-dash lines) that carries the agent's name, description, tools, model, and other configuration. The body of the file is the agent's system prompt. Used by Claude Code and Gemini CLI.

Agent File Format

Referenced by

← Agent File Format

ClientAgents (cross-client default)The cross-client interoperable default. Any AI agent product that reads from the .agents/ tree can consume skills and agents deployed under this client. Pick…
ClientClaude CodeAnthropic's Claude Code CLI and desktop agent. Reads skills from .claude/skills/ and subagent definitions from .claude/agents/ at both project and user scopes.…
ClientGemini CLIGoogle's Gemini CLI. Reads subagent definitions from .gemini/agents/ as Markdown files with YAML frontmatter, the same format Claude Code uses. Skill discovery…