Skip to content
Skillset

Curate your agent skills once. Install them in every project.

npm install -g @itsmeyaw/skillset

Or try it first with npx @itsmeyaw/skillset --help.

Then two commands

  1. skillset add --set my-setSave skills from any repository as a list.
  2. skillset install my-setInstall that list in the current project.

Stop reinstalling skills

In each project you run npx skills add for every source, pick the same skills again, and get whatever commit is latest that day.

Without Skillset
cd ~/projects/apinpx skills add mattpocock/skills --skill grilling tddnpx skills add juliusbrussee/caveman --skill cavemancd ~/projects/webnpx skills add mattpocock/skills --skill grilling tddnpx skills add juliusbrussee/caveman --skill cavemancd ~/projects/docsnpx skills add mattpocock/skills --skill grilling tddnpx skills add juliusbrussee/caveman --skill caveman
6 installs, each at whatever commit is latest.
With Skillset
cd ~/projects/apiskillset install my-setcd ~/projects/webskillset install my-setcd ~/projects/docsskillset install my-set
3 installs, each at the pinned commits 9b24366 and 5863806.

A Skillset records that routine once: each skill, its repository and its commit. Every project then needs one command.

Build a list, then install it

Build your Skillset

Answer the prompts, or pass the source and skills as flags. Add from as many repositories as you like. A named set is saved in your home directory.

skillset add --set my-set
Any directory
skillset add mattpocock/skills -s grilling -s tdd --set my-setAdded grilling, tdd to /Users/you/.skillset/my-set.jsonskillset add juliusbrussee/caveman -s caveman --set my-setAdded caveman to /Users/you/.skillset/my-set.jsonskillset ls --set my-setcaveman  juliusbrussee/caveman  9b24366grilling  mattpocock/skills  5863806tdd  mattpocock/skills  5863806

Install it in a project

Skills go into the same agent directories and skills-lock.json that npx skills uses, so your agents find them with no setup. Install only adds skills. It never removes any.

skillset install my-set
~/projects/some-project
cd ~/projects/some-projectskillset install my-set -yInstalled caveman, grilling, tddls .agents/skillscaveman  grilling  tddlsskills-lock.json

No surprise added

Skillset saves the Git commit each skill came from. Every install gets those same commits, today or six months from now, until you run skillset update.

skillset update --set my-set

Collaboration in-mind

A Skillset file is nothing more than a JSON file. Put it in a remote repository or anywhere on the internet, and teammates run skillset install to get the same skills at the same commits.

skillset install https://example.com/team.json
~/.skillset/my-set.json
{  "$schema": "https://raw.githubusercontent.com/itsmeyaw/skillset/main/schemas/skillset/v1.json",  "skills": [    {      "name": "caveman",      "source": "juliusbrussee/caveman",      "commit": "9b243662ff98d392bc0a95b865a554583d71be75"    },    {      "name": "grilling",      "source": "mattpocock/skills",      "commit": "5863806dd4e15c63174bee4e7515a4256792ecfa"    },    {      "name": "tdd",      "source": "mattpocock/skills",      "commit": "5863806dd4e15c63174bee4e7515a4256792ecfa"    }  ]}

Fits your setup

Skillset wraps Vercel’s Skills CLI, so it works with the agents, sources and lockfile you use today.

Your agents
Installs for Universal agents (.agents/skills), Claude Code and any agent it detects, or only the ones you name with -a.
Your sources
Takes owner/repo, a branch, a tag or a full commit SHA, GitHub tree URLs and other Git URLs. Private repositories use your existing Git credentials.
Your scripts
Commands prompt by default. Pass flags and -y to run unattended.
Your choice of scope
Install per project or globally, as symlinks or copies.

Install Skillset

Install the CLI with npm, then run skillset add --set my-set to build your first list.

npm install -g @itsmeyaw/skillset

Read the docs on GitHubView the package on npm