filepath.Walk fails on Windows NTFS junctions with "Incorrect function" because os.Lstat returns nil info, bypassing all junction-detection logic and crashing the entire backup for that target. This means one unreadable junction prevents ALL local skills from being backed up. Replace with os.ReadDir + os.Lstat so junctions are identified and skipped before any read attempt. Also add Windows CI and unit tests for copyDir. Fixes runkids/skillshare#7
skillshare
One source of truth for AI CLI skills. Sync everywhere with one command — from personal to organization-wide.
Claude Code, OpenClaw, OpenCode & 40+ more.
Website • Install • Quick Start • Commands • Project Skills • Organization Skills • Docs
Note
Recent Updates
Version Highlights 0.9.0 Project-level skills — scope skills to a single repo, share via git 0.8.0 pull→collectrename, clearer command symmetry, refactoring0.7.0 Windows support, GitHub skill search
Why skillshare?
Install tools get skills onto agents. Skillshare keeps them in sync.
| Feature | Description |
|---|---|
| 🔗 Non-destructive Merge | Sync shared skills while preserving CLI-specific ones. Per-skill symlinks keep local skills untouched. |
| ↔️ Bidirectional Sync | Created a skill in Claude? Collect it back to source and share with OpenClaw, OpenCode, and others. |
| 🌐 Cross-machine Sync | One git push/pull syncs skills across all your machines. No re-running install commands. |
| 📦 Unified Source | Local skills and installed skills live together in one directory. No separate management. |
| 👥 Organization Skills | Install shared repos once, update anytime with git pull. Changes sync to all agents instantly. |
| 📁 Project Skills | Scope skills to a repo, share via git. Auto-detected when you cd into the project. |
| ✨ AI-Native | Built-in skill lets AI operate skillshare directly. No manual CLI needed. |
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 |
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 |
Documentation
📖 Full documentation at skillshare.runkids.cc
| Guide | Description |
|---|---|
| Getting Started | Quick start guide |
| Commands | All CLI commands |
| Project Skills | Project-level skills setup |
| Organization Skills | Organization-wide sharing with tracked repos |
| Cross-machine | Multi-machine sync |
| FAQ | 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", "Collect 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.
Project Skills
Scope skills to a single repository — shared with your team via git.
# Initialize project-level skills
skillshare init -p
# Create or install skills
skillshare new my-skill -p
skillshare install anthropics/skills/skills/pdf -p
# Sync to targets
skillshare sync
Features:
- Project-scoped — Skills live in
.skillshare/skills/, committed to the project repo - Auto-detection — Commands auto-detect project mode when
.skillshare/exists - Team onboarding — New members run
skillshare install -p && skillshare sync - Coexists with global — Project and global skills work independently
See Project Skills Guide for details.
Organization Skills
Share skills across your organization 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 Organization Skills 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.
If you find skillshare useful, consider giving it a ⭐
Star History
License
MIT



