agr

A package manager for AI agent skills.

Install, share, and sync skills across Claude Code, Cursor, Codex, OpenCode, Copilot, and Antigravity — with a single command.

---

What are skills?

Skills are reusable instructions that teach AI coding agents how to perform specific tasks. Each skill is a SKILL.md file in a directory, published on GitHub:

---
name: code-reviewer
description: Reviews code for bugs, security issues, and best practices.
---

# Code Reviewer

When reviewing code changes, follow these steps:

1. Read every changed file completely before commenting
2. Check for bugs: null references, off-by-one errors, race conditions
3. Check for security issues: injection, auth bypass, data exposure
4. Verify error handling: are errors caught, logged, and surfaced?

Format each finding as:
- **File and line:** `src/auth.py:42`
- **Severity:** bug / security / style
- **Fix:** concrete code or approach to resolve it

Install it, and your AI agent gains a new capability — no prompt engineering each time. Without a package manager, you'd copy these files manually into each tool's config folder, keep them updated by hand, and hope your teammates have the same versions. agr automates all of that.

---

Getting Started

Install the CLI:

uv tool install agr       # recommended
# or: pipx install agr
# or: pip install agr

Install your first skill:

agr add anthropics/skills/frontend-design

Then invoke it in your AI tool:

Tool	Invoke with
Claude Code	/frontend-design
Cursor	/frontend-design
OpenAI Codex	$frontend-design
OpenCode	frontend-design
GitHub Copilot	/frontend-design
Antigravity	(via IDE)

No setup required — agr add auto-creates agr.toml and detects which tools you use.

---

Run a skill without installing

agrx downloads a skill, runs it with your tool's CLI, and cleans up. Nothing is saved to your project:

agrx anthropics/skills/pdf -p "Extract tables from report.pdf"
agrx anthropics/skills/skill-creator -i   # Interactive: skill + chat

---

Team sync

Dependencies are tracked in agr.toml — commit it, and teammates install everything with one command:

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

agr sync   # Like npm install, but for agent skills

---

Create and share

agr init my-skill                # Scaffold a new skill
# Edit my-skill/SKILL.md with your instructions
agr add ./my-skill               # Test locally
# Push to GitHub, then others can:
agr add your-username/my-skill

---

Python SDK

Use agr as a library to load, discover, and cache skills programmatically:

from agr import Skill, list_skills, skill_info

skill = Skill.from_git("anthropics/skills/code-review")
print(skill.prompt)   # SKILL.md contents
print(skill.files)    # Files in the skill directory

for info in list_skills("anthropics/skills"):
    details = skill_info(info.handle)
    print(f"{details.handle}: {details.description}")

See the SDK documentation for cache management, error handling, and the full API.

---

Example skills

Documents & data:

agr add anthropics/skills/pdf              # Read, extract, create PDFs
agr add anthropics/skills/docx             # Generate and edit Word documents
agr add anthropics/skills/xlsx             # Build and manipulate spreadsheets
agr add anthropics/skills/pptx             # Create and work with slide decks
agr add anthropics/skills/doc-coauthoring  # Structured doc co-authoring workflow

Design & frontend:

agr add anthropics/skills/frontend-design   # Production-grade interfaces
agr add anthropics/skills/canvas-design     # Visual art in PNG and PDF
agr add anthropics/skills/algorithmic-art   # Algorithmic art with p5.js
agr add anthropics/skills/theme-factory     # Style artifacts with themes
agr add anthropics/skills/brand-guidelines  # Anthropic brand colors and typography

Development:

agr add anthropics/skills/claude-api             # Build apps with the Claude API
agr add anthropics/skills/mcp-builder            # Create MCP servers
agr add anthropics/skills/web-artifacts-builder  # Multi-component HTML artifacts
agr add anthropics/skills/webapp-testing         # Test web apps with Playwright

Productivity:

agr add anthropics/skills/skill-creator     # Create, modify, and improve skills
agr add anthropics/skills/internal-comms    # Write internal communications
agr add anthropics/skills/slack-gif-creator # Create animated GIFs for Slack

Browse the full list in the Skill Directory.

---

All commands

Command	Description
agr add <handle>	Install a skill
agr add <handle> -o	Update to the latest version
agr remove <handle>	Uninstall a skill
agr sync	Install all from agr.toml
agr list	Show installed skills
agr init	Create agr.toml (auto-detects tools)
agr init <name>	Create a new skill
agr onboard	Interactive guided setup
agr config <cmd>	Manage configuration
agrx <handle>	Run a skill temporarily

Add -g to add, remove, sync, or list for global skills (available in all projects).

---

Community skills

# Go — @dsjacobsen
agr add dsjacobsen/agent-resources/golang-pro

# Drupal & DevOps — @madsnorgaard
agr add madsnorgaard/drupal-agent-resources/drupal-expert
agr add madsnorgaard/drupal-agent-resources/drupal-security
agr add madsnorgaard/drupal-agent-resources/drupal-migration
agr add madsnorgaard/drupal-agent-resources/ddev-expert
agr add madsnorgaard/drupal-agent-resources/docker-local

# Workflow — @maragudk, @kasperjunge
agr add maragudk/skills/collaboration
agr add kasperjunge/commit-work
agr add kasperjunge/agent-resources/migrate-to-skills

Browse all community skills in the Skill Directory.

Built something? Share it here.

---

Documentation · Skill Directory · Tutorial · Python SDK · MIT License