mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
75c0e4bead52e1ad9d409580e31983cd00b7333f
- merge mode: symlink individual skills, preserve local skills - symlink mode: entire directory becomes symlink - safer default that won't move existing skills
skillshare
Share skills across AI CLI tools (Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode).
The Problem
Each AI CLI tool has its own skills directory:
~/.claude/skills/
~/.codex/skills/
~/.cursor/skills/
~/.gemini/antigravity/skills/
~/.config/opencode/skills/
Keeping them in sync manually is tedious.
The Solution
skillshare maintains a single source directory and symlinks it to all CLI tools:
~/.skills/ <- Your skills live here (single source of truth)
├── my-skill/
└── another-skill/
~/.claude/skills -> ~/.skills (symlink)
~/.codex/skills -> ~/.skills (symlink)
~/.cursor/skills -> ~/.skills (symlink)
...
Installation
macOS
# Apple Silicon (M1/M2/M3/M4)
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_0.1.0_darwin_arm64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/
# Intel
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_0.1.0_darwin_amd64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/
Linux
# x86_64
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_0.1.0_linux_amd64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/
# ARM64
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_0.1.0_linux_arm64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/
Windows
Download from Releases and add to PATH.
Homebrew (macOS/Linux)
brew install runkids/tap/skillshare
Using Go (alternative)
go install github.com/runkids/skillshare/cmd/skillshare@latest
Verify Installation
skillshare version
Uninstall
# Homebrew
brew uninstall skillshare
# Manual (curl install)
sudo rm /usr/local/bin/skillshare
# Go
rm $(go env GOPATH)/bin/skillshare
# Config and data (optional)
rm -rf ~/.config/skillshare
Quick Start
# 1. Initialize with default source directory (~/.skills)
skillshare init
# 2. Check detected targets
skillshare status
# 3. Sync (migrate existing skills + create symlinks)
skillshare sync
Usage
Initialize
# Use default source (~/.skills)
skillshare init
# Or specify custom source
skillshare init --source ~/my-skills
This will:
- Create the source directory
- Detect installed CLI tools
- Create config at
~/.config/skillshare/config.yaml
Sync
# Preview what will happen
skillshare sync --dry-run
# Actually sync
skillshare sync
On first sync, existing skills are migrated to the source directory, then symlinks are created.
Status
skillshare status
Shows:
- Source directory and skill count
- Each target's status (linked, has files, not exist, conflict)
Manage Targets
# List targets
skillshare target list
# Add custom target
skillshare target add myapp ~/.myapp/skills
# Remove target
skillshare target remove myapp
Configuration
Config file: ~/.config/skillshare/config.yaml
source: ~/.skills
mode: merge # default mode for all targets
targets:
claude:
path: ~/.claude/skills
mode: symlink # override: use full directory symlink
codex:
path: ~/.codex/skills
cursor:
path: ~/.cursor/skills
gemini:
path: ~/.gemini/antigravity/skills
opencode:
path: ~/.config/opencode/skills
ignore:
- "**/.DS_Store"
- "**/.git/**"
Sync Modes
| Mode | Behavior |
|---|---|
merge (default) |
Each skill is symlinked individually. Local skills in target are preserved. |
symlink |
Entire directory becomes a symlink to source. All targets share the same skills. |
Use symlink mode when you want all targets to share exactly the same skills.
How It Works
- init: Detects CLI tools and creates config
- sync:
- If target has files → migrate to source, then symlink
- If target is empty/missing → just create symlink
- If already linked → skip
- status: Check symlink health
License
MIT
Description
No description provided
agent-pluginsaiai-agentsclaude-codeclicodexcross-machine-syncdesktop-appgohooksmcpopenclawopencodepipi-packageskillsskills-auditskills-managerskillshareteam-collaboration
Readme
MIT
176 MiB
Languages
Go
73.5%
TypeScript
20.1%
JavaScript
3.3%
Shell
1.4%
CSS
0.9%
Other
0.7%