Tools
Skillshare
By ๐ Sync skills, agents, MCP, plugins to all AI CLI tools with one command and simplify team sharing.
Configuration Example
- uses: runkids/setup-skillshare@v1
with:
source: ./skills
- run: skillshare syncREADME
<p align="center" style="margin-bottom: 0;">
<img src=".github/assets/skillshare-logo-card.png" alt="skillshare" width="280">
</p>
<h1 align="center" style="margin-top: 0.5rem; margin-bottom: 0.5rem;">skillshare</h1>
<p align="center">
<a href="README.md">English</a> ยท <a href="README-de.md">Deutsch</a> ยท <a href="README-es.md">Espaรฑol</a> ยท <a href="README-fr.md">Franรงais</a> ยท <a href="README-ja.md">ๆฅๆฌ่ช</a> ยท <a href="README-ko.md">ํ๊ตญ์ด</a> ยท <a href="README-pt-BR.md">Portuguรชs</a> ยท <a href="README-zh-CN.md">็ฎไฝไธญๆ</a> ยท <a href="README-zh-TW.md">็น้ซไธญๆ</a>
</p>
<p align="center">
<a href="https://skillshare.runkids.cc"><img src="https://img.shields.io/badge/Website-skillshare.runkids.cc-blue?logo=docusaurus" alt="Website"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
<a href="https://github.com/runkids/skillshare/releases"><img src="https://img.shields.io/github/v/release/runkids/skillshare" alt="Release"></a>
<a href="https://github.com/runkids/skillshare/releases"><img src="https://img.shields.io/github/downloads/runkids/skillshare/total" alt="Downloads"></a>
<img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue" alt="Platform">
<a href="https://deepwiki.com/runkids/skillshare"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
<a href="https://ko-fi.com/williehung"><img src="https://img.shields.io/badge/Support-skillshare-FF5E5B?logo=kofi&logoColor=white" alt="Support skillshare on Ko-fi"></a>
</p>
<p align="center">
<a href="https://github.com/runkids/skillshare/stargazers"><img src="https://img.shields.io/github/stars/runkids/skillshare?style=social" alt="Star on GitHub"></a>
</p>
<p align="center">
<a href="https://trendshift.io/repositories/21835" target="_blank"><img src="https://trendshift.io/api/badge/repositories/21835" alt="runkids%2Fskillshare | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
<a href="https://trendshift.io/repositories/21835?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-21835" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/21835/daily?language=Go" alt="runkids%2Fskillshare | Trendshift" width="250" height="55"/></a>
</p>
<p align="center">
<strong>Your AI coding setup, everywhere.</strong><br>
Manage skills, agents, rules, MCP connections and hooks in one place.<br>
For Claude Code, Codex, Pi, OpenCode and more.
</p>
<p align="center">
<a href="https://skillshare.runkids.cc">Website</a> โข
<a href="#installation">Install</a> โข
<a href="#quick-start">Quick Start</a> โข
<a href="#highlights">Highlights</a> โข
<a href="#cli-and-ui-preview">Screenshots</a> โข
<a href="#desktop-app">Desktop App</a> โข
<a href="https://skillshare.runkids.cc/docs">Docs</a>
</p>
<p align="center">
<img src=".github/assets/demo.gif" alt="skillshare demo" width="960">
</p>
> [!NOTE]
> **Latest**: v0.26.0 โ Keep per-Agent MCP options in one source and serve an Executor skill index with `mcp serve --http`. Hooks can read code and scripts from files next to the config; OMP plugins now use their own marketplace builds. [All releases โ](https://github.com/runkids/skillshare/releases)
## Why skillshare
Switching AI tools should not mean rebuilding your setup.
skillshare gives your skills and other AI resources a home you control.
- **Switch tools, keep your skills** โ edit once, then sync to Claude Code, Codex, Pi and the other tools you use.
- **Take your setup with you** โ version your source in Git and pull it onto another machine.
- **Share with your team** โ keep project resources with your code and distribute shared skills through tracked repositories.
One teammate uses Claude Code, another uses Codex. Keep their shared code-review checklist in `.skillshare/` alongside the project. New teammates install the declared skills and sync to the configured tools instead of copying instructions from chat. [Team onboarding โ](https://skillshare.runkids.cc/docs/how-to/recipes/team-onboarding-recipe)
Use the desktop app or CLI to manage everything locally, [audit skills before use](https://skillshare.runkids.cc/docs/reference/commands/audit), and [choose what each tool receives](https://skillshare.runkids.cc/docs/how-to/daily-tasks/filtering-skills).
> Coming from another tool? [Migration Guide](https://skillshare.runkids.cc/docs/how-to/advanced/migration) ยท [Comparison](https://skillshare.runkids.cc/docs/understand/philosophy/comparison)
## CLI and UI Preview
| Skill Detail | Security Audit |
|---|---|
| <img src=".github/assets/skill-detail-tui.png" alt="CLI sync output" width="480" height="300"> | <img src=".github/assets/audit-tui.png" alt="CLI install with security audit" width="480" height="300"> |
| UI Dashboard | UI Skills |
|---|---|
| <img src=".github/assets/ui/web-dashboard-demo.png" alt="Web dashboard overview" width="480"> | <img src=".github/assets/ui/web-skills-demo.png" alt="Web UI skills page" width="480"> |
## 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).
<a id="desktop-app"></a>
### 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
```
## 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)
## 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 <name> --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** โ
... (truncated)
tools
Comments
Sign in to leave a comment