- Add detailed error messages when junction/symlink creation fails - Pre-flight checks for source existence and target conflicts - Capture mklink /J stderr output - Show both junction and symlink failure reasons - Add case-insensitive path comparison for Windows (NTFS) - New PathsEqual() and PathHasPrefix() in utils/path.go - Fix 8 path comparisons that could fail due to case differences - Affects sync, pull, target remove, diff, and doctor commands
skillshare
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
What's New in 0.7.0: Full Windows support (NTFS junctions, zip downloads, self-upgrade), Search skills from GitHub. Previous: Team Edition → docs/team-edition.md
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 |
Installation
Quick Install (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
Quick Install (Windows PowerShell)
irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex
Homebrew (macOS)
brew install runkids/tap/skillshare
Uninstall
# 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 # optional
Shorthand (Optional)
Add an alias to your shell config (~/.zshrc or ~/.bashrc):
alias ss='skillshare'
Quick Start
skillshare init --dry-run # Preview setup
skillshare init # Auto-detects CLIs, sets up git
skillshare sync # Sync to all targets
Done. Your skills are now synced across all AI CLI tools.
How It Works
┌─────────────────────────────────────────────────────────────┐
│ 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) |
Commands
| 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 |
pull <target> |
Pull skills from target back to source |
push |
Push to git remote (cross-machine) |
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 |
Documentation
- 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
Target Management
skillshare target list # List targets
skillshare target add myapp ~/.myapp/skills # Add custom target
skillshare target remove claude # Safely unlink
AI-Native
The 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", "Pull skills from Claude", "Install the pdf skill from anthropics/skills"
Search Skills
Discover and install skills from GitHub with interactive search.
skillshare search runkids
Features:
- 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 results
Note: Requires GitHub authentication. Run
gh auth loginor setGITHUB_TOKEN.
See Search Guide for details.
Team Edition
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 sync
Features:
- 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.
FAQ
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.
Common Issues
| 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 |
Contributing
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.
Star History
License
MIT



