mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
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
83 lines
1.9 KiB
Markdown
83 lines
1.9 KiB
Markdown
---
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
skillshare install runkids/my-skills
|
|
skillshare install anthropics/courses/prompt-eng
|
|
```
|
|
|
|
## Step 4: Sync Everything
|
|
|
|
```bash
|
|
skillshare sync
|
|
```
|
|
|
|
One command pushes all skills to every target. Each target gets symlinks pointing back to your single source.
|
|
|
|
## Step 5: Verify
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
# Cursor follows symlinks fine (default)
|
|
skillshare target cursor --mode merge
|
|
|
|
# Some tools need real files
|
|
skillshare target opencode --mode copy
|
|
```
|
|
|
|
## What's Next?
|
|
|
|
- [Understand sync modes →](/docs/understand/sync-modes)
|
|
- [Cross-machine sync →](/docs/how-to/sharing/cross-machine-sync)
|
|
- [Team sharing →](/docs/how-to/sharing/organization-sharing)
|