client.ts had grown to 1835 lines of types and calls for every page. In six months it changed in 71 commits, more than any other source file, so almost every dashboard change had to edit one oversized file. The transport now lives in http.ts, and each domain has its own call module and type file. client.ts stays as a barrel that composes the same api object. The 124 exported names and 145 api keys are unchanged, so importers and the tests that mock api/client need no edits. Domain modules import from http.ts, not from client.ts, which avoids an import cycle through the barrel.
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.* — 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 →
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.mdtargets, 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 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) |
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 upgradeto 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
See setup-skillshare for all options (audit, project mode, version pinning).
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
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
License
MIT



























































































