skillshare

One source of truth for all your AI CLI skills.
Edit once, sync everywhere — Claude, Moltbot, Codex, Antigravity and 30+ more.

Install • Quick Start • Commands • Team Edition • Docs

Note

What's New in 0.6.0 — Team Edition: Tracked repos, nested skills, auto-pruning, collision detection. Learn more →

Why skillshare?

Install tools get skills onto agents. Skillshare keeps them in sync.

	Install-once tools	skillshare
After install	Done, no management	Continuous sync across all agents
Update a skill	Re-install manually	Edit once, sync everywhere
Pull back edits	✗	Bidirectional — pull from any agent
Cross-machine	✗	push/pull via git
Team sharing	Copy-paste	Tracked repos — update to stay current
AI integration	Manual CLI	Built-in skill — AI operates it directly

AI-Native

The built-in skillshare skill teaches your AI how to manage skills. The binary auto-downloads on first use.

User: "sync my skills to all targets"
       │
       ▼
AI reads skillshare skill → runs: skillshare sync
       │
       ▼
✓ Synced 5 skills to claude, codex, cursor

Try it: "Show my skillshare status", "Pull skills from Claude", "Install the pdf skill from anthropics/skills"

Installation

Quick Install

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

Homebrew (macOS)

brew install runkids/tap/skillshare

Uninstall

brew uninstall skillshare               # Homebrew
sudo rm /usr/local/bin/skillshare       # Manual install
rm -rf ~/.config/skillshare             # Config & data (optional)

Shorthand (Optional)

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

alias ss='skillshare'

Quick Start

skillshare init --dry-run  # Preview setup
skillshare init            # Auto-detects CLIs, sets up git
skillshare sync            # Sync to all targets

Done. Your skills are now synced across all AI CLI tools.

How It Works

┌─────────────────────────────────────────────────────────────┐
│                  ~/.config/skillshare/skills/               │
│            (single source of truth — edit here)             │
└─────────────────────────────────────────────────────────────┘
                              │ sync
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
       ┌───────────┐   ┌───────────┐   ┌───────────┐
       │  Claude   │   │  Cursor   │   │  Codex    │   ...
       └───────────┘   └───────────┘   └───────────┘

Commands

Command	Description
init	Initialize, auto-detect CLIs, setup git
new <name>	Create a new skill with SKILL.md template
sync	Sync skills to all targets
pull <target>	Pull skills from target back to source
push	Push to git remote (cross-machine)
install <source>	Install skill from path or git repo
uninstall <name>	Remove skill from source
update <name>	Update skill or tracked repo
list	List installed skills
status	Show sync state
doctor	Diagnose issues
upgrade	Upgrade CLI and skill

Target Management

skillshare target list                    # List targets
skillshare target add myapp ~/.myapp/skills  # Add custom target
skillshare target remove claude           # Safely unlink

See Documentation for complete reference.

---

Team Edition

Share skills across your team with tracked repositories.

# Install team repo
skillshare install github.com/team/skills --track

# Update later
skillshare update _team-skills
skillshare sync

Features:

• Tracked repos — Clone with .git, update via git pull
• Nested skills — team/frontend/ui → team__frontend__ui
• Auto-pruning — Orphaned symlinks removed on sync
• Collision detection — Warns about duplicate skill names

See Team Edition Guide for details.

---

FAQ

What if I modify a skill in a target directory?

Since targets are symlinks, you're editing the source directly. All targets see changes immediately.

How do I keep CLI-specific skills?

Use merge mode (default). Local skills in targets are preserved.

Accidentally deleted a skill through symlink?

Recover with git: cd ~/.config/skillshare/skills && git checkout -- deleted-skill/

See FAQ & Troubleshooting for more.

---

Common Issues

Issue	Solution
config not found	Run skillshare init
Deleted source via symlink	Use skillshare target remove, recover via git
Target exists with files	Run skillshare backup first
Skill not appearing	Run skillshare doctor, restart CLI

---

Documentation

• docs/ — Documentation index
• install.md — Install, update, upgrade skills
• sync.md — Sync, pull, push, backup
• targets.md — Target management
• team-edition.md — Team sharing with tracked repos
• cross-machine.md — Multi-machine sync
• faq.md — FAQ & troubleshooting

---

Contributing

git clone https://github.com/runkids/skillshare.git
cd skillshare
go build -o bin/skillshare ./cmd/skillshare
go test ./...

Open an issue for bugs or feature requests.

Star History

License

MIT