Supported Tools¶

agr installs skills into 6 AI coding tools. You can target one tool or multiple tools simultaneously — one agr add installs everywhere.

At a Glance¶

Tool	Config name	Project skills dir	Global skills dir	agrx CLI
Claude Code	`claude`	`.claude/skills/`	`~/.claude/skills/`	`claude`
Cursor	`cursor`	`.cursor/skills/`	`~/.cursor/skills/`	`agent`
OpenAI Codex	`codex`	`.agents/skills/`	`~/.agents/skills/`	`codex`
OpenCode	`opencode`	`.opencode/skills/`	`~/.config/opencode/skills/`	`opencode`
GitHub Copilot	`copilot`	`.github/skills/`	`~/.copilot/skills/`	`copilot`
Antigravity	`antigravity`	`.agent/skills/`	`~/.gemini/antigravity/skills/`	—

Configuring Your Tools¶

By default, agr targets Claude Code only. To install skills into multiple tools at once:

agr config set tools claude cursor codex

Or during initial setup:

agr init --tools claude,cursor,codex

After this, every agr add and agr sync installs skills into all configured tools simultaneously.

Claude Code¶

Claude Code is Anthropic's AI coding agent that runs in your terminal.


Config name	`claude`
Project skills	`.claude/skills/`
Global skills	`~/.claude/skills/`
Instruction file	`CLAUDE.md`
CLI command	`claude`
Skill invocation	`/skill-name`
Detection signals	`.claude/`, `CLAUDE.md`

Claude Code is the default tool. If you only use Claude Code, no extra configuration is needed — agr add and agrx work out of the box.

Official docs: Skills · Slash commands · Sub-agents

Cursor¶

Cursor is an AI-first code editor built on VS Code.


Config name	`cursor`
Project skills	`.cursor/skills/`
Global skills	`~/.cursor/skills/`
Instruction file	`AGENTS.md`
CLI command	`agent`
Skill invocation	`/skill-name`
Detection signals	`.cursor/`, `.cursorrules`

Nested directory structure

Cursor uses nested directories for skills (e.g., .cursor/skills/owner/repo/skill-name/). agr handles this automatically — you use the same agr add user/skill command regardless of tool.

Official docs: Skills · Commands · Sub-agents · Rules

OpenAI Codex¶

OpenAI Codex is OpenAI's coding agent that runs in your terminal.


Config name	`codex`
Project skills	`.agents/skills/`
Global skills	`~/.agents/skills/`
Instruction file	`AGENTS.md`
CLI command	`codex`
Skill invocation	`$skill-name`
Detection signals	`.agents/`, `.codex`

Install the Codex CLI:

npm i -g @openai/codex

Official docs: Skills · Custom prompts

OpenCode¶

OpenCode is an open-source AI coding agent for the terminal.


Config name	`opencode`
Project skills	`.opencode/skills/`
Global skills	`~/.config/opencode/skills/`
Instruction file	`AGENTS.md`
CLI command	`opencode`
Skill invocation	`skill-name` (no prefix)
Detection signals	`.opencode/`

Global path

OpenCode uses ~/.config/opencode/skills/ for global skills, which differs from the project path pattern (.opencode/skills/).

Official docs: Skills · Commands · Agents

GitHub Copilot¶

GitHub Copilot is GitHub's AI coding assistant, available in VS Code, JetBrains, and the CLI.


Config name	`copilot`
Project skills	`.github/skills/`
Global skills	`~/.copilot/skills/`
Instruction file	`AGENTS.md`
CLI command	`copilot`
Skill invocation	`/skill-name`
Detection signals	`.github/copilot`, `.github/skills`

Asymmetric paths

Copilot uses .github/skills/ for project skills but ~/.copilot/skills/ for global skills. agr handles this automatically.

Official docs: Agent skills

Antigravity¶

Antigravity is Google's AI coding agent (powered by Gemini).


Config name	`antigravity`
Project skills	`.agent/skills/`
Global skills	`~/.gemini/antigravity/skills/`
Instruction file	`GEMINI.md`
CLI command	— (no CLI available)
Skill invocation	—
Detection signals	`.agent/`

No CLI support

Antigravity does not have a standalone CLI, so agrx cannot run skills with this tool. Use agr add to install skills, then use them through the Antigravity interface.

Instruction File Syncing¶

Each tool uses a different instruction file:

Instruction file	Tools
`CLAUDE.md`	Claude Code
`AGENTS.md`	Cursor, Codex, OpenCode, Copilot
`GEMINI.md`	Antigravity

When you use multiple tools, you can keep these files in sync automatically. Set a canonical file and agr copies its content to the others on agr sync:

agr config set sync_instructions true
agr config set canonical_instructions CLAUDE.md

See Configuration — Instruction Syncing for details.

Auto-Detection¶

When you run agr init or agr onboard, agr detects which tools you use by looking for their config directories and instruction files in your repo:

agr init   # Detects tools from .claude/, CLAUDE.md, .cursor/, .cursorrules, etc.

You can override the detected tools with --tools:

agr init --tools claude,codex,opencode

Adding a New Tool Later¶

To start syncing skills to an additional tool after initial setup:

agr config add tools cursor

This automatically installs all existing dependencies into the new tool — no separate agr sync needed.

To stop syncing to a tool:

agr config remove tools cursor

Skill Format Compatibility¶

All tools use the same skill format — a directory containing a SKILL.md file with YAML frontmatter. See the Agent Skills Specification for the full format details.

This means a skill written for one tool works in all the others. When you agr add a skill, the same SKILL.md and supporting files are copied into each configured tool's skills directory.