sync-skills

Synchronize the .agents/skills symlink to the .claude/skills location.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jmagar/rust-bin --skill sync-skills-jmagar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-skills
Source: https://github.com/jmagar/rust-bin/tree/main/.claude/skills/sync-skills
Command: npx skills add https://github.com/jmagar/rust-bin --skill sync-skills-jmagar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

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.

Frequently Asked Questions about sync-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync skills across Claude, Codex, and Gemini?▼

To sync skills across Claude, Codex, and Gemini, this skill wires the `.agents/skills` directory as a symlink to the canonical `.claude/skills` location. This allows all three CLIs to read a unified set of skills from one source.

Why does my .agents/skills directory break after a fresh checkout?▼

The `.agents/skills` symlink can break after a fresh checkout because relative symlinks do not always persist correctly across different version control systems. Run the sync script to recreate the relative symlink and restore cross-CLI skill discovery safely.

How do I make Codex see our existing Claude skills?▼

To make Codex see existing Claude skills, you need to create a symlink from `.agents/skills` pointing to `.claude/skills`. This skill automates that process, establishing a unified skills directory for both platforms.

Is it safe to run a skills sync script if the symlink is already in place?▼

Yes, running this skills sync script is completely safe if the symlink is already in place. The script is idempotent, meaning re-running it will not change the outcome or overwrite real directories, and it simply reports the current status.

Does the skills sync run automatically when I edit Claude skills?▼

Yes, the skills sync runs automatically when you edit Claude skills. It triggers a PostToolUse hook on every edit made under the `.claude/skills/` directory, ensuring the symlink stays synced without requiring manual invocation.