skillpm

<p align="center">
  <strong>skillpm</strong><br>
  <em>The universal package manager for AI agent skills</em>
</p>

<p align="center">
  <a href="https://github.com/eddieran/skillpm/actions/workflows/ci.yml"><img src="https://github.com/eddieran/skillpm/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  <a href="https://github.com/eddieran/skillpm/actions/workflows/security.yml"><img src="https://github.com/eddieran/skillpm/actions/workflows/security.yml/badge.svg" alt="Security"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-green.svg" alt="License"></a>
</p>

---

Install skills once, inject everywhere. **skillpm** gives you verified injection for Cursor, Codex, Cursor, Cursor, OpenCode, Kiro, and OpenClaw, plus best-effort adapters for Antigravity, Cursor, and TRAE — with atomic installs, rollback-safe sync, project-scoped manifests, bundled official skills, and no required control plane.

## Install

```bash
brew tap eddieran/tap && brew install skillpm
```

Or build from source:

```bash
make build && ./bin/skillpm --help
```

## Usage

```bash
# Install directly from any Git URL
skillpm install https://github.com/anthropics/skills/tree/main/skills/skill-creator --force

# Or register a reusable source, then search and install
skillpm source add my-repo https://github.com/org/skills.git --kind git
skillpm source update my-repo
skillpm search --source my-repo "code-review"
skillpm install my-repo/code-review

# Inject into one or all configured agents
skillpm inject --agent cursor
skillpm inject --agent codex
skillpm inject --all

# Uninstall a skill
skillpm uninstall my-repo/code-review

# Review planned sync risk before applying changes
skillpm sync --dry-run --json
skillpm sync --strict
skillpm sync

# Self-healing diagnostics
skillpm doctor

# Create a new skill from template
skillpm create my-skill --template prompt

# Publish a skill to ClawHub
skillpm publish ./my-skill --version 1.0.0

# Manage project-scoped bu