# Agent Resources (agr)

> A package and project manager for AI agent skills.

## What This Is

agr is a CLI tool that lets developers install, share, and manage AI agent skills from GitHub.

## Quick Start

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

Run once without installing:

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

## Key Pages

- [Home](https://kasperjunge.github.io/agent-resources/site/) - Install and use skills
- [Creating Skills](https://kasperjunge.github.io/agent-resources/site/creating/) - Author your own
- [Reference](https://kasperjunge.github.io/agent-resources/site/reference/) - CLI commands and troubleshooting

## Common Commands

```bash
agr add user/skill         # Install from GitHub
agr add user/repo/skill    # From a specific repo
agr add ./path/to/skill    # Local path
agr remove user/skill      # Uninstall
agr sync                   # Install all dependencies
agr list                   # Show installed skills
agr init                   # Create agr.toml (auto-discovery)
agr init my-skill          # Create a skill scaffold
agrx user/skill            # Run temporarily
agrx user/skill -i         # Run, then continue chatting
```

## agr.toml Dependencies

Each dependency includes a `type`:

```toml
dependencies = [
    {handle = "user/skill", type = "skill"},
    {path = "./skills/my-skill", type = "skill"},
]
```

## Source Code

- GitHub: https://github.com/kasperjunge/agent-resources
- PyPI: https://pypi.org/project/agr/

## Related

- Skills Specification: https://agentskills.io/specification
- Example Skills: https://github.com/anthropics/skills

## License

MIT License
