> [!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 |
|---|---|
| | |
### UI
| Dashboard | Skills |
|---|---|
| | |
### Windows
## 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