skillshare

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

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.

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

[!NOTE]

Latest: v0.21.0 — define MCP connections once and sync them into each Agent's native config; install and sync complete plugins across Claude, Codex, Cursor and more; and a redesigned web dashboard with Clean and Playful styles. 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 & 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
• MCP connections — define a server once, sync it into each Agent's own config format with sync mcp
• Complete plugins — keep a plugin's skills, hooks and MCP settings together and choose which tools receive it with plugin
• 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/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 (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 | |---|---| | | |

| UI Dashboard | UI Skills | |---|---| | | |

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.

GitHub Actions

- uses: runkids/setup-skillshare@v1
  with:
    source: ./skills
run: skillshare sync

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

Agents —sync custom agents to agent-capable targets

skillshare sync agents            # sync agents only
skillshare sync --all             # sync skills + agents + extras + MCP together

Extras —manage rules, commands, prompts & more

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

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 for examples, environment references and importing existing connections.

Plugins —install a complete plugin and pick which tools receive it

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.

Shell completion —tab-complete commands, flags, and subcommands

skillshare completion bash --install   # also: zsh, fish, powershell, nushell

Local checkpoints — commit source changes without pushing

skillshare commit -m "Update review skill"
skillshare commit --dry-run

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.

If you find skillshare useful, consider giving it a ⭐

Star History