retr0h/agentpack

โ˜… 0Forks 0GoGitHub โ†—Compare

README

agentpack

An open package format for AI agent skills.

release go report card license build codecov conventional commits built with just github commit activity agentskills.io

Install, manage, and distribute AI agent skills across Claude Code, Cursor, Copilot, Codex, Gemini CLI, Windsurf, Goose, Roo, Amp, Cline, and every agent supporting the .agents/ convention.

๐Ÿ“ฆ Install

curl -fsSL https://github.com/retr0h/agentpack/raw/main/install.sh | bash

๐Ÿ”จ Build from source

git clone https://github.com/retr0h/agentpack.git
cd agentpack
go build -o agentpack .

๐Ÿš€ Quick Start

agentpack search react                            # find skills
agentpack add owner/repo@skill-name               # add a skill
agentpack add owner/repo --skill foo --skill bar  # add multiple skills
agentpack add owner/repo --target claude-code     # add to specific target
agentpack add owner/repo -g                       # add globally
agentpack ls                                      # list installed
agentpack ls --targets                            # show detected agents
agentpack info owner/repo                         # package details
agentpack del owner/repo                          # delete a plugin
agentpack del owner/repo@skill-name               # delete a single skill
agentpack init my-skill                           # scaffold a new skill
agentpack build                                   # build .agentpack archives
agentpack install                                 # install from manifest

See Usage for full details.

โœจ Features

  • ๐Ÿ“ฆ .agentpack format โ€” one package, every agent. Typed metadata with skills, commands, hooks, MCP, agents, and config
  • ๐Ÿค– 50+ agents โ€” Claude Code, Cursor, Copilot, Codex, Gemini CLI, Windsurf, Goose, Roo, and more
  • ๐Ÿ”’ Content safety โ€” binary detection at build time, executable prompts at install
  • ๐Ÿ”„ Reproducible installs โ€” lockfile pins exact SHAs, install from manifest
  • ๐ŸŒ Global + local โ€” project-level or user-level installs (-g)
  • โš™๏ธ Config merging โ€” MCP servers, hooks, and settings merge into .claude/settings.json
  • โœˆ๏ธ No toolchain required โ€” .agentpack files install without git, npm, or Go
  • ๐Ÿ“‹ JSON everywhere โ€” -o json on every command for scripting
  • ๐Ÿ“š 55+ agents โ€” built-in drivers for Claude Code, Cursor, Copilot, Codex, and dozens more

๐Ÿ“ The .agentpack format

A .agentpack file is a gzipped tarball with typed metadata. Each entry declares its content type โ€” the driver for each agent installs only what it supports, wherever it belongs.

agentpack content types

Package authors write content once. Drivers install only the types they support. When an agent adds support for a new type, existing packages work automatically. See the full specification and the feature matrix.

๐Ÿ” Discover Skills

agentpack search react
agentpack search typescript
agentpack search security

Browse the full catalog at skills.sh.

๐Ÿ“– Documentation

๐Ÿ™ Acknowledgments

Agent detection paths and skill directory conventions inspired by vercel-labs/skills and the agentskills.io ecosystem.

๐Ÿ“„ License

MIT

Contributors

retr0hdependabot[bot]

Issues