Introduction

skillshare is a CLI tool that syncs AI CLI skills from a single source to all your AI coding assistants.

Why skillshare?

Install tools get skills onto agents. Skillshare keeps them in sync.

	Install-once tools	skillshare
After install	Done, no management	Continuous sync across all agents
Update a skill	Re-install manually	Edit once, sync everywhere
Pull back edits	✗	Bidirectional — pull from any agent
Cross-machine	✗	push/pull via git
Team sharing	Copy-paste	Tracked repos — update to stay current
AI integration	Manual CLI	Built-in skill — AI operates it directly

Quick Start

# Install
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

# Initialize (auto-detects CLIs, sets up git)
skillshare init

# Sync to all targets
skillshare sync

Done. Your skills are now synced across all AI CLI tools.

How It Works

┌─────────────────────────────────────────────────────────────┐
│                       Source Directory                      │
│                 ~/.config/skillshare/skills/                │
└─────────────────────────────────────────────────────────────┘
                              │ sync
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
       ┌───────────┐   ┌───────────┐   ┌───────────┐
       │  Claude   │   │  OpenCode │   │  Cursor   │   ...
       └───────────┘   └───────────┘   └───────────┘

• Source: Single directory where you edit skills (~/.config/skillshare/skills/)
• Targets: AI CLI skill directories (symlinked from source)
• Sync: Creates/updates symlinks from source to targets

Core Concepts

Source vs Targets

┌─────────────────────────────────────────┐
│         SOURCE (edit here)              │
│   ~/.config/skillshare/skills/          │
│                                         │
│   my-skill/   another/   _team-repo/    │
└─────────────────────────────────────────┘
                    │
                    │ skillshare sync
                    ▼
┌─────────────────────────────────────────┐
│              TARGETS                    │
│   ~/.claude/skills/  (symlinks)         │
│   ~/.cursor/skills/  (symlinks)         │
│   ~/.codex/skills/   (symlinks)         │
└─────────────────────────────────────────┘

• Source: Single directory where you edit skills
• Targets: AI CLI skill directories (symlinked from source)
• Sync: Creates/updates symlinks from source to targets

Sync Modes

Mode	How it works
merge	Each skill symlinked individually. Local skills preserved. (default)
symlink	Entire directory is one symlink. All targets identical.

See sync for details.

Supported Platforms

Platform	Source Path	Link Type
macOS/Linux	~/.config/skillshare/skills/	Symlinks
Windows	%USERPROFILE%\.config\skillshare\skills\	NTFS Junctions

Command Quick Reference

Command	What it does	Docs
init	First-time setup	init
search	Discover skills	search
new	Create a skill	new
install	Add a skill	install
uninstall	Remove a skill	install
update	Update a skill	install
upgrade	Upgrade CLI/skill	install
sync	Push to targets	sync
pull	Pull from git remote	sync
push	Push to git remote	sync
backup	Backup targets	sync
restore	Restore from backup	sync
target	Manage targets	targets
list	List skills	install
status	Show sync state	sync
diff	Show differences	sync
doctor	Diagnose issues	faq

Next Steps

• Commands Reference — All available commands
• Team Edition — Share skills with your team
• Cross-Machine Sync — Sync across computers
• FAQ — Troubleshooting