English · 日本語 · 한국어 · 简体中文 · 繁體中文
One source of truth for AI CLI skills, agents, rules, commands & more. Manage them in the desktop app, or sync everywhere with one command — from personal to organization-wide.
Codex, Claude Code, OpenClaw, OpenCode & 60+ more.
Website • Install • Quick Start • Highlights • Screenshots • Desktop App • Docs
> [!NOTE] > **Latest**: v0.23.0 — manage and sync **native hooks** in global and project scope; choose which **MCP tools** reach the model with `tools.allow` and `tools.deny`; and use the dashboard's new **Hooks page** and **MCP tool picker** to configure them. [All releases →](https://github.com/runkids/skillshare/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](https://skillshare.runkids.cc/docs/reference/targets/configuration#extras) - **MCP connections** — define a server once, sync it into each Agent's own config format with [`sync mcp`](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-mcp) - **Complete plugins** — keep a plugin's skills, hooks and MCP settings together and choose which tools receive it with [`plugin`](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins) - **Native hooks** — manage each Agent’s event configuration or extension code, with preview, enable/disable and recovery. [hooks](https://skillshare.runkids.cc/docs/reference/commands/hooks) - **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`](https://skillshare.runkids.cc/docs/how-to/daily-tasks/filtering-skills), SKILL.md `targets`, and per-target include/exclude > Coming from another tool? [Migration Guide](https://skillshare.runkids.cc/docs/how-to/advanced/migration) · [Comparison](https://skillshare.runkids.cc/docs/understand/philosophy/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 for folders (no admin required); file symlinks need Developer Mode, otherwise copied | | | 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) | > [Full comparison →](https://skillshare.runkids.cc/docs/understand/philosophy/comparison) ## CLI and UI Preview
|
|
| UI Dashboard | UI Skills |
|---|---|
|
|
|
## Installation
> [!TIP]
> **Use skillshare from your desktop.** [Get Skillshare App](https://github.com/runkids/skillshare-app/releases/latest) for macOS (Apple Silicon), Windows and Linux. First launch helps you install or locate the CLI, choose your AI tools and run your first sync. [Installation guide](https://skillshare.runkids.cc/docs/getting-started/desktop-app).
### Desktop App — visual setup and daily management
[Skillshare App](https://github.com/runkids/skillshare-app) puts skills, agents, MCP and hooks in a desktop window. Install the app, open it, and follow first-launch setup.
macOS (Apple Silicon), with Homebrew:
```bash
brew tap runkids/tap
brew install --cask skillshare-app
```
**Windows / Linux, or a manual macOS install:** [Download the latest app installers](https://github.com/runkids/skillshare-app/releases/latest). See the [Desktop App guide](https://skillshare.runkids.cc/docs/getting-started/desktop-app) for platform details.
### CLI: macOS / Linux
```bash
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
```
The script installs to `~/.local/bin` by default, so normal installs and updates do not need `sudo`. If the installer prints PATH setup instructions, follow them before running `skillshare`. Add the suggested line to your shell config (such as `~/.zshrc` or `~/.bashrc`) for future terminals. Set `INSTALL_DIR` to use another location.
### Windows PowerShell
```powershell
irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex
```
### CLI: Homebrew
```bash
brew install skillshare
```
> **Tip:** Run `skillshare upgrade` to update to the latest version. It auto-detects your install method and handles the rest.
### GitHub Actions
```yaml
- uses: runkids/setup-skillshare@v1
with:
source: ./skills
- run: skillshare sync
```
See [`setup-skillshare`](https://github.com/marketplace/actions/setup-skillshare) for all options (audit, project mode, version pinning).
### Shorthand (Optional)
Add an alias to your shell config (`~/.zshrc` or `~/.bashrc`):
```bash
alias ss='skillshare'
```
## Quick Start
```bash
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
```bash
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
```bash
skillshare target
---
## Support skillshare ❤️
skillshare is free and open source.
If skillshare saves you time, consider buying me a coffee.
Every contribution helps with ongoing development, cross-platform testing,
documentation, and maintenance.
[☕ Buy me a coffee](https://ko-fi.com/williehung)
You can also help by giving skillshare a ⭐ on GitHub!
## Star History
[](https://star-history.dera.page/#runkids/skillshare&type=date&legend=top-left)
---
## License
MIT