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.