Why agr

agr is for teams who want to manage their agent skills as seriously as they manage their code — the way npm, PyPI, and uv manage software packages.

Skills make AI agents better at your work. But today they're copied around by hand, drift between machines, and live in tool-specific folders. agr treats them like real dependencies: declared in one manifest, locked to a version, installed with one command, and identical for every teammate, on every machine, in every tool.

That brings the same wins you already get from a package manager for code:

• Version & pin. agr.lock records the exact version of every skill, so a skill that works today keeps working tomorrow — no silent upstream changes breaking your agents. Upgrade on purpose, when you choose, with agr upgrade.
• Distribute effortlessly. Publishing a skill is just pushing to a Git repo; installing one is agr add owner/repo/skill. No registry to set up, no files to email around.
• One source of truth for the team. The skills your agents use are part of your repo — reviewed in PRs, versioned in Git, and shared like any other dependency. Everyone runs the same skills, so your agents behave consistently across the whole team.
• Onboard in one command. A new teammate clones the repo, runs agr sync, and their agents are set up exactly like everyone else's — same skills, same standards, day one.

Install

uv tool install agr

What you can do with it

Five things. That's the whole tool.

1. Install a skill from a Git repo

agr add anthropics/skills/pdf

Handles are just a path into GitHub: owner/repo/skill. anthropics/skills/pdf is the pdf/ directory inside github.com/anthropics/skills. Any public repo works — no registry, no publishing step.

agr add auto-creates agr.toml, detects which AI tools you use, and installs the skill into each. Then invoke it in your tool:

2. Use your own local skills

Point at a directory on disk instead of a repo:

agr add ./skills/my-internal-skill

Great for skills you're still writing, or ones that never leave your codebase. They sync into every tool exactly like remote skills.

3. Share one skill environment with your team

.claude/skills/, .cursor/skills/, … are build artifacts — like .venv/ or node_modules/. Add them to .gitignore. Commit agr.toml and agr.lock instead:

tools = ["claude", "cursor"]

dependencies = [
    {handle = "anthropics/skills/pdf", type = "skill"},
    {handle = "anthropics/skills/frontend-design", type = "skill"},
    {path = "./skills/my-internal-skill", type = "skill"},
]

A new teammate clones the repo and runs:

agr sync   # like `npm install`, but for AI agents

Now everyone has the same skills, the same standards, in every tool.

4. Keep skills up to date

agr upgrade            # all skills
agr upgrade pdf        # just one

Re-fetches skills at their latest upstream version and updates agr.lock.

5. Try a skill without installing it

agrx anthropics/skills/pdf

Downloads and runs a skill once, then throws it away — nothing added to agr.toml, nothing left behind.

All commands

Add -g to add, remove, sync, or list to manage global skills, available across all your projects.

Community skills

agr add dsjacobsen/agent-resources/golang-pro              # Go — @dsjacobsen
agr add maragudk/skills/collaboration                      # Workflow — @maragudk
agr add madsnorgaard/drupal-agent-resources/drupal-expert  # Drupal — @madsnorgaard

Built something? Share it here.