Quick start

Requirements

• Node.js 22 or later.
• Projects need to be git repositories with a remote. skilless identifies a project by its remote URL, so the same repo is recognized on every machine and in every cloud agent.

Install

Run skilless with npx, or install it globally so skilless is on your path:

npm install -g skilless

Create your library

skilless init

This creates your library at ~/.skilless. Every skill you create, import or add from a repository is kept there.

Add a skill to a project

From inside a project, create a new skill:

skilless create code-review

skilless creates code-review in your library, adds it to this project, and prints the path to its SKILL.md so you can write it. Pick an editor to open new skills in with skilless config editor.

Or add a skill someone has published in a git repository. Pass the repo, then the skills to take from it:

skilless add anthropics/skills frontend-design

Leave out the skill names to pick from a list. See adding skills for everything add can do.

Check what's linked

skilless list --project

Your agent now sees the skill in .claude/skills and .agents/skills, and git status is still clean.

Already have skills?

If you've been copying skills into projects or keeping them at the user level, skilless migrate moves them into your library and links them back. See moving existing skills in.