mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
v0.1.0
skillshare
Share skills across AI CLI tools (Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode).
The Problem
Each AI CLI tool has its own skills directory:
~/.claude/skills/
~/.codex/skills/
~/.cursor/skills/
~/.gemini/antigravity/skills/
~/.config/opencode/skills/
Keeping them in sync manually is tedious.
The Solution
skillshare maintains a single source directory and symlinks it to all CLI tools:
~/.skills/ <- Your skills live here (single source of truth)
├── my-skill/
└── another-skill/
~/.claude/skills -> ~/.skills (symlink)
~/.codex/skills -> ~/.skills (symlink)
~/.cursor/skills -> ~/.skills (symlink)
...
Installation
Using Go
go install github.com/runkids/skillshare/cmd/skillshare@latest
Using Homebrew (macOS/Linux)
brew install runkids/tap/skillshare
Download Binary
Download from Releases.
Quick Start
# 1. Initialize with default source directory (~/.skills)
skillshare init
# 2. Check detected targets
skillshare status
# 3. Sync (migrate existing skills + create symlinks)
skillshare sync
Usage
Initialize
# Use default source (~/.skills)
skillshare init
# Or specify custom source
skillshare init --source ~/my-skills
This will:
- Create the source directory
- Detect installed CLI tools
- Create config at
~/.config/skillshare/config.yaml
Sync
# Preview what will happen
skillshare sync --dry-run
# Actually sync
skillshare sync
On first sync, existing skills are migrated to the source directory, then symlinks are created.
Status
skillshare status
Shows:
- Source directory and skill count
- Each target's status (linked, has files, not exist, conflict)
Manage Targets
# List targets
skillshare target list
# Add custom target
skillshare target add myapp ~/.myapp/skills
# Remove target
skillshare target remove myapp
Configuration
Config file: ~/.config/skillshare/config.yaml
source: ~/.skills
mode: symlink
targets:
claude:
path: ~/.claude/skills
codex:
path: ~/.codex/skills
cursor:
path: ~/.cursor/skills
gemini:
path: ~/.gemini/antigravity/skills
opencode:
path: ~/.config/opencode/skills
ignore:
- "**/.DS_Store"
- "**/.git/**"
How It Works
- init: Detects CLI tools and creates config
- sync:
- If target has files → migrate to source, then symlink
- If target is empty/missing → just create symlink
- If already linked → skip
- status: Check symlink health
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%