mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
1f974712adc3b4bd993be9fa8b84c3d27af48ec1
skillshare
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
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
See docs/DETAILS.md for:
- Detailed installation (macOS/Linux/Windows)
- Sync modes and symlink safety
- Backup/restore and configuration
- FAQ and multi-machine workflows
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.
Common Issues
- Seeing
config not found: run 'skillshare init' first: runskillshare init(add--sourceif you want a custom path). - Integration tests cannot find the binary: run
go build -o bin/skillshare ./cmd/skillshareor setSKILLSHARE_TEST_BINARY. - Deleting a symlinked target removed source files: use
skillshare target remove <name>to unlink, then recover via git if needed. - Target directory already exists with files: run
skillshare backupbeforeskillshare syncto migrate safely. - Target path does not end with
skills: verify the path and prefer.../skillsas the suffix.
License
MIT
Description
No description provided
agent-pluginsaiai-agentsclaude-codeclicodexcross-machine-syncdesktop-appgohooksmcpopenclawopencodepipi-packageskillsskills-auditskills-managerskillshareteam-collaboration
Readme
MIT
176 MiB
Languages
Go
73.5%
TypeScript
20.1%
JavaScript
3.3%
Shell
1.4%
CSS
0.9%
Other
0.7%

