skillshare

skillshare

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

Website License: MIT Release Platform Go Report Card Ask DeepWiki

Star on GitHub

runkids%2Fskillshare | Trendshift

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.

skillshare demo

Website • Install • Quick Start • Highlights • Screenshots • Docs

> [!NOTE] > **Latest**: v0.21.* — manage **many project folders** from one global config with `projects:`; keep every teammate on the same commits with a **project lockfile**; define **MCP connections** once and sync them into each Agent's native config; and install and sync **complete plugins** across Claude, Codex, Cursor and more. [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) - **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 | Skill Detail | Security Audit | |---|---| | CLI sync output | CLI install with security audit | | UI Dashboard | UI Skills | |---|---| | Web dashboard overview | Web UI skills page | ## Installation ### macOS / Linux ```bash curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh ``` ### Windows PowerShell ```powershell irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex ``` ### 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 together ``` **Extras** —manage rules, commands, prompts & more ```bash skillshare extras init rules # create a "rules" extra skillshare sync --all # sync skills + agents + extras + MCP 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. **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 --- If you find skillshare useful, consider giving it a ⭐ ## 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