Install in 30 seconds
Node 18+ and npm required. Everything else is a symlink.
1 Install the CLI
Package name is skit-cli. Binary name is skit.
$ npm install -g skit-cli $ skit --version # 1.2.1
Linux/macOS tip: if npm install -g hits EACCES, set a user-local npm prefix once — avoids sudo:
$ mkdir -p ~/.npm-global $ npm config set prefix ~/.npm-global $ echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.profile $ source ~/.profile
2 Pick your agent
skit links skills into the directory your agent already reads from. Default is Claude Code.
$ skit config set agent claude-code # ~/.claude/skills/ $ skit config set agent cursor # ~/.cursor/rules/ $ skit config set agent windsurf # ~/.windsurf/rules/
3 Launch the TUI (optional)
Run skit with no arguments for an interactive menu — browse skills, manage sources, run actions without memorizing commands.
$ skit
User journeys
Pick the one that matches how you work. Run the commands. Watch your skills show up wherever your agent expects them.
Install real skills from GitHub
Pull the official Anthropic skill pack and pick what you want. Re-run the same command later to add more skills from the same repo.
$ skit install https://github.com/anthropics/skills $ skit list $ ls ~/.claude/skills/
Skills live in ~/.skit/sources/. Only symlinks land in your agent's skill dir.
Keep everything fresh
See what you have, check for drift, and pull updates — three commands.
$ skit list # grouped by source, with descriptions $ skit doctor # broken links, stale sources, updates available $ skit update # git pull on every source, then relink
doctor flags broken links, missing sources, and updates available.
Clone someone's entire setup
The headline feature. Shares a full skill library via a GitHub gist. Great for onboarding, new laptops, or lifting a teammate's setup wholesale. The push / clone <username> forms need the gh CLI (cli.github.com) authenticated. Offline form uses profile import <file>.
# Capture your setup to a file $ skit profile export > my-skit-profile.json # Share via gist (needs `gh auth login`) $ skit profile push # Adopt from a teammate — any of these work $ skit profile import my-skit-profile.json # local file $ skit clone <github-username> # their published gist $ skit clone https://gist.github.com/.../raw/skit-profile.json # direct URL
skit pulls the profile JSON, clones every listed source, and links every skill. One command, full setup.
Move between agents
One library, any agent. Switch without re-installing anything.
$ skit config set agent cursor $ skit sync $ ls ~/.cursor/rules/
Copy button takes the first command — run the rest one at a time.
sync rebuilds links from the manifest — same skills, new agent's directory.
Import a single skill
Got a gist, a subfolder in a repo, or just one raw URL? skit import figures it out. Three examples — replace the URL with yours before running.
# GitHub subfolder $ skit import https://github.com/user/repo/tree/main/skills/thing # Gist $ skit import https://gist.github.com/user/abc123 # Raw SKILL.md $ skit import https://raw.githubusercontent.com/user/repo/main/skill.md
Quarantine a project
Block your global skills for one project. Useful when a global skill interferes, or you want a clean slate for a sensitive repo.
$ cd /path/to/project $ skit incognito on $ skit incognito allow code-reviewer # whitelist one $ skit incognito off
Works with your agent
Skills are plain markdown with frontmatter. Every modern coding agent reads them — skit just puts them where each one looks.
Skills in ~/.claude/skills/. Picked up automatically on next session.
Rules in ~/.cursor/rules/. Switch with skit config set agent cursor.
Rules in ~/.windsurf/rules/. skit config set agent windsurf.
No native adapter yet. Use skit to organize skills; paste content into Copilot instructions or prompts.
What's coming next
On the roadmap
- Skill versioning — pin a skill to a git SHA or tag;
skit updaterespects pins. - Skill dependencies — declare what a skill needs in its frontmatter; skit resolves the graph.
skit init—npm initfor skills. Scaffold a new skill repo with a frontmatter template.- Copilot adapter — once the skill-file format stabilizes on Copilot's side.
Links
npm: npmjs.com/package/skit-cli
GitHub: github.com/balgaly/skit
Issues & ideas: github.com/balgaly/skit/issues