skills-package-manager

The Next-Gen Package Manager for Agent Skills
Manage, install, and link SKILL.md-based skills from a single `skills.json` manifest.

Quick Start • Features • How It Works • Documentation

---

✨ Features

• 📌 Single-File Pins — Keep exact git commits and npm versions directly in skills.json.
• 🌐 Any Source, Any Skill — Mix local link:, versioned npm:, or direct git: repos with ease—even sub-folders within .tgz archives.
• 🚀 npx skills compatible — A seamless, drop-in replacement. Swap npx skills for npx skills-package-manager and unlock more power.
• 🔌 Native pnpm Integration — The pnpm-plugin-skills hooks directly into your install lifecycle for zero-effort synchronization.
• 🛡️ 100% Open & Private — Zero telemetry. No tracking. Purely client-side tooling that respects your privacy.
• 🧩 One Install, Multiple Agents — Stop folder duplication. Install once and link into .claude, .cursor, and custom agent directories simultaneously.

🚀 Quick Start

Initialize a project

# Create a new skills.json manifest
npx skills-package-manager init --yes

Add skills

# 🔍 Interactive — browse and select from a repo
npx skills-package-manager add rstackjs/agent-skills

# 🎯 Direct — specify skill by name
npx skills-package-manager add rstackjs/agent-skills --skill pr-creator
npx skills-package-manager add rstackjs/agent-skills -s pr-creator -s rspress-custom-theme

# 🔎 List without installing
npx skills-package-manager add rstackjs/agent-skills --list

# 📁 Local skill directory
npx skills-package-manager add link:./my-skills/my-skill

Install all skills

npx skills-package-manager install

🏗️ How It Works

SPM uses one manifest file to manage your agent's capabilities:

1. skills.json: The single source of truth where you declare pinned skill specifiers, installDir, and linkTargets.

📚 Documentation

Visit skills-package-manager.site for full documentation, API references, and architecture deep-dives.

🛠️ Development

pnpm install
pnpm build
pnpm test

📄 License

ISC © 2026 SoonIter

---

⬆ Back to Top

Made with ❤️ for the AI Agent Ecosystem