SKILL.md
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/claudeskillsync.py --dry-run
- Run the copy (prompts on conflicts):
python3 ~/.codex/skills/claude-skill-sync/scripts/claudeskillsync.py
- Include official plugin skills:
python3 ~/.codex/skills/claude-skill-sync/scripts/claudeskillsync.py --include-official-plugins
If running from this repo, use: python3 skills/claude-skill-sync/scripts/claudeskillsync.py
Conflict Handling
- Default
--conflict askprompts 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/claudeskillsync.py --mode sync --conflict ask- Optional mirror cleanup (destructive): add
--pruneto remove Codex skills not
present in Claude.
Paths and Filters
- Defaults:
- Source: ~/.claude/skills - Destination: ~/.codex/skills
- Override with
--sourceand--dest, add extra roots with--extra-source. - Use
--recursiveto scan nested trees forSKILL.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.
claudeskillsync.py: Copy/sync Claude skills into Codex with conflict prompts.