Class

Client

An AI agent runtime or product that discovers and uses skills (and, from 1.2.0, agent/subagent definitions) from known on-disk locations. Each Client instance declares the path patterns the product uses for project-scoped and user-scoped skills and agents, plus the file format the product reads for agent definitions. Installers use this to deploy a Skill or an Agent to the correct directory for whatever client the user has chosen. Clients whose skill layout is undocumented default to the cross-client .agents/skills convention.

Class

Instances 4

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…
ClientOpenAI CodexOpenAI's Codex CLI. Reads skills from the cross-client .agents/skills/ tree and reads subagent definitions from .codex/agents/ as TOML files. The TOML schema…

Referenced by

← Domain

Object PropertyAgent File FormatThe on-disk file format this client reads for agent definitions. Installers must write each Agent in this format when deploying to this client. Named…
Datatype PropertyClient IDShort identifier used on the command line to select a client when installing a skill or agent (e.g., "agents", "claude-code", "codex", "gemini"). Lowercase…
Datatype PropertyProject Agent DirectoryRelative directory path, from the project root, where this client expects project-scoped agent (subagent) definitions to live. The installer writes one file…
Datatype PropertyProject Skill DirectoryRelative directory path, from the project root, where this client expects project-scoped skills to live. The installer appends the skill's name to this path to…
Datatype PropertySkill File NameFile name the client reads to discover a skill's frontmatter and instructions inside each skill directory. Defaults to "SKILL.md" for clients that follow the…
Datatype PropertyUser Agent DirectoryDirectory path, rooted at the user home directory, where this client expects user-scoped agent definitions to live. The literal "~" at the start is expanded to…
Datatype PropertyUser Skill DirectoryAbsolute-ish directory path, rooted at the user home directory, where this client expects user-scoped skills to live. The literal "~" at the start is expanded…

← Range

Object PropertyTarget ClientOptional. Restricts this agent to a specific client or set of clients (e.g., only claude-code because the instructions rely on a Claude Code feature). When…agents@1.0.0