skillshare

skillshare

English · 日本語 · 한국어 · 简体中文 · 繁體中文

Website License: MIT Release Platform Go Report Card Ask DeepWiki Support skillshare on Ko-fi

Star on GitHub

runkids%2Fskillshare | Trendshift

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

skillshare demo

| Skill Detail | Security Audit | |---|---| | CLI sync output | CLI install with security audit | | UI Dashboard | UI Skills | |---|---| | Web dashboard overview | Web UI skills page | ## 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 --mode copy skillshare sync ``` **Security audit** —scan before skills reach your agent ```bash skillshare audit ``` **Project skills** —per-repo, committed with your code ```bash skillshare init -p && skillshare sync ``` **Agents** —sync custom agents to agent-capable targets ```bash skillshare sync agents # sync agents only skillshare sync --all # sync skills + agents + extras + MCP + hooks together ``` **Extras** —manage rules, commands, prompts & more ```bash skillshare extras init rules # create a "rules" extra skillshare sync --all # sync skills + agents + extras + MCP + hooks together skillshare extras collect rules # collect local files back to source ``` **MCP connections** —configure once for Claude Code, Codex, Cursor, VS Code, OpenCode and more ```bash skillshare mcp add # guided URL or JSON setup skillshare sync mcp --dry-run # preview native configuration changes skillshare sync mcp # apply connection settings ``` Keep definitions in `config.yaml` or reference a separate `mcp.yaml`. See [MCP setup](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-mcp) for examples, environment references and importing existing connections. Manage native hooks without executing them: ```bash skillshare hooks add check --file ./check.yaml skillshare hooks sync --dry-run skillshare hooks sync ``` **Plugins** —install a complete plugin and pick which tools receive it ```bash skillshare plugin add # guided: source, plugin, targets, review skillshare plugin add owner/repo --target claude --target codex --no-tui skillshare sync plugins --dry-run # plugins sync separately from sync --all ``` Existing native installations can be adopted with `plugin import`. See [Manage plugins across tools](https://skillshare.runkids.cc/docs/how-to/daily-tasks/sharing-plugins). **Shell completion** —tab-complete commands, flags, and subcommands ```bash skillshare completion bash --install # also: zsh, fish, powershell, nushell ``` **Local checkpoints** — commit source changes without pushing ```bash skillshare commit -m "Update review skill" skillshare commit --dry-run ``` **Web dashboard** — visual control panel ```bash skillshare ui ``` [All commands & guides →](https://skillshare.runkids.cc/docs/reference/commands) ## Contributing Contributions welcome! Open an issue first, then submit a draft PR with tests. See [CONTRIBUTING.md](CONTRIBUTING.md) for setup details. ```bash git clone https://github.com/runkids/skillshare.git && cd skillshare make check # format + lint + test ``` > [!TIP] > Not sure where to start? Browse [open issues](https://github.com/runkids/skillshare/issues) or try the [Playground](https://skillshare.runkids.cc/docs/learn/with-playground) for a zero-setup dev environment. ## Contributors Thanks to everyone who helped shape skillshare. leeeezx Vergil333 romanr xocasdashdash philippe-granet terranc benrfairless nerveband EarthChen gdm257 skovtunenko TyceHerrman 1am2syman thealokkr JasonLandbridge masonc15 richardwhatever reneleonhardt ndeybach hhh2210 leoarry salmonumbrella daylamtayari dstotijn ipruning massukio kevincobain2000 StephenPAdams mk-imagine Curtion amdoi7 jessica-engel AlimuratYusup thor-shuang bishopmatthew chaosky iFwu ildunari aestilog xarthurx m0cun bit3125 eekryuos Bongseop-Kim sophodex PeterTianbuhan dotned ismferd jblackburn21 jnhu76 jacobleft rhysmcneill druellan 12britz askpatrickw Almost42 Brett-Best isCopyman svob michal-grzelak shikbupt LeoYeAI TIR44 Ajaymamtora vishaldialpad kankan0829 dnabb thinhngotony skaurus jamesbraza 2BAB zdlldz elstiaan EriaWalker FaintFlower yantinglin21 chung1912 r-fynn cescox hhdebb Snurppa s0undt3ch danscheer 7zq12lvm-b DarkiT harisonw --- ## 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 [![Star History Chart](https://star-history.dera.page/svg?repos=runkids/skillshare&type=date&legend=top-left)](https://star-history.dera.page/#runkids/skillshare&type=date&legend=top-left) --- ## License MIT