Metadata-Version: 2.4
Name: agr
Version: 0.6.0
Summary: Agent Resources - A package and project manager for AI agents.
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">

# 🧩 agent-resources (agr)

**A package manager for AI agents.**

Install agent skills from GitHub with one command.

[![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)

</div>

---

## Getting Started

Install agr CLI:

```bash
pip install agr
```

Install your first skill:

```bash
agr add anthropics/skills/frontend-design
```

That's it. The skill is now available in Claude Code.

---

## What is agr?

**agr** installs agent skills from GitHub directly into your `.claude/skills/` folder.

**agrx** runs skills instantly from your terminal — one command, no setup.

---

## Install Skills

```bash
agr add anthropics/skills/frontend-design     # Install a skill
agr add anthropics/skills/pdf anthropics/skills/mcp-builder   # Install multiple
```

### Handle format

```
username/skill-name         → From user's agent-resources repo
username/repo/skill-name    → From a specific repo
./path/to/skill             → From local directory
```

---

## Run Skills From Your Terminal

```bash
agrx anthropics/skills/pdf                              # Run a skill instantly
agrx anthropics/skills/pdf -p "Extract tables from report.pdf"   # With a prompt
agrx anthropics/skills/skill-creator -i                 # Run, then continue chatting
```

---

## Team Sync

Your dependencies are tracked in `agr.toml`:

```toml
dependencies = [
    {handle = "anthropics/skills/frontend-design", type = "skill"},
    {handle = "anthropics/skills/brand-guidelines", type = "skill"},
]
```

Teammates run:

```bash
agr sync
```

---

## Create Your Own Skill

```bash
agr init my-skill
```

Creates `my-skill/SKILL.md`:

```markdown
---
name: my-skill
description: What this skill does.
---

# My Skill

Instructions for the agent.
```

Test it locally:

```bash
agr add ./my-skill
```

Share it:

```bash
# Push to GitHub, then others can:
agr add your-username/my-skill
```

---

## All Commands

| Command | Description |
|---------|-------------|
| `agr add <handle>` | Install a skill |
| `agr remove <handle>` | Uninstall a skill |
| `agr sync` | Install all from agr.toml |
| `agr list` | Show installed skills |
| `agr init` | Create agr.toml |
| `agr init <name>` | Create a new skill |
| `agrx <handle>` | Run skill temporarily |

---

## Community Skills

```bash
# Go development — @dsjacobsen
agr add dsjacobsen/golang-pro

# Drupal development — @madsnorgaard
agr add madsnorgaard/drupal-expert
```

**Built something?** [Share it here](https://github.com/kasperjunge/agent-resources/issues).

---

<div align="center">

[Documentation](https://kasperjunge.github.io/agent-resources/) · [MIT License](LICENSE)

</div>
