The web dashboard now fully supports project-level skills. When launched with `-p` or when `.skillshare/config.yaml` is auto-detected, the UI adapts: Git Sync and Backup pages are hidden, Config edits the project config, Install reconciles ProjectConfig.Skills[], and targets resolve from project-level definitions. Server: add NewProject constructor, IsProjectMode/configPath/saveConfig/ reloadConfig helpers, branch all handlers for project mode. Frontend: AppContext propagates isProjectMode, Layout filters nav items, Git/Backup pages show unavailable message, Config/Dashboard adapt. Extract ReconcileProjectSkills to internal/config for reuse by both CLI and server. Add unit tests and integration tests for project UI. Update docs, README, and Docker playground with project mode demo project and skillshare-ui-p alias.
8.5 KiB
skillshare
One source of truth for AI CLI skills.
Sync once, use everywhere: Claude Code, Codex, Cursor, OpenCode, and 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 ui0.9.0 Project-level skills — scope skills to a single repo, share via git 0.8.0 pull→collectrename, 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
collectso improvements never get trapped in one tool. - Cross-machine ready: Git-native
push/pullkeeps all your devices aligned. - Team + project friendly: Use global skills for personal workflows and
.skillshare/for repo-scoped collaboration. - Visual control panel: Open
skillshare uifor browsing, install, target management, and sync status in one place.
CLI and UI Preview
CLI
| Status | Search |
|---|---|
![]() |
![]() |
UI
| Dashboard | Skills |
|---|---|
![]() |
![]() |
Windows
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
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
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 <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(orinit -pfor project mode) first - Auto-detects project mode when
.skillshare/config.yamlexists - 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/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
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






