mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
95ca07be89720e3e6b9ae07c48e90c7fbc28bcef
- Add `skillshare target <name>` to show target details - Add `skillshare target <name> --mode <mode>` to change target mode - Show sync mode [merge/symlink] in status and doctor output - Show warning when configured mode doesn't match actual state - Fix sync to properly convert between symlink and merge modes - Simplify module name to `skillshare` - Remove go install option from README (incompatible with simplified module)
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 skills to all CLI tools:
~/.config/skillshare/
├── config.yaml
└── skills/ <- Your shared skills live here
├── my-skill/
└── another-skill/
~/.claude/skills/
├── my-skill -> ~/.config/skillshare/skills/my-skill (symlink)
├── another-skill -> ~/.config/skillshare/skills/another-skill (symlink)
└── local-only/ <- Local skills are preserved
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
Verify Installation
skillshare version
Uninstall
# Homebrew
brew uninstall skillshare
# Manual (curl install)
sudo rm /usr/local/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
# Unlink target (restore skills and remove from config)
skillshare target remove myapp
# Unlink all targets
skillshare target remove --all
Configuration
Config file: ~/.config/skillshare/config.yaml
source: ~/.config/skillshare/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, optionally copy from existing skills
- sync:
- Backup targets with local skills before sync
- Create symlinks (merge mode: per-skill, symlink mode: whole directory)
- status: Check symlink health
- target remove: Backup, unlink symlinks, restore skills
Backups
Automatic backups are created before sync and target remove operations.
Location: ~/.config/skillshare/backups/<timestamp>/<target>/
License
MIT
Description
No description provided
agent-pluginsaiai-agentsclaude-codeclicodexcross-machine-syncdesktop-appgohooksmcpopenclawopencodepipi-packageskillsskills-auditskills-managerskillshareteam-collaboration
Readme
MIT
173 MiB
Languages
Go
73.7%
TypeScript
20.2%
JavaScript
3%
Shell
1.4%
CSS
0.9%
Other
0.7%