Willie Hung 3dd3721dc8 fix: update path validation to accept both 'skills' and 'skill'
OpenCode uses singular 'skill' directory name. Update validation
to use IsLikelySkillsPath() which recognizes both conventions.
2026-01-15 00:02:24 +08:00
2026-01-14 23:56:07 +08:00
2026-01-14 23:56:07 +08:00
2026-01-14 18:09:36 +08:00
2026-01-14 18:09:36 +08:00
2026-01-14 23:56:07 +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 • 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: 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 <name> to unlink, then recover via git if needed.
  • Target directory already exists with files: run skillshare backup before skillshare sync to migrate safely.
  • Target path does not end with skills: verify the path and prefer .../skills as the suffix.

License

MIT

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