<img src=".github/assets/logo.png" alt="skillshare" width="280"> <h1 align="center" style="margin-top: 0.5rem; margin-bottom: 0.5rem;">skillshare</h1> <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> <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue" alt="Platform"> <a href="https://goreportcard.com/report/github.com/runkids/skillshare"><img src="https://goreportcard.com/badge/github.com/runkids/skillshare" alt="Go Report Card"></a> <a href="https://deepwiki.com/runkids/skillshare"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a> <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> One source of truth for AI CLI skills, rules, commands & more. Sync everywhere with one command — from personal to organization-wide. Codex, Claude Code, OpenClaw, OpenCode & 50+ more. <img src=".github/assets/demo.gif" alt="skillshare demo" width="960"> <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="https://skillshare.runkids.cc/docs">Docs</a>

[!NOTE] Latest: v0.17.0 — first-class extras, Web UI redesign, GitLab custom domain support. All 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 & 50+ more with skillshare sync
More than skills — manage rules, commands, prompts & any file-based resource with extras
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, SKILL.md targets, and per-target include/exclude

Coming from another tool? Migration Guide · Comparison

How It Works

macOS / Linux: ~/.config/skillshare/
Windows: %AppData%\skillshare\

┌─────────────────────────────────────────────────────────────┐
│                    Source Directory                         │
│   ~/.config/skillshare/skills/    ← skills (SKILL.md)       │
│   ~/.config/skillshare/extras/    ← rules, commands, etc.   │
└─────────────────────────────────────────────────────────────┘
                              │ sync
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
       ┌───────────┐   ┌───────────┐   ┌───────────┐
       │  Claude   │   │  OpenCode │   │ OpenClaw  │   ...
       └───────────┘   └───────────┘   └───────────┘

| Platform | Skills Source | Extras Source | Link Type | |----------|---------------|---------------|-----------| | macOS/Linux | ~/.config/skillshare/skills/ | ~/.config/skillshare/extras/ | Symlinks | | Windows | %AppData%\skillshare\skills\ | %AppData%\skillshare\extras\ | NTFS Junctions (no admin required) |

| | 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 →

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

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex

Homebrew

brew install skillshare

Tip: Run skillshare upgrade to update to the latest version. It auto-detects your install method and handles the rest.

Shorthand (Optional)

Add an alias to your shell config (~/.zshrc or ~/.bashrc):

alias ss='skillshare'

Quick Start

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

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

skillshare target <name> --mode copy
skillshare sync

Security audit —scan before skills reach your agent

skillshare audit

Project skills —per-repo, committed with your code

skillshare init -p && skillshare sync

Extras —manage rules, commands, prompts & more

skillshare extras init rules          # create a "rules" extra
skillshare sync --all                 # sync skills + extras together
skillshare extras collect rules       # collect local files back to source

Web dashboard —visual control panel

skillshare ui

All commands & guides →

Contributing

Contributions welcome! Open an issue first, then submit a draft PR with tests. See CONTRIBUTING.md for setup details.

git clone https://github.com/runkids/skillshare.git && cd skillshare
make check  # format + lint + test

[!TIP] Not sure where to start? Browse open issues or try the Playground for a zero-setup dev environment.

Contributors

Thanks to everyone who helped shape skillshare.

<a href="https://github.com/leeeezx"><img src="https://github.com/leeeezx.png" width="50" style="border-radius:50%" alt="leeeezx"></a> <a href="https://github.com/Vergil333"><img src="https://github.com/Vergil333.png" width="50" style="border-radius:50%" alt="Vergil333"></a> <a href="https://github.com/romanr"><img src="https://github.com/romanr.png" width="50" style="border-radius:50%" alt="romanr"></a> <a href="https://github.com/xocasdashdash"><img src="https://github.com/xocasdashdash.png" width="50" style="border-radius:50%" alt="xocasdashdash"></a> <a href="https://github.com/philippe-granet"><img src="https://github.com/philippe-granet.png" width="50" style="border-radius:50%" alt="philippe-granet"></a> <a href="https://github.com/terranc"><img src="https://github.com/terranc.png" width="50" style="border-radius:50%" alt="terranc"></a> <a href="https://github.com/benrfairless"><img src="https://github.com/benrfairless.png" width="50" style="border-radius:50%" alt="benrfairless"></a> <a href="https://github.com/nerveband"><img src="https://github.com/nerveband.png" width="50" style="border-radius:50%" alt="nerveband"></a> <a href="https://github.com/EarthChen"><img src="https://github.com/EarthChen.png" width="50" style="border-radius:50%" alt="EarthChen"></a> <a href="https://github.com/gdm257"><img src="https://github.com/gdm257.png" width="50" style="border-radius:50%" alt="gdm257"></a> <a href="https://github.com/skovtunenko"><img src="https://github.com/skovtunenko.png" width="50" style="border-radius:50%" alt="skovtunenko"></a> <a href="https://github.com/TyceHerrman"><img src="https://github.com/TyceHerrman.png" width="50" style="border-radius:50%" alt="TyceHerrman"></a> <a href="https://github.com/1am2syman"><img src="https://github.com/1am2syman.png" width="50" style="border-radius:50%" alt="1am2syman"></a> <a href="https://github.com/thealokkr"><img src="https://github.com/thealokkr.png" width="50" style="border-radius:50%" alt="thealokkr"></a> <a href="https://github.com/JasonLandbridge"><img src="https://github.com/JasonLandbridge.png" width="50" style="border-radius:50%" alt="JasonLandbridge"></a> <a href="https://github.com/masonc15"><img src="https://github.com/masonc15.png" width="50" style="border-radius:50%" alt="masonc15"></a> <a href="https://github.com/reneleonhardt"><img src="https://githu

Skillshare

Install / Use

README