skills-package-manager

The Next-Gen Package Manager for Agent Skills

Seamlessly manage, install, and link AI agent skills from a single skills.json manifest.

1{
2  "$schema": "https://unpkg.com/skills-package-manager@0.10.0/skills.schema.json",
3  "installDir": ".agents/skills",
4  "linkTargets": [".claude/skills", ".cursor/skills"],
5  "selfSkill": false,
6  "skills": {
7    "pr-creator": "github:rstackjs/agent-skills#89bd10a&path:/skills/pr-creator",
8    "npm-skill": "npm:@scope/agent-logic@1.2.0&path:skills/agent-logic",
9    "custom-dev": "link:./packages/my-custom-skill",
10    "local-dev": "local:*",
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.

Single-File Pins

Keep exact GitHub commits, npm versions, local links, install directories, and agent link targets in `skills.json`.

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

One manifest powers your entire workflow.

skills.json: The Manifest

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

Pinned Specifiers

`add` and `update` write resolved git commits and npm versions back to the manifest.

Ready to take control of your agent skills?

Start building robust, reproducible AI workflows today.

Read the Documentation