The package manager for AI agent skills.
Install, organize, and share skills across Claude Code, Cursor, Windsurf, and more.

---

---

Quick Start

# Install globally (CLI command stays `skit`)
npm install -g skit-cli

# Install skills from a GitHub repo
skit install https://github.com/someone/their-skills

# Clone someone's entire skill setup
skit clone snir

# List what you have
skit list

---

Why do I need this?

Your skills are a mess. You've got markdown files scattered across ~/.claude/skills/, some copied from GitHub, some you wrote, some a colleague sent on Slack. Half are outdated. You have no idea where they came from or if there's a newer version.

You can't share your setup. A teammate asks "what skills do you use?" and you end up zipping folders and writing instructions. When someone shares a great skill repo, everyone manually clones it and copies files around.

Switching machines is painful. New laptop? Re-download everything. Reinstall from that gist you bookmarked 3 months ago. Hope you remember which skills you had.

You use multiple agents. Claude Code today, Cursor tomorrow, maybe Windsurf for a side project. Each has its own skill directory. You're maintaining the same skills in 3 places.

Skills break silently. The repo you cloned 2 months ago got updated. Your local copy is stale. You don't know, and there's no way to check without visiting every GitHub repo manually.

skit solves all of this:

• skit install <url> — Install from GitHub, gists, or local folders. Scans for skills automatically.
• skit update — One command to pull the latest version of every skill.
• skit clone <user> — Replicate anyone's entire setup in seconds.
• skit sync — New machine? One command to recreate everything from your manifest.
• skit doctor — Find broken links, stale sources, and available updates.
• Cross-platform — Windows (NTFS junctions), macOS, and Linux (symlinks). No admin rights.
• Multi-agent — Claude Code, Cursor, and Windsurf supported. VS Code coming.

---

Commands

Command	Description
skit install <url|path>	Clone repo or register local folder, scan for skills, interactive picker
skit import <any-url>	Smart import from gist, GitHub subfolder, or raw URL
skit remove <skill>	Remove a skill (prompts if last skill from source)
skit remove --source <name>	Remove all skills from a source
skit list	Show all skills grouped by source
skit update [source]	Git pull + re-link (all sources or one)
skit sync	Recreate all links from manifest (new machine setup)
skit clone <user|url>	Fetch profile, install everything
skit profile export	Export your setup as shareable JSON
skit profile import <file>	Apply a profile with conflict resolution
skit profile diff <file|user>	Show what they have that you don't
skit profile push	Publish profile to GitHub Gist (requires gh)
skit doctor	Health check: broken links, missing sources, updates
skit link <path>	Low-level: create link for one skill directory
skit unlink <skill>	Low-level: remove link only, keep source
skit config set <key> <val>	Set config (agent, user, skitHome)
skit config get <key>	Get config value

---

How It Works

skit keeps skills in a central library (~/.skit/) and creates filesystem links into your agent's skill directory. Your agent sees the skills exactly where it expects them, but skit tracks everything behind the scenes.

~/.skit/
├── config.json              # Agent, username, preferences
├── manifest.json            # Single source of truth
├── sources/
│   ├── own/                 # Your repos (--own flag)
│   │   └── my-skills/
│   └── external/            # Third-party repos
│       ├── someone--skills/
│       └── _standalone/     # From skit import
└── profiles/                # Cached profiles

~/.claude/skills/            # Agent target (links only)
├── code-reviewer → ~/.skit/sources/external/someone--skills/code-reviewer
├── my-tool       → ~/.skit/sources/own/my-skills/my-tool
└── quick-doc     → ~/.skit/sources/external/_standalone/quick-doc

Windows: NTFS junctions (no elevation needed) · macOS/Linux: directory symlinks

---

Install from GitHub

$ skit install https://github.com/someone/their-skills

skit clones the repo, scans for skills (directories containing SKILL.md), and presents an interactive picker. Selected skills are linked into your agent's skill directory.

---

List Your Skills

$ skit list

Skills are grouped by source with their descriptions. Own sources are highlighted separately from external ones.

---

Clone a Profile

The viral feature. One command to replicate anyone's skill setup:

$ skit clone snir

skit clone fetches the user's profile from GitHub Gists, clones all source repos, and installs every skill. Share your profile with skit profile push.

---

Smart Import

skit import handles any URL format:

# Full repo → delegates to install
skit import https://github.com/user/repo

# Subfolder → installs just that skill
skit import https://github.com/user/repo/tree/main/skills/my-skill

# Gist → downloads files as a standalone skill
skit import https://gist.github.com/user/abc123

# Raw URL → wraps as standalone skill
skit import https://raw.githubusercontent.com/user/repo/main/skill.md

---

Supported Agents

Agent	Status	Skill Directory
Claude Code	Supported	~/.claude/skills/
Cursor	Supported	~/.cursor/rules/
Windsurf	Supported	~/.windsurf/rules/
VS Code	Planned	TBD

Switch agents with:

skit config set agent cursor      # use Cursor
skit config set agent windsurf    # use Windsurf
skit config set agent claude-code # use Claude Code (default)

Adding a new agent adapter is ~20 lines. See src/agents/ for examples.

---

Skill Format

A skill is a directory containing a SKILL.md file with optional YAML frontmatter:

---
name: my-skill
description: Use when the user wants to do X
---

# My Skill

Instructions for the AI agent...

skit scans for skills at the repo root, one level deep, and in well-known subdirectories (skills/, commands/, agents/).

---

Health Check

$ skit doctor

  Checking 8 skills...

  Broken links:
    pr-helper → source missing

  Updates available:
    their-skills: 3 commits behind

  1 issue found. Run 'skit sync' to fix broken links.

---

Comparison

Feature	skit	AGR	skills-manager
Cross-platform	Windows + macOS + Linux	macOS + Linux	macOS + Linux
Install source	Git repos, gists, URLs, local	Git repos	Local only
Multi-agent	Claude Code + extensible	Claude Code only	Claude Code only
Profile sharing	skit clone <user>	—	—
Smart import	Any URL auto-detected	—	—
Version tracking	Full manifest	—	—
Interactive picker	Checkbox UI	—	GUI
Package manager	npm	pip	Tauri binary

---

Contributing

Issues and PRs welcome. This is v1 — there's lots of room to grow.

Roadmap:

• Community registry with search and trending skills
• VS Code agent adapter
• skit init scaffolding for new skill repos
• Interactive TUI browser

See docs/design.md for the full specification.

---

Credits

Terminal demo GIFs created with command-giffer.

License

ISC