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