Skip to content

Supported Tools — Install Skills Across AI Coding Agents

Tldr

agr installs skills into Claude Code, Cursor, Codex, OpenCode, GitHub Copilot, and Antigravity. Target one or all — one agr add installs everywhere. Default: Claude Code only.

A skill is a directory containing a SKILL.md file with YAML frontmatter (name, description) and markdown instructions for an AI coding agent. When you run agr add, agr copies the skill into each configured tool's skills directory so the tool can discover and invoke it. A handle like anthropics/skills/pdf identifies a skill on GitHub. See Core Concepts for the full picture.

All Tools at a Glance

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

Target Multiple Tools at Once

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

agr config set tools claude cursor codex

Set: tools = claude, cursor, codex

Or during initial setup:

agr init --tools claude,cursor,codex

Created: agr.toml
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

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 (required for agrx to run skills with Codex):

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/, opencode.json, opencode.jsonc

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/, .github/copilot-instructions.md, .github/instructions/

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 .gemini/skills/
Global skills ~/.gemini/skills/
Instruction file GEMINI.md
CLI command — (no CLI available)
Skill invocation —
Detection signals .gemini/, .agents/

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. See Troubleshooting for details.

Keep Instruction Files in Sync Across Tools

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

Set: sync_instructions = true
Set: canonical_instructions = CLAUDE.md

See Configuration — Instruction Syncing for details.

Detection Signals

agr init auto-detects which tools you use by checking for these files and directories in your repo:

Tool Detection signals
Claude Code .claude/, CLAUDE.md
Cursor .cursor/, .cursorrules
OpenAI Codex .agents/, .codex
OpenCode .opencode/, opencode.json, opencode.jsonc
GitHub Copilot .github/copilot/, .github/skills/, .github/copilot-instructions.md, .github/instructions/
Antigravity .gemini/, .agents/

Any single signal is enough to detect a tool. Note that .agents/ is shared between Codex and Antigravity — see Troubleshooting if this causes unexpected results.

Override detection with --tools:

agr init --tools claude,codex

Add or Remove a Tool After Setup

To start syncing skills to an additional tool:

agr config add tools cursor

Added: cursor
Syncing 3 dependencies to new tools...
Installed: anthropics/skills/frontend-design (cursor)
Installed: anthropics/skills/pdf (cursor)
Installed: kasperjunge/commit (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

Removed: cursor
Deleted 3 skills from .cursor/skills/

This deletes installed skills

Removing a tool also deletes all skills from that tool's skills directory (e.g., .cursor/skills/). The skills remain installed in your other configured tools and can be reinstalled with agr config add tools cursor.

Automatic Directory Migrations

When tool directories change upstream, agr updates its install paths to match. If you have skills in an old location, agr sync, agr add, or agr remove automatically moves them — no manual steps needed.

Tool Old directory New directory When changed
Antigravity .agent/skills/ .gemini/skills/ Unreleased
OpenAI Codex .codex/skills/ .agents/skills/ 0.7.10
OpenCode .opencode/skill/ .opencode/skills/ 0.7.10
Cursor .cursor/skills/owner/repo/skill/ (nested) .cursor/skills/skill/ (flat) Unreleased

Global directories are migrated the same way (e.g., ~/.agent/skills/ → ~/.gemini/skills/).

If you see skills in the "Old directory" column, running agr sync will move them automatically.

One skill format works in every tool

All tools use the same skill format — a directory containing a SKILL.md file with YAML frontmatter. A skill written for one tool works in all the others. When you agr add a skill, the same files are copied into each configured tool's skills directory. See the Agent Skills Specification for full format details.

Next Steps