What problem does it solve?
Wire .agents/skills as a symlink to .claude/skills so Codex and Gemini CLI can read skills from the same canonical location Claude does. Use this skill whenever the user mentions syncing skills across platforms, the .agents/skills directory is missing or broken, after cloning a fresh checkout, or when the user says things like "set up the skills mirror", "wire up the skills symlink", "make Codex see our skills", or "sync skills". Idempotent — safe to invoke even if the link is already in place. Also fires the underlying script automatically via PostToolUse hook on every edit under .claude/skills/ so manual invocation is rarely needed in normal authoring flow.
Core Features & Use Cases
- Symlink management: Ensures
.agents/skills points to .claude/skills for cross-CLI discovery.
- Idempotent safety: Re-runs without changing the outcome if already synced.
- Automation integration: Triggers the PostToolUse hook to keep skills in sync automatically.
Quick Start
Run the script at .claude/skills/sync-skills/scripts/sync-skills.sh to synchronize the skills mirror.