skillshare

skillshare

Website License: MIT Go Version Release Platform Go Report Card Ask DeepWiki

Star on GitHub

One source of truth for AI CLI skills.
Sync once, use everywhere: Claude Code, Codex, Cursor, OpenCode, and more.

skillshare demo

Website • Install • Quick Start • Screenshots • Commands • Web UI • Project Skills • Organization Skills • Docs

> [!NOTE] > **Recent Updates** > | Version | Highlights | > |---------|------------| > | [0.10.0](https://github.com/runkids/skillshare/releases/tag/v0.10.0) | Web Dashboard — visual skill management via `skillshare ui` | > | [0.9.0](https://github.com/runkids/skillshare/releases/tag/v0.9.0) | Project-level skills — scope skills to a single repo, share via git | > | [0.8.0](https://github.com/runkids/skillshare/releases/tag/v0.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. ## CLI and UI Preview ### CLI | Status | Search | |---|---| | CLI status command output | CLI search command output | ### UI | Dashboard | Skills | |---|---| | Web dashboard overview | Web UI skills browser | ### Windows

Windows initialization demo

## Installation ### macOS / Linux ```bash curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh ``` ### Windows PowerShell ```powershell irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex ``` ### Homebrew ```bash brew install runkids/tap/skillshare ``` ### Uninstall ```bash # 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 ```bash skillshare init --dry-run # Preview setup skillshare init # Create config, source, and detected targets skillshare sync # Sync skills to all targets ``` Default source directory: - macOS / Linux: `~/.config/skillshare/skills/` - Windows: `%USERPROFILE%\.config\skillshare\skills\` ## 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 ` | Create a new skill template | | `skillshare install ` | Install skill from local path or git source | | `skillshare collect [target]` | Import skills from target(s) back to source | | `skillshare update ` | Update one installed skill/repo | | `skillshare update --all` | Update all tracked repos | | `skillshare uninstall ` | Remove skill from source | | `skillshare search ` | Search installable skills on GitHub | `skillshare search` requires GitHub auth (`gh auth login`) or `GITHUB_TOKEN`. ### Target Management ```bash skillshare target list skillshare target add my-tool ~/.my-tool/skills skillshare target remove my-tool ``` ### Backup and Restore ```bash skillshare backup skillshare backup --list skillshare restore ``` ### Cross-machine Git Sync ```bash skillshare push skillshare pull ``` ### Project Skills (Per Repo) ```bash 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) ```bash skillshare install github.com/team/skills --track skillshare update _team-skills skillshare sync ``` ## Web Dashboard ```bash 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: ```bash 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 ```bash make test-docker # or ./scripts/test_docker.sh ``` ### Optional online install/update checks ```bash make test-docker-online # or ./scripts/test_docker_online.sh ``` ### Interactive playground ```bash make sandbox-up make sandbox-shell make sandbox-down ``` Inside the playground: ```bash 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 ```bash go build -o bin/skillshare ./cmd/skillshare go test ./... go vet ./... gofmt -w ./cmd ./internal ./tests ``` Using `make`: ```bash make build make test make lint make fmt make check ``` UI development helpers: ```bash make ui-install make ui-build make ui-dev make build-ui ``` ## Documentation - Docs home: https://skillshare.runkids.cc/docs/intro - Commands: https://skillshare.runkids.cc/docs/category/commands - Guides: https://skillshare.runkids.cc/docs/category/guides - Troubleshooting: https://skillshare.runkids.cc/docs/troubleshooting/faq ## Contributing ```bash 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 ## License MIT