Note: Support for rules, subagents, and slash commands has been removed. Most AI coding agents are converging on skills as the standard format, so agr now focuses exclusively on skills. To convert your existing rules, commands, or subagents to skills, run:

agrx kasperjunge/migrate-to-skills
agrx kasperjunge/migrate-to-skills -p "convert files in ./my-commands"

Install agr CLI:

pip install agr

Install your first skill:

agr add anthropics/skills/frontend-design

That's it. The skill is now available in your configured tool (Claude Code, Codex, Cursor, OpenCode, Copilot, or Antigravity).

agr installs agent skills from GitHub directly into your tool's skills folder (.claude/skills/, .codex/skills/, .cursor/skills/, .opencode/skill/, .github/skills/, or .agent/skills/).

agrx runs skills instantly from your terminal — download, run, then clean up.

agr add anthropics/skills/frontend-design     # Install a skill
agr add -g anthropics/skills/frontend-design  # Install globally for your user
agr add anthropics/skills/pdf anthropics/skills/mcp-builder   # Install multiple
agr add anthropics/skills/pdf --source github # Install from an explicit source

Remote installs require git to be available on your system.

Beta note: Multi-source support is only in the beta release right now. Install agr==0.7.2b1 to use default_source, [[source]], or --source.

username/skill-name         → From user's skills repo
username/repo/skill-name    → From a specific repo
./path/to/skill             → From local directory

Note: username/skill-name now defaults to a repo named skills. During a deprecation period, agr will fall back to agent-resources (with a warning) if the skill isn't found in skills.

agrx anthropics/skills/pdf                              # Run a skill instantly
agrx anthropics/skills/pdf -p "Extract tables from report.pdf"   # With a prompt
agrx anthropics/skills/skill-creator -i                 # Run, then continue chatting
agrx anthropics/skills/pdf --source github              # Explicit source

Your dependencies are tracked in agr.toml:

default_source = "github"

dependencies = [
    {handle = "anthropics/skills/frontend-design", type = "skill"},
    {handle = "anthropics/skills/brand-guidelines", type = "skill"},
]

[[source]]
name = "github"
type = "git"
url = "https://github.com/{owner}/{repo}.git"

Note: dependencies must appear before any [[source]] blocks in agr.toml.

Teammates run:

agr sync

agr init my-skill

Creates my-skill/SKILL.md:

---
name: my-skill
description: What this skill does.
---

# My Skill

Instructions for the agent.

If you're adding it to this repo, place it under ./skills/.

Test it locally:

agr add ./skills/my-skill

Share it:

# Push to GitHub, then others can:
agr add your-username/my-skill

agr init can discover skills in your repo and add them to agr.toml.

agr init       # Auto-discover skills and create agr.toml
agr init -i    # Guided setup

Skills inside tool folders (e.g. .claude/skills/, .codex/skills/, .cursor/skills/, .opencode/skill/, .github/skills/, .agent/skills/) are ignored by default. To bring them into ./skills/, run:

agr init --migrate

# Go development — @dsjacobsen
agr add dsjacobsen/golang-pro

# Drupal development — @madsnorgaard
agr add madsnorgaard/drupal-expert

Built something? Share it here.