mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +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
1.7 KiB
1.7 KiB
sidebar_position
| sidebar_position |
|---|
| 3 |
Using skillshare with Codex
From install to first sync — 5 minutes.
Prerequisites
- OpenAI Codex CLI installed and working
- macOS, Linux, or Windows
Step 1: Install skillshare
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
Step 2: Initialize
skillshare init
Codex reads ~/.agents/skills/, the shared directory it documents as the user-level skills path. init detects Codex through its config directory (~/.codex/) and sets up the shared universal target for it automatically.
Step 3: Install Your First Skill
skillshare install runkids/my-skills
Step 4: Sync
skillshare sync
Skills are symlinked to ~/.agents/skills/.
Step 5: Verify
ls ~/.agents/skills/
You should see your installed skill symlinked.
Codex-Specific Notes
- Skill path:
~/.agents/skills/(global) or.agents/skills/(project) - Existing setups: if your config still points
codexat~/.codex/skills, Codex keeps reading it. But withuniversalenabled as well, every skill shows up twice — remove thecodextarget (preview withskillshare target remove codex --dry-run) - Description limit: Codex has a 1024-character limit on skill descriptions. Keep the
descriptionfield inSKILL.mdfrontmatter concise - Project mode: Run
skillshare init -pto manage project-level Codex skills