Skip to main content

Using skillshare with Multiple AI Tools

One source of truth, synced to every AI CLI you use.

The Problem​

You use Claude Code at work, Cursor for side projects, and Codex for experiments. Each has its own skill directory. Keeping them in sync manually is tedious and error-prone.

The Solution​

skillshare maintains a single source directory and syncs to all your targets with one command.

Step 1: Install and Initialize​

curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

If the installer prints PATH setup instructions, follow them before running the commands below. If it prints no PATH warning, no extra setup is needed.

skillshare init

init auto-detects all installed AI tools and adds them as targets.

Step 2: Check Your Targets​

skillshare target list

Example output:

  claude       ~/.claude/skills (merge)
  cursor       ~/.cursor/skills (merge)
  opencode     ~/.config/opencode/skills (merge)
  universal    ~/.agents/skills (merge)

Codex has no row of its own: it reads the shared ~/.agents/skills directory, so the universal target covers it.

Step 3: Install Skills​

skillshare install runkids/my-skills
skillshare install anthropics/courses/prompt-eng

Step 4: Sync Everything​

skillshare sync

One command pushes all skills to every target. Each target gets symlinks pointing back to your single source.

Step 5: Verify​

skillshare status

Shows sync status across all targets — which skills are synced, missing, or out of date.

Per-Target Mode Control​

Different tools have different needs. You can set sync mode per target:

# Cursor follows symlinks fine (default)
skillshare target cursor --mode merge

# Some tools need real files
skillshare target opencode --mode copy

What's Next?​