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 • Screenshots • Commands • Web UI • Project Skills • Organization Skills • Docs

Note

Recent Updates

Version	Highlights
0.10.0	Web Dashboard — visual skill management via skillshare ui
0.9.0	Project-level skills — scope skills to a single repo, share via git
0.8.0	pull → collect rename, clearer command symmetry, refactoring

Why skillshare

Stop managing skills tool-by-tool. skillshare gives you one shared skill source and pushes it everywhere your AI agents work.

• One command, everywhere: Sync to Claude Code, Codex, Cursor, OpenCode, and more with skillshare sync.
• Safe by default: Non-destructive merge mode keeps CLI-local skills intact while sharing team skills.
• True bidirectional flow: Pull skills back from targets with collect so improvements never get trapped in one tool.
• Cross-machine ready: Git-native push/pull keeps all your devices aligned.
• Team + project friendly: Use global skills for personal workflows and .skillshare/ for repo-scoped collaboration.
• Visual control panel: Open skillshare ui for browsing, install, target management, and sync status in one place.

How It Works

• macOS / Linux: ~/.config/skillshare/skills/
• Windows: %USERPROFILE%\.config\skillshare\skills\

┌─────────────────────────────────────────────────────────────┐
│                       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)

CLI and UI Preview

CLI

Sync	Install Skills

UI

Dashboard	Skills

Installation

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex

Homebrew

brew install runkids/tap/skillshare

Shorthand (Optional)

Add an alias to your shell config (~/.zshrc or ~/.bashrc):

alias ss='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

---

Quick Start

skillshare init --dry-run  # Preview setup
skillshare init            # Create config, source, and detected targets
skillshare sync            # Sync skills to all targets

Common Workflows

Daily Commands

Command	What it does
skillshare list	List skills in source
skillshare status	Show sync status for all targets
skillshare sync	Sync source skills to all targets
skillshare diff	Preview differences before syncing
skillshare doctor	Diagnose config/environment issues
skillshare new <name>	Create a new skill template
skillshare install <source>	Install skill from local path or git source
skillshare collect [target]	Import skills from target(s) back to source
skillshare update <name>	Update one installed skill/repo
skillshare update --all	Update all tracked repos
skillshare uninstall <name>	Remove skill from source
skillshare search <query>	Search installable skills on GitHub

skillshare search requires GitHub auth (gh auth login) or GITHUB_TOKEN.

Target Management

skillshare target list
skillshare target add my-tool ~/.my-tool/skills
skillshare target remove my-tool

Backup and Restore

skillshare backup
skillshare backup --list
skillshare restore <target>

Cross-machine Git Sync

skillshare push
skillshare pull

Project Skills (Per Repo)

skillshare init -p
skillshare new my-skill -p
skillshare install anthropics/skills/skills/pdf -p
skillshare sync

Project mode keeps skills in .skillshare/skills/ so they can be committed and shared with the repo.

Organization Skills (Tracked Repo)

skillshare install github.com/team/skills --track
skillshare update _team-skills
skillshare sync

Web Dashboard

skillshare ui            # Global mode
skillshare ui -p         # Project mode (manages .skillshare/)

• Opens http://127.0.0.1:19420
• Requires skillshare init (or init -p for project mode) first
• Auto-detects project mode when .skillshare/config.yaml exists
• Runs from the same CLI binary (no extra frontend setup)

For containers/remote hosts:

skillshare ui --host 0.0.0.0 --no-open

Then access: http://localhost:19420

Docker Sandbox

Use Docker for reproducible offline testing and an interactive playground.

Offline test pipeline

make test-docker
# or
./scripts/test_docker.sh

Optional online install/update checks

make test-docker-online
# or
./scripts/test_docker_online.sh

Interactive playground

make sandbox-up
make sandbox-shell
make sandbox-down

Inside the playground:

skillshare --help
skillshare init --dry-run
skillshare ui --host 0.0.0.0 --no-open

# Project mode (pre-configured demo project)
cd ~/demo-project
skillshare status
skillshare-ui-p          # project mode dashboard on port 19420

Development

go build -o bin/skillshare ./cmd/skillshare
go test ./...
go vet ./...
gofmt -w ./cmd ./internal ./tests

Using make:

make build
make test
make lint
make fmt
make check

UI development helpers:

make ui-install
make ui-build
make ui-dev
make build-ui

Documentation

• Docs home: https://skillshare.runkids.cc/docs/
• Commands: https://skillshare.runkids.cc/docs/commands
• Guides: https://skillshare.runkids.cc/docs/guides/
• Troubleshooting: https://skillshare.runkids.cc/docs/troubleshooting/faq

Contributing

git clone https://github.com/runkids/skillshare.git
cd skillshare
go build -o bin/skillshare ./cmd/skillshare
go test ./...

Issues and PRs are welcome: https://github.com/runkids/skillshare/issues

---

If you find skillshare useful, consider giving it a ⭐

Star History

---

License

MIT