mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
v0.2.2
OpenCode uses singular 'skill' directory name. Update validation to use IsLikelySkillsPath() which recognizes both conventions.
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
173 MiB
Languages
Go
73.7%
TypeScript
20.2%
JavaScript
3%
Shell
1.4%
CSS
0.9%
Other
0.7%

