skills-package-manager

The Next-Gen Package Manager for Agent Skills

Seamlessly manage, install, and link AI agent skills with lockfile-driven reproducibility and multi-protocol support.

1{
2  "$schema": "https://unpkg.com/skills-package-manager@0.9.0/skills.schema.json",
3  "installDir": ".agents/skills",
4  "linkTargets": [".claude/skills", ".cursor/skills"],
5  "selfSkill": false,
6  "skills": {
7    "pr-creator": "https://github.com/rstackjs/agent-skills.git#89bd10a...&path:/skills/pr-creator",
8    "npm-skill": "npm:@scope/agent-logic@^1.2.0",
9    "custom-dev": "link:./packages/my-custom-skill",
10    "local-dev": "local:./.agents/skills/local-dev",
11    "legacy-v1": "file:./backups/old-agent.tgz"
12  }
13}

Get Started Instantly

Choose your workflow and copy the command to your terminal or your AI agent.

CLI Setup

npx skills-package-manager init --yes
npx skills-package-manager add <skill-name>
npx skills-package-manager install

pnpm Plugin

pnpm add pnpm-plugin-skills --config

npm / yarn / bun

npm install -D skills-package-manager
# In package.json:
# "prepare": "skills-package-manager install"

Why skills-package-manager?

Designed specifically to handle the complexities of managing AI agent skills seamlessly.

Lockfile-Driven Versioning

Ditch heavy git commits. `skills-lock.yaml` ensures every team member and CI/CD environment runs on identical skill versions.

Any Source, Any Skill

Mix local `link:` or `local:`, 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 today.

Native pnpm Integration

The `pnpm-plugin-skills` hooks directly into your install lifecycle for zero-effort, automatic skill synchronization.

100% Open & Private

Zero telemetry. No tracking. Purely client-side tooling that respects your privacy and works with any registry.

One Install, Multiple Agents

Stop folder duplication. Install once and simultaneously link into `.claude`, `.cursor`, and custom agent directories.

Core Concepts

Two simple files power your entire workflow.

skills.json: The Manifest

The single source of truth for your required skills across any protocol.

skills-lock.yaml: The Lockfile

Locks dependencies to ensure deterministic, reproducible installations every time.

Ready to take control of your agent skills?

Start building robust, reproducible AI workflows today.

Read the Documentation