InstallOptions.Force carried two meanings: "overwrite what is already there" and "proceed despite audit findings". Update paths set Force unconditionally to overwrite a staged temp dir, so they had to leave it off to keep the audit gate alive -- which swallowed the caller's --force and made the gate impossible to override from either the CLI or the web UI. Split the audit intent into InstallOptions.AuditOverride and route every gate through it alone. Entry points translate --force explicitly, so a missed one degrades to "force has no effect" rather than "audit is bypassed". Scan failures stay fail-closed regardless: accepting known findings is not the same as being unable to learn any. This also closes two paths that bypassed the gate outright, since both inherited Force for overwrite reasons alone: install --json and grouped batch updates. In the web UI, Force Retry now appears only on failures force can actually resolve -- a permission-denied unlink previously offered a button that could never succeed -- and CLI-only flag hints are stripped from messages rendered there. Behaviour change: a --force at install time no longer exempts later updates from the audit gate; it is a one-off decision per command.
skillshare
One source of truth for AI CLI skills, agents, rules, commands & more. Sync everywhere with one command — from personal to organization-wide.
Codex, Claude Code, OpenClaw, OpenCode & 60+ more.
Website • Install • Quick Start • Highlights • Screenshots • Docs
Note
Latest: v0.20.0 — choose what
commit/push/pullversion with git_root scope (skills, agents, extras, or all together in one repo); extras extension transforms convert Markdown to native formats (Gemini TOML commands, Codex TOML agents) during sync. All releases →
Why skillshare
Every AI CLI has its own skills directory. You edit in one, forget to copy to another, and lose track of what's where.
skillshare fixes this:
- One source, every agent — sync to Claude, Cursor, Codex & 60+ more with
skillshare sync - Agent management — sync custom agents alongside skills to agent-capable targets
- More than skills — manage rules, commands, prompts & any file-based resource with extras
- Install from anywhere — GitHub, GitLab, Bitbucket, Azure DevOps, or any self-hosted Git
- Built-in security — audit skills for prompt injection and data exfiltration before use
- Team-ready — project skills in
.skillshare/, org-wide skills via tracked repos - Local & lightweight — single binary, no registry, no telemetry, fully offline-capable
- Fine-grained filtering — control which skills reach which targets with
.skillignore, SKILL.mdtargets, and per-target include/exclude
Coming from another tool? Migration Guide · Comparison
How It Works
- macOS / Linux:
~/.config/skillshare/ - Windows:
%AppData%\skillshare\
┌─────────────────────────────────────────────────────────────┐
│ Source Directory │
│ ~/.config/skillshare/skills/ ← skills (SKILL.md) │
│ ~/.config/skillshare/agents/ ← agents │
│ ~/.config/skillshare/extras/ ← rules, commands, etc. │
└─────────────────────────────────────────────────────────────┘
│ sync
┌───────────────┼───────────────┐
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Claude │ │ OpenCode │ │ OpenClaw │ ...
└───────────┘ └───────────┘ └───────────┘
| Platform | Skills Source | Agents Source | Extras Source | Link Type |
|---|---|---|---|---|
| macOS/Linux | ~/.config/skillshare/skills/ |
~/.config/skillshare/agents/ |
~/.config/skillshare/extras/ |
Symlinks |
| Windows | %AppData%\skillshare\skills\ |
%AppData%\skillshare\agents\ |
%AppData%\skillshare\extras\ |
NTFS Junctions (no admin required) |
| Imperative (install-per-command) | Declarative (skillshare) | |
|---|---|---|
| Source of truth | Skills copied independently | Single source → symlinks (or copies) |
| New machine setup | Re-run every install manually | git clone config + sync |
| Security audit | None | Built-in audit + auto-scan on install/update |
| Web dashboard | None | skillshare ui |
| Runtime dependency | Node.js + npm | None (single Go binary) |
CLI and UI Preview
| Skill Detail | Security Audit |
|---|---|
![]() |
![]() |
| UI Dashboard | UI 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 skillshare
Tip: Run
skillshare upgradeto update to the latest version. It auto-detects your install method and handles the rest.
GitHub Actions
- uses: runkids/setup-skillshare@v1
with:
source: ./skills
- run: skillshare sync
See setup-skillshare for all options (audit, project mode, version pinning).
Shorthand (Optional)
Add an alias to your shell config (~/.zshrc or ~/.bashrc):
alias ss='skillshare'
Quick Start
skillshare init # Create config, source, and detected targets
skillshare sync # Sync skills to all targets
Highlights
Install & update skills —from GitHub, GitLab, or any Git host
skillshare install github.com/reponame/skills
skillshare update --all
skillshare target claude --mode copy # if symlinks don't work
Symlink issues? — switch to copy mode per target
skillshare target <name> --mode copy
skillshare sync
Security audit —scan before skills reach your agent
skillshare audit
Project skills —per-repo, committed with your code
skillshare init -p && skillshare sync
Agents —sync custom agents to agent-capable targets
skillshare sync agents # sync agents only
skillshare sync --all # sync skills + agents + extras together
Extras —manage rules, commands, prompts & more
skillshare extras init rules # create a "rules" extra
skillshare sync --all # sync skills + extras together
skillshare extras collect rules # collect local files back to source
Shell completion —tab-complete commands, flags, and subcommands
skillshare completion bash --install # also: zsh, fish, powershell, nushell
Local checkpoints — commit source changes without pushing
skillshare commit -m "Update review skill"
skillshare commit --dry-run
Web dashboard — visual control panel
skillshare ui
Contributing
Contributions welcome! Open an issue first, then submit a draft PR with tests. See CONTRIBUTING.md for setup details.
git clone https://github.com/runkids/skillshare.git && cd skillshare
make check # format + lint + test
Tip
Not sure where to start? Browse open issues or try the Playground for a zero-setup dev environment.
Contributors
Thanks to everyone who helped shape skillshare.
If you find skillshare useful, consider giving it a ⭐
Star History
License
MIT















































































