skill-sync

Synchronize Claude Desktop skills across git, Codex, and Claude Code.

40|5|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/ShawhinT/non-coding-skills --skill skill-sync-shawhint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-sync
Source: https://github.com/ShawhinT/non-coding-skills/tree/main/skill-sync
Command: npx skills add https://github.com/ShawhinT/non-coding-skills --skill skill-sync-shawhint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

skill-sync helps keep your user-created Claude Desktop skills consistent and up to date across the canonical git repo, Codex, and Claude Code without manually copying files and hoping nothing diverged.

Core Features & Use Cases

  • Status visibility: Lists each endpoint (canonical, codex, claude_code, claude) with skill counts, file counts, and the full skill list so you can quickly spot drift.
  • Safe publishing workflow: Runs an idempotent sync with a dry-run preview first, then applies changes only after confirmation, including mirroring new/updated skills and propagating deletions.
  • Targeted removal workflow: Removes a specified skill from canonical and downstream targets via a dry-run plan followed by a confirmed apply, while clearly noting it does not delete from Claude Desktop.
  • Operational guardrails: Surfaces conflicts clearly (and skips canonical commits when conflicts are created) and supports flags like --dry-run and --no-commit for inspection.

Quick Start

Tell the agent: "Run skills-sync status, then sync my skills if anything is out of date."

Frequently Asked Questions about skill-sync

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

FAQPage Schema
How do I keep Claude Desktop skills synchronized across Codex and Claude Code?

To sync Claude skills, run the Python CLI via uv to execute a dry-run plan that detects endpoint drift, then confirm the apply action to mirror new and updated skills across canonical git, Codex, and Claude Code. This ensures all runtimes stay consistent without manual file copying.

What causes endpoint drift between Claude Desktop and Codex skill repositories?

Endpoint drift happens when user-created Claude Desktop skills are manually copied or edited independently across canonical git, Codex, and Claude Code runtimes. Running a status check lists each endpoint with skill and file counts to quickly spot where skills have diverged.

Can I check which Claude skills are live across all my runtimes before making changes?

Yes, you can run a status check to list each endpoint including canonical, Codex, Claude Code, and Claude Desktop. This visibility operation displays skill counts, file counts, and the full skill list for each target so you can spot drift before applying any sync operations.

How do I safely publish a new Claude skill to a canonical git repo and downstream targets?

You can safely publish a new Claude skill by running an idempotent sync with a dry-run preview first. After reviewing the planned changes, you confirm the apply step to mirror the skill to canonical git, Codex, and Claude Code while propagating any necessary deletions.

Does removing a skill from Codex and Claude Code also delete it from Claude Desktop?

No, the targeted removal workflow removes a specified skill from the canonical git repo and downstream targets like Codex and Claude Code, but it explicitly does not delete the skill from Claude Desktop. The removal process uses a dry-run plan followed by a confirmed apply step.

What happens when a sync operation encounters a conflict in the canonical git repository?

When a conflict is created during synchronization, the operational guardrails surface the conflict clearly and skip the canonical commit. You can use inspection flags like --dry-run and --no-commit to review the state before attempting to resolve the divergence and reapply the sync.