The Update button on SkillDetailPage passed only the skill basename
(e.g. "ascii-box-check") instead of the full relative path
("utils/ascii-box-check"), causing "not found as tracked repo or
updatable skill" errors for nested skills.
- Frontend: use skill.relPath instead of skill.name for non-repo skills
- Backend: rewrite getServerUpdatableSkills with filepath.WalkDir so
Update All also discovers nested skills
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.11.0 Security Audit, Operation Log, Trash, Update Preview — full audit trail + safety net 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
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. - Folder-friendly: Organize skills in folders (e.g.
frontend/react/) — auto-flattened to flat names on sync. - Privacy-first: No central registry, no telemetry, no install tracking. Your skill setup stays entirely local.
- Built-in security audit: Scan skills for prompt injection, data exfiltration, and other threats before they reach your AI agent.
- Visual control panel: Open
skillshare uifor browsing, install, target management, and sync status in one place.
Comparison
skillshare uses a declarative approach: define your targets once in config.yaml, then sync handles everything — no prompts, no repeated selections.
| Imperative (install-per-command) | Declarative (skillshare) | |
|---|---|---|
| Config | No config; prompts every run | config.yaml — set once |
| Agent selection | Interactive prompt each time | Defined in config |
| Install method | Choose per operation | sync_mode in config |
| Source of truth | Skills copied independently | Single source → symlinks |
| Remove one agent's skill | May break other agents' symlinks | Only that target's symlink removed |
| New machine setup | Re-run every install manually | git clone config + sync |
| Project-scoped skills | Global lock file only | init -p for per-repo skills |
| Cross-machine sync | Manual | Built-in push / pull |
| Bidirectional | Install only | collect pulls changes back |
| Security audit | None | Built-in audit + auto-scan on install |
| Web dashboard | None | skillshare ui |
| Runtime dependency | Node.js + npm | None (single Go binary) |
Tip
Coming from another tool? See the Migration Guide and detailed comparison.
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) |
Tip
Skills can be organized in folders (e.g.
frontend/react/react-best-practices/) — they're auto-flattened on sync. See the Organizing Guide and runkids/my-skills for a real-world example.
CLI and UI Preview
CLI
| Sync | Install + Audit |
|---|---|
![]() |
![]() |
UI
| Dashboard | Security Audit |
|---|---|
![]() |
![]() |
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 audit [name] |
Scan skills for security threats |
skillshare log |
View operations and audit logs for debugging and compliance |
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 install github.com/team/skills --track -p
skillshare sync
Project mode keeps skills in .skillshare/skills/ so they can be committed and shared with the repo. The config.yaml acts as a portable skill manifest — anyone who clones the repo (team members, open source contributors, community users) can reproduce the exact same AI skill setup:
git clone github.com/your/project && cd project
skillshare install -p # Installs all skills listed in config (tracked repos included)
skillshare sync
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
Security Audit
Scan installed skills for prompt injection, data exfiltration, credential theft, and other threats before they reach your AI agent.
skillshare audit # Scan all skills
skillshare audit <name> # Scan a specific skill
CRITICAL findings block installation by default. Use --force to override.
Skills are also scanned automatically during skillshare install.
Tip
See the audit command reference for the full list of detection patterns.
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-all
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





