Metadata-Version: 2.4
Name: agr
Version: 0.8.4
Summary: Agent Resources - The package manager for AI agents. Built for teams.
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13.0
Requires-Dist: tomlkit>=0.12
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

<div align="center">

# agr

**The package manager for AI agents.**

Install, share, and sync agent resources across Claude Code, Cursor, Codex,
OpenCode, Copilot, and Antigravity — built for teams practicing Agentic
Engineering.

[![PyPI](https://img.shields.io/pypi/v/agr?color=blue)](https://pypi.org/project/agr/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Docs](https://img.shields.io/badge/docs-site-blue)](https://computerlovetech.github.io/agr/)

</div>

<p align="center">
  <img src="docs/images/demo.svg" alt="agr demo — install skills and list them" width="680">
</p>

---

## Getting Started

Install the CLI:

```bash
uv tool install agr
```

Install your first skill:

```bash
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:

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

---

## Built for teams

`agr` is built for teams practicing **Agentic Engineering** — where AI agents
are first-class members of your development workflow. Share a consistent set of
agent resources across every developer and every AI tool on your team.

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

```toml
dependencies = [
    {handle = "anthropics/skills/frontend-design", type = "skill"},
    {handle = "anthropics/skills/pdf", type = "skill"},
    {handle = "your-team/agent-resources/dev-workflow", type = "package"},
]
```

```bash
agr sync   # Like npm install, but for AI agents
```

New teammate? `agr sync` and they're productive on day one — same agents, same
skills, same standards.

---

## Create and share

```bash
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:

```python
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](https://computerlovetech.github.io/agr/sdk/) for
cache management, error handling, and the full API.

---

## Example skills

**Documents & data:**

```bash
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:**

```bash
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:**

```bash
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:**

```bash
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](https://computerlovetech.github.io/agr/skills/).

---

## 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 upgrade [handle...]` | Re-fetch deps past the pinned commit |
| `agr list` | Show installed skills |
| `agr init` | Create `agr.toml` (auto-detects tools) |
| `agr init <name>` | Create a new skill |
| `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

```bash
# 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
agr add maragudk/skills/collaboration
```

Browse all community skills in the [Skill Directory](https://computerlovetech.github.io/agr/skills/).

**Built something?** [Share it here.](https://github.com/computerlovetech/agr/issues)

---

<div align="center">

[Documentation](https://computerlovetech.github.io/agr/) · [Skill Directory](https://computerlovetech.github.io/agr/skills/) · [Tutorial](https://computerlovetech.github.io/agr/tutorial/) · [Python SDK](https://computerlovetech.github.io/agr/sdk/) · [MIT License](LICENSE)

</div>
