Skip to main content

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

This detects Codex's skill directory (~/.codex/skills/) and adds it as a target automatically.

Step 3: Install Your First Skill​

skillshare install runkids/my-skills

Step 4: Sync​

skillshare sync

Skills are symlinked to ~/.codex/skills/.

Step 5: Verify​

ls ~/.codex/skills/

You should see your installed skill symlinked.

Codex-Specific Notes​

  • Skill path: ~/.codex/skills/ (global) or .agents/skills/ (project)
  • 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?​