Files
skillshare/website/docs/learn/with-codex.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.7 KiB

sidebar_position
sidebar_position
3

Using skillshare with Codex

From install to first sync — 5 minutes.

Prerequisites

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 codex at ~/.codex/skills, Codex keeps reading it. But with universal enabled as well, every skill shows up twice — remove the codex target (preview with skillshare target remove codex --dry-run)
  • Description limit: Codex has a 1024-character limit on skill descriptions. Keep the description field in SKILL.md frontmatter concise
  • Project mode: Run skillshare init -p to manage project-level Codex skills

What's Next?