One source of truth for AI CLI skills. Sync everywhere with one command and simplify team sharing.
Claude Code, OpenClaw, OpenCode & 40+ more.
Install β’ Quick Start β’ Commands β’ Team Edition β’ Docs
Note
Recent Updates
| Version | Highlights |
|---|---|
| 0.8.0 | pull β collect rename, clearer command symmetry, refactoring |
| 0.7.0 | Windows support, GitHub skill search |
| 0.6.0 | Team Edition with tracked repos |
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 |
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | shirm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iexbrew install runkids/tap/skillshare# macOS/Linux
brew uninstall skillshare # Homebrew
sudo rm /usr/local/bin/skillshare # Manual install
rm -rf ~/.config/skillshare # Config & data (optional)
# Windows (PowerShell)
Remove-Item "$env:LOCALAPPDATA\Programs\skillshare" -Recurse -Force
Remove-Item "$env:USERPROFILE\.config\skillshare" -Recurse -Force # optionalAdd an alias to your shell config (~/.zshrc or ~/.bashrc):
alias ss='skillshare'skillshare init --dry-run # Preview setup
skillshare init # Auto-detects CLIs, sets up git
skillshare sync # Sync to all targetsDone. Your skills are now synced across all AI CLI tools.
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Source Directory β
β ~/.config/skillshare/skills/ β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β sync
βββββββββββββββββΌββββββββββββββββ
βΌ βΌ βΌ
βββββββββββββ βββββββββββββ βββββββββββββ
β Claude β β OpenCode β β OpenClaw β ...
βββββββββββββ βββββββββββββ βββββββββββββ
| Platform | Source Path | Link Type |
|---|---|---|
| macOS/Linux | ~/.config/skillshare/skills/ |
Symlinks |
| Windows | %USERPROFILE%\.config\skillshare\skills\ |
NTFS Junctions (no admin required) |
| Command | Description |
|---|---|
init |
Initialize, auto-detect CLIs, setup git |
new <name> |
Create a new skill with SKILL.md template |
search <query> |
Search GitHub for skills |
sync |
Sync skills to all targets |
collect <target> |
Collect skills from target back to source |
push |
Push to git remote (cross-machine) |
pull |
Pull from git remote and sync |
install <source> |
Install skill from path or git repo |
uninstall <name> |
Remove skill from source |
update <name> |
Update skill or tracked repo |
list |
List installed skills |
status |
Show sync state |
doctor |
Diagnose issues |
upgrade |
Upgrade CLI and skill |
- docs/ β Documentation index
- targets.md β Target management
- sync.md β Sync, pull, push, backup
- team-edition.md β Team sharing with tracked repos
- install.md β Install, update, upgrade skills
- search.md β Search and discover skills
- cross-machine.md β Multi-machine sync
- faq.md β FAQ & troubleshooting
skillshare target list # List targets
skillshare target add myapp ~/.myapp/skills # Add custom target
skillshare target remove claude # Safely unlinkThe built-in skillshare skill teaches your AI how to manage skills. The binary auto-downloads on first use.
User: "sync my skills to all targets"
β
βΌ
AI reads skillshare skill β runs: skillshare sync
β
βΌ
β Synced 5 skills to claude, codex, cursor
Try it: "Show my skillshare status", "Collect skills from Claude", "Install the pdf skill from anthropics/skills"
Discover and install skills from GitHub with interactive search.
skillshare search runkidsFeatures:
- Smart ranking β Results sorted by repository stars
- Interactive selector β Arrow keys to navigate, Enter to install
- Continuous search β Search again without restarting
- Filter forks β Only shows original repositories
skillshare search pdf --list # List only, no install prompt
skillshare search react --json # JSON output for scripting
skillshare search commit -n 5 # Limit resultsNote: Requires GitHub authentication. Run
gh auth loginor setGITHUB_TOKEN.
See Search Guide for details.
Share skills across your team with tracked repositories.
# Install team repo
skillshare install github.com/team/skills --track
# Update later
skillshare update _team-skills
skillshare syncFeatures:
- Tracked repos β Clone with
.git, update viagit pull - Nested skills β
team/frontend/uiβteam__frontend__ui - Auto-pruning β Orphaned symlinks removed on sync
- Collision detection β Warns about duplicate skill names
See Team Edition Guide for details.
What if I modify a skill in a target directory?
Since targets are linked to source, you're editing the source directly. All targets see changes immediately.
How do I keep CLI-specific skills?
Use merge mode (default). Local skills in targets are preserved.
Accidentally deleted a skill?
Recover with git: cd ~/.config/skillshare/skills && git checkout -- deleted-skill/
Windows: Do I need admin privileges?
No. skillshare uses NTFS junctions (not symlinks), which don't require elevated permissions.
See FAQ & Troubleshooting for more.
| Issue | Solution |
|---|---|
config not found |
Run skillshare init |
| Deleted source via symlink | Use skillshare target remove, recover via git |
| Target exists with files | Run skillshare backup first |
| Skill not appearing | Run skillshare doctor, restart CLI |
git clone https://github.com/runkids/skillshare.git
cd skillshare
go build -o bin/skillshare ./cmd/skillshare
go test ./...Open an issue for bugs or feature requests.
If you find skillshare useful, consider giving it a β
MIT



