---

name: claude-skill-sync description: Copy or sync Claude skills from ~/.claude/skills into ~/.codex/skills so they are available in Codex. Use when asked to import, migrate, copy, or sync Claude skills, or when moving skills between Claude and Codex with optional repeatable sync.

Claude Skill Sync

Overview

Copy Claude skills into Codex using the bundled script. Default behavior is a safe one-off copy; sync mode supports repeatable runs with optional pruning. You can also include official Claude plugin skills.

Quick Start (One-Off Copy)

• Dry run to preview actions: python3 ~/.codex/skills/claude-skill-sync/scripts/claude_skill_sync.py --dry-run
• Run the copy (prompts on conflicts): python3 ~/.codex/skills/claude-skill-sync/scripts/claude_skill_sync.py
• Include official plugin skills: python3 ~/.codex/skills/claude-skill-sync/scripts/claude_skill_sync.py --include-official-plugins

If running from this repo, use: python3 skills/claude-skill-sync/scripts/claude_skill_sync.py

Conflict Handling

• Default --conflict ask prompts per skill: overwrite, skip, or abort.
• For non-interactive runs, set a policy explicitly:
  • --conflict overwrite
  • --conflict skip
  • --conflict abort
• In --dry-run, conflicts default to skip with a warning.

Repeatable Sync

Use --mode sync for repeatable updates:

• python3 ~/.codex/skills/claude-skill-sync/scripts/claude_skill_sync.py --mode sync --conflict ask
• Optional mirror cleanup (destructive): add --prune to remove Codex skills not present in Claude.

Paths and Filters

• Defaults:
  • Source: ~/.claude/skills
  • Destination: ~/.codex/skills
• Override with --source and --dest, add extra roots with --extra-source.
• Use --recursive to scan nested trees for SKILL.md.
• Official plugin skills: add --include-official-plugins.
• The script copies directories that contain SKILL.md.

scripts/

Executable code that performs the copy/sync operation.

• claude_skill_sync.py: Copy/sync Claude skills into Codex with conflict prompts.