
[](https://www.npmjs.com/package/@itsmeyaw/skillset)
[](https://github.com/itsmeyaw/skillset/actions/workflows/ci.yml)
[](https://nodejs.org)
[](LICENSE)
[Features](#features) • [Installation](#installation) • [Quick start](#quick-start) • [Commands](#commands) • [Skillset file](#skillset-file-format)
Skillset is a CLI for curating agent skills into a pinned, shareable list and installing that list into any project in one step. It wraps [Vercel's Skills CLI](https://github.com/vercel-labs/skills) ([skills.sh](https://skills.sh)), so skills land in the same agent directories and the same `skills-lock.json` file that `npx skills` uses.
## Features
- **Pinned to commits**: every skill records the exact Git commit it came from, so an install gives you exactly what you reviewed until you run `update`.
- **One list, every project**: keep a named Skillset in your home directory, or commit `./skillset.json` so your team shares it.
- **Mix sources**: combine skills from several repositories, branches, tags, or Git URLs into one Skillset.
- **Works with your agents**: installs for Universal agents (`.agents/skills`), Claude Code, and any detected agent by default, or for any agent you pick.
- **Interactive or scripted**: run a command without arguments to be prompted, or pass flags. `-y` skips every prompt.
- **Safe by default**: an install only adds skills. Skills that aren't in the Skillset are never removed.
## Installation
You need [Node.js](https://nodejs.org) 22.20.0 or later and [Git](https://git-scm.com).
```sh
npm install -g @itsmeyaw/skillset
```
Or run it without installing:
```sh
npx @itsmeyaw/skillset --help
```
## Quick start
Build your Skillset once, then install it in every project.