Willie f55e056fa4 feat: add comprehensive sandbox integration tests
Add complete integration test coverage for all CLI commands with
isolated sandbox environments that run on every change.

Changes:
- Add testutil package for sandbox test infrastructure
- Add 77 integration tests covering all commands (init, sync, status,
  diff, backup, restore, pull, doctor, target, version, help)
- Update CI workflow to run integration tests on Ubuntu and macOS
- Add SKILLSHARE_CONFIG env var support for test isolation
- Add mise.toml for task management
- Move scripts to scripts/ directory
2026-01-14 22:35:33 +08:00
2026-01-14 18:09:36 +08:00
2026-01-14 18:09:36 +08:00

skillshare

skillshare

License: MIT Go Version Release

Sync skills to all your AI CLI tools with one command
Supports Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode

skillshare demo

Install • Quick Start • Commands • FAQ

Installation

brew install runkids/tap/skillshare

Other methods: Detailed Installation

Quick Start

skillshare init    # Auto-detects installed CLIs, sets up git
skillshare sync    # Syncs skills to all targets

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

How It Works

┌─────────────────────────────────────────────────────────────┐
│                  ~/.config/skillshare/skills/               │
│         my-skill/   another-skill/   shared-util/           │
└─────────────────────────────────────────────────────────────┘
                              │
              ┌───────────────┼───────────────┐
              │               │               │
              ▼               ▼               ▼
       ┌───────────┐   ┌───────────┐   ┌───────────┐
       │  Claude   │   │   Codex   │   │  Gemini   │
       │  skills/  │   │  skills/  │   │  skills/  │
       └───────────┘   └───────────┘   └───────────┘

Commands

Command Description
init Initialize skillshare, detect CLIs, setup git
sync Sync skills to all targets
status Show source, targets, and sync state
diff Show differences between source and targets
pull Pull skills from target back to source
backup Manually backup targets
restore Restore from backup
doctor Diagnose configuration issues
target Manage targets (add/remove/list/mode)

Detailed Documentation

Detailed Installation

macOS

# Apple Silicon (M1/M2/M3/M4)
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_darwin_arm64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/

# Intel
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_darwin_amd64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/

Linux

# x86_64
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_linux_amd64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/

# ARM64
curl -sL https://github.com/runkids/skillshare/releases/latest/download/skillshare_linux_arm64.tar.gz | tar xz
sudo mv skillshare /usr/local/bin/

Windows

Download from Releases and add to PATH.

Uninstall

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

Sync Modes

Mode Behavior When to Use
merge Each skill symlinked individually. Local skills preserved. Recommended. Safe, flexible.
symlink Entire directory becomes symlink. All targets identical. When you want exact copies everywhere.

Change mode:

skillshare target claude --mode merge
skillshare sync

Deleting through a symlinked target deletes the source:

rm -rf ~/.codex/skills/my-skill  # ❌ Deletes from SOURCE!
skillshare target remove codex   # ✅ Safe way to unlink

Backup & Restore

Backups are created automatically before sync and target remove.

Location: ~/.config/skillshare/backups/<timestamp>/

skillshare backup              # Manual backup all targets
skillshare backup claude       # Backup specific target
skillshare backup --list       # List all backups
skillshare backup --cleanup    # Remove old backups

skillshare restore claude      # Restore from latest backup
skillshare restore claude --from 2026-01-14_21-22-18  # Specific backup

Note: In symlink mode, backups are skipped (no local data to backup).

Configuration

Config file: ~/.config/skillshare/config.yaml

source: ~/.config/skillshare/skills
mode: merge
targets:
  claude:
    path: ~/.claude/skills
  codex:
    path: ~/.codex/skills
    mode: symlink  # Override default mode
  cursor:
    path: ~/.cursor/skills
ignore:
  - "**/.DS_Store"
  - "**/.git/**"

Managing Targets

skillshare target list                        # List all targets
skillshare target claude                      # Show target info
skillshare target claude --mode merge         # Change mode
skillshare target add myapp ~/.myapp/skills   # Add custom target
skillshare target remove myapp                # Remove target

FAQ

How do I sync across multiple machines?

# Machine A: Push to remote
cd ~/.config/skillshare/skills
git remote add origin git@github.com:you/my-skills.git
git push -u origin main

# Machine B: Clone and init
git clone git@github.com:you/my-skills.git ~/.config/skillshare/skills
skillshare init --source ~/.config/skillshare/skills
skillshare sync

What happens if I modify a skill in the target directory?

Since targets are symlinks, changes are made directly to the source. All targets see the change immediately.

How do I keep a CLI-specific skill?

Use merge mode. Local skills in the target won't be overwritten.

What if I accidentally delete a skill through a symlink?

If you have git initialized (recommended), recover with:

cd ~/.config/skillshare/skills
git checkout -- deleted-skill/

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.

License

MIT

Languages
Go 73.7%
TypeScript 20.2%
JavaScript 3%
Shell 1.4%
CSS 0.9%
Other 0.7%