skillshare

skillshare

English · Deutsch · Español · Français · 日本語 · 한국어 · Português · 简体中文 · 繁體中文

Website License: MIT Release Downloads Platform Ask DeepWiki Support skillshare on Ko-fi

Star on GitHub

runkids%2Fskillshare | Trendshift runkids%2Fskillshare | Trendshift

Your AI coding setup, everywhere.
Manage skills, agents, rules, MCP connections and hooks in one place.
For Claude Code, Codex, Pi, OpenCode and more.

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

skillshare demo

> [!NOTE] > **Latest**: v0.30.6 — Catch outdated skills in CI: `skillshare check --exit-code` exits with code 1 when anything it checks is not up to date, and `check --all` now checks agents as well as skills, so one CI step covers both. [check reference →](https://skillshare.runkids.cc/docs/reference/commands/check) · [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 | |---|---| | 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. ### CLI: Nix ```bash nix profile add github:runkids/skillshare ``` Update with `nix profile upgrade skillshare`. Requires Nix 2.30+ with flakes enabled; on older Nix or Lix, use `nix profile install`. NixOS and Home Manager configurations can use the flake's `overlays.default`. ### 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 --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, Pi, 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 ``` **Herdr panel** — skillshare beside your agents in [Herdr](https://herdr.dev): updates, sync, audited installs and the source repo in one panel [Set up the Herdr panel →](https://skillshare.runkids.cc/docs/learn/with-herdr) [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 nathanvale LloydPowell771 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 FaintFlower yantinglin21 chung1912 r-fynn cescox hhdebb Snurppa s0undt3ch danscheer 7zq12lvm-b DarkiT harisonw wuhaoyujerry star-nebula AdamMagued mbury 483218131 neilforest7 johnkattenhorn aleps001 jskswamy heyAidy trojanwk charitarthchugh servaasvdc tomerzcod7 ErykJakubik --- ## 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 --- ## License MIT