Sync skills to all your AI CLI tools with one command
Supports Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode
Install • Quick Start • Commands • Detailed Docs • Common Issues
## Installation ```bash brew install runkids/tap/skillshare ``` > Other methods: [Detailed Installation](docs/DETAILS.md#detailed-installation) ## Quick Start ```bash 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 See [`docs/DETAILS.md`](docs/DETAILS.md) for: - Detailed installation (macOS/Linux/Windows) - Sync modes and symlink safety - Backup/restore and configuration - FAQ and multi-machine workflows ## Contributing ```bash git clone https://github.com/runkids/skillshare.git cd skillshare go build -o bin/skillshare ./cmd/skillshare go test ./... ``` [Open an issue](https://github.com/runkids/skillshare/issues) for bugs or feature requests. ## Common Issues - Seeing `config not found: run 'skillshare init' first`: run `skillshare init` (add `--source` if you want a custom path). - Integration tests cannot find the binary: run `go build -o bin/skillshare ./cmd/skillshare` or set `SKILLSHARE_TEST_BINARY`. - Deleting a symlinked target removed source files: use `skillshare target remove