Sync Skill

Overview

Sync a skill from this repository by making ~/.claude/skills/<skill> the source-facing symlink to the repo skill, then making ~/.agents/skills/<skill> and ~/.codex/skills/<skill> point at the Claude skill path.

Codex discovers local functionality from ~/.codex/skills in this setup. Do not install command files into ~/.codex/commands expecting Codex to recognize them. When the source artifact is a repo command under commands/<name>.md, use $sync-command; it creates or reuses a command-backed skill for Codex.

Use the bundled script for the filesystem changes so repeated syncs update links consistently.

Workflow

1. Identify the repo skill name or path. Prefer a skill name when the source is skills/<name>.
2. Inspect the source skill and confirm it contains SKILL.md.
3. Run the installer:

python3 <this-skill-dir>/scripts/install_local_skill.py <skill-name-or-path>