Skip to content
Back to search

agr

Educational package-manager project for AI agent skills. Not actively maintained.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/computerlovetech--agr/badge.svg)](/listings/computerlovetech--agr)

HTML

<a href="/listings/computerlovetech--agr"><img src="/api/listings/computerlovetech--agr/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

uv tool install agr

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 172 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # agr
  3. **The package manager for AI agents.**
  4. For teams who want to manage agent skills like software packages — the way npm,
  5. PyPI, and uv manage code. Install skills from any Git repo into Claude Code,
  6. Cursor, Codex, and more, then share them across your team like real dependencies.
  7. [![PyPI](https://img.shields.io/pypi/v/agr?color=blue)](https://pypi.org/project/agr/)
  8. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  9. [![Docs](https://img.shields.io/badge/docs-site-blue)](https://computerlovetech.github.io/agr/)
  10. </div>
  11. <p align="center">
  12. <img src="docs/images/demo.svg" alt="agr demo — install skills and list them" width="680">
  13. </p>
  14. ---
  15. ## Why agr
  16. agr is for **teams** who want to manage their agent skills as seriously as they
  17. manage their code — the way npm, PyPI, and uv manage software packages.
  18. Skills make AI agents better at your work. But today they're copied around by
  19. hand, drift between machines, and live in tool-specific folders. agr treats them
  20. like real dependencies: declared in one manifest, locked to a version, installed
  21. with one command, and identical for every teammate, on every machine, in every
  22. tool.
  23. That brings the same wins you already get from a package manager for code:
  24. - **Version & pin.** `agr.lock` records the exact version of every skill, so a
  25. skill that works today keeps working tomorrow — no silent upstream changes
  26. breaking your agents. Upgrade on purpose, when you choose, with `agr upgrade`.
  27. - **Distribute effortlessly.** Publishing a skill is just pushing to a Git repo;
  28. installing one is `agr add owner/repo/skill`. No registry to set up, no files
  29. to email around.
  30. - **One source of truth for the team.** The skills your agents use are part of
  31. your repo — reviewed in PRs, versioned in Git, and shared like any other
  32. dependency. Everyone runs the same skills, so your agents behave consistently
  33. across the whole team.
  34. - **Onboard in one command.** A new teammate clones the repo, runs `agr sync`,
  35. and their agents are set up exactly like everyone else's — same skills, same
  36. standards, day one.
  37. ## Install
  38. ```bash
  39. uv tool install agr
  40. ```
  41. ---
  42. ## What you can do with it
  43. Five things. That's the whole tool.
  44. ### 1. Install a skill from a Git repo
  45. ```bash
  46. agr add anthropics/skills/pdf
  47. ```
  48. Handles are just a path into GitHub: **`owner/repo/skill`**. `anthropics/skills/pdf`
  49. is the `pdf/` directory inside
  50. [github.com/anthropics/skills](https://github.com/anthropics/skills). Any public
  51. repo works — no registry, no publishing step.
  52. `agr add` auto-creates `agr.toml`, detects which AI tools you use, and installs
  53. the skill into each. Then invoke it in your tool:
  54. | Tool | Invoke with |
  55. |------|-------------|
  56. | Claude Code | `/pdf` |
  57. | Cursor | `/pdf` |
  58. | OpenAI Codex | `$pdf` |
  59. | OpenCode | `pdf` |
  60. | GitHub Copilot | `/pdf` |
  61. | Pi | `/pdf` |
  62. ### 2. Use your own local skills
  63. Point at a directory on disk instead of a repo:
  64. ```bash
  65. agr add ./skills/my-internal-skill
  66. ```
  67. Great for skills you're still writing, or ones that never leave your codebase.
  68. They sync into every tool exactly like remote skills.
  69. ### 3. Share one skill environment with your team
  70. `.claude/skills/`, `.cursor/skills/`, … are build artifacts — like `.venv/` or
  71. `node_modules/`. Add them to `.gitignore`. Commit **`agr.toml`** and
  72. **`agr.lock`** instead:
  73. ```toml
  74. tools = ["claude", "cursor"]
  75. dependencies = [
  76. {handle = "anthropics/skills/pdf", type = "skill"},
  77. {handle = "anthropics/skills/frontend-design", type = "skill"},
  78. {path = "./skills/my-internal-skill", type = "skill"},
  79. ]
  80. ```
  81. A new teammate clones the repo and runs:
  82. ```bash
  83. agr sync # like `npm install`, but for AI agents
  84. ```
  85. Now everyone has the same skills, the same standards, in every tool.
  86. ### 4. Keep skills up to date
  87. ```bash
  88. agr upgrade # all skills
  89. agr upgrade pdf # just one
  90. ```
  91. Re-fetches skills at their latest upstream version and updates `agr.lock`.
  92. ### 5. Try a skill without installing it
  93. ```bash
  94. agrx anthropics/skills/pdf
  95. ```
  96. Downloads and runs a skill once, then throws it away — nothing added to
  97. `agr.toml`, nothing left behind.
  98. ---
  99. ## All commands
  100. | Command | What it does |
  101. |---------|--------------|
  102. | `agr add <handle\|path>` | Install a skill and add it to `agr.toml` |
  103. | `agr remove <handle>` | Uninstall a skill |
  104. | `agr sync` | Install everything in `agr.toml` |
  105. | `agr upgrade [handle...]` | Re-fetch skills at their latest version |
  106. | `agr list` | Show installed skills |
  107. | `agrx <handle>` | Run a skill once, without installing |
  108. Add `-g` to `add`, `remove`, `sync`, or `list` to manage **global** skills,
  109. available across all your projects.
  110. ---
  111. ## Community skills
  112. ```bash
  113. agr add dsjacobsen/agent-resources/golang-pro # Go — @dsjacobsen
  114. agr add maragudk/skills/collaboration # Workflow — @maragudk
  115. agr add madsnorgaard/drupal-agent-resources/drupal-expert # Drupal — @madsnorgaard
  116. ```
  117. **Built something?** [Share it here.](https://github.com/computerlovetech/agr/issues)
  118. ---
  119. <div align="center">
  120. [Documentation](https://computerlovetech.github.io/agr/) · [MIT License](LICENSE)
  121. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.