Skip to content

πŸ“š Sync skills across all AI CLI tools with one command and simplify team sharing. Supporting Claude Code, OpenClaw, OpenCode & more

License

Notifications You must be signed in to change notification settings

runkids/skillshare

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

124 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

skillshare

skillshare

License: MIT Go Version Release Platform Go Report Card

Star on GitHub

One source of truth for AI CLI skills. Sync everywhere with one command and simplify team sharing.
Claude Code, OpenClaw, OpenCode & 40+ more.

skillshare demo

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

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)

Windows init demo

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


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

search demo

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 login or set GITHUB_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 via git 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.

If you find skillshare useful, consider giving it a ⭐

Star History

Star History Chart

License

MIT