Files
skillshare/website/docs/learn/with-multiple-tools.md
T
Willie 69d643525d fix(targets): point the codex target at ~/.agents/skills
Codex documents ~/.agents/skills as its user-level skills path and marks
~/.codex/skills as deprecated, while still reading both. It does not merge
skills that share a name, so the default init result (codex + universal)
showed every skill twice in Codex.

The codex target now defaults to the shared directory, keeps the old path
in also_scans, and is detected through ~/.codex. A fresh init therefore sets
up only `universal` for Codex and writes each skill once. Existing configs
keep their pinned path and still get the doctor overlap warning that
suggests removing the codex target.

Refs #135
2026-09-21 02:21:49 +08:00

1.9 KiB

sidebar_position
sidebar_position
4

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
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?