agr — Skills for AI Agents¶

A package manager for AI agent skills. Install, share, and run skills across Claude Code, Cursor, Codex, OpenCode, Copilot, and Antigravity — with a single command.

Install¶

uv tool install agr

Add your first skill¶

agr add anthropics/skills/frontend-design

That's it. The skill is now installed in your tool's skills folder (handle format). Invoke it:

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 if it doesn't exist and detects which tools you use. You don't need to run agr init first.

Run a skill without installing¶

agrx anthropics/skills/pdf -p "Extract tables from report.pdf"

agrx downloads the skill, runs it with your tool, and cleans up. Nothing is saved to your project.

Sync skills across a team¶

Dependencies are tracked in agr.toml:

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

Teammates install everything with one command — see Teams for CI/CD setup:

agr sync

Create your own¶

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

See Creating Skills for the full guide.

Commands¶

Command	What it does
`agr add <handle>`	Install a skill
`agr add <handle> -o`	Update a skill to the latest version
`agr remove <handle>`	Uninstall a skill
`agr sync`	Install all dependencies from `agr.toml`
`agr list`	Show skills and installation status
`agr init`	Create `agr.toml` (auto-detects tools)
`agr init <name>`	Create a skill scaffold
`agr config <cmd>`	Manage tools, sources, and settings
`agrx <handle>`	Run a skill temporarily

Example skills¶

Documents & data — read, create, and transform office files:

agr add anthropics/skills/pdf              # Extract tables, summarize, 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 — build UIs and visual assets:

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 — build integrations and test apps:

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 — create skills and content:

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

Community skills — built and shared by the community:

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

Browse the full list at the Skill Directory or on GitHub. Built something? Share it here.

Next steps¶

I want to...	Go to
Get started from scratch	Tutorial — install agr, add skills, sync a team, and create your own
Understand how it works	Core Concepts — handles, tools, sources, scopes, and the install flow
Try a skill without installing	agrx — download, run, and clean up in one command
Set this up for my team	Teams — team sync, CI/CD, private repos
See what's available	Skill Directory — official and community skills
Use a specific AI tool	Supported Tools — Claude Code, Cursor, Codex, OpenCode, Copilot, Antigravity
Build my own skill	Creating Skills — write, test, and publish skills
Use agr in Python code	Python SDK — load, discover, and cache skills programmatically
Look up a command	CLI Reference — every command, flag, and option
Fix a problem	Troubleshooting — common errors and solutions
Feed these docs to an LLM	llms.txt — summary for AI tools · llms-full.txt — complete docs in one file