Curate your agent skills once. Install them in every project.
npm install -g @itsmeyaw/skillsetOr try it first with npx @itsmeyaw/skillset --help.
Then two commands
skillset add --set my-setSave skills from any repository as a list.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.
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
cd ~/projects/apiskillset install my-setcd ~/projects/webskillset install my-setcd ~/projects/docsskillset install my-set
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-setskillset 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-setcd ~/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-setCollaboration 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{ "$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
-yto 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