Sync Codex Claude Skills

Compare skill directories across Claude and Codex, then safely sync all or selected skills in an explicit direction.

Script

Use:

python ~/pro/botfiles/codex/skills/sync-codex-claude-skills/scripts/sync_skills.py ...

The script auto-discovers repo root (claude/skills + codex/skills) from current directory. If needed, pass an explicit root:

python scripts/sync_skills.py --repo-root ~/pro/botfiles ...

Standard Workflow

1. Check drift first

python scripts/sync_skills.py status

This reports:

• skills only in claude/skills
• skills only in codex/skills
• skills in both but different
• skills in both and identical

2. Choose direction and scope

Decide sync direction explicitly:

• --from-side claude --to-side codex
• --from-side codex --to-side claude

Decide scope:

• --all for all source-side skills
• --skills <name...> for individual skill(s) or subset

3. Dry-run sync (default)

python scripts/sync_skills.py sync --from-side claude --to-side codex --all
python scripts/sync_skills.py sync --from-side claude --to-side codex --skills start-new-task get-task-status-file

Without --apply, script prints plan only (create, replace, unchanged) and makes no changes.

4. Apply sync

python scripts/sync_skills.py sync --from-side claude --to-side codex --all --apply
python scripts/sync_skills.py sync --from-side claude --to-side codex --skills start-new-task --apply

Optional pruning when syncing all:

python scripts/sync_skills.py sync --from-side claude --to-side codex --all --delete-target-extras --apply

This removes target-side skills absent from source.

Behavior Notes

• Sync copies full skill directories from source to target
• Existing target skill directories are replaced when content differs
• Hidden directories (for example .system) are ignored
• Only directories containing SKILL.md are treated as skills
• Script fails fast if requested --skills are missing on source side

Post-Sync Checks

After apply:

1. Re-run status and confirm drift decreased as expected
2. For new/updated Codex skills, run: python ~/pro/botfiles/codex/skills/.system/skill-creator/scripts/quick_validate.py <skill-dir>
3. Restart tool sessions if needed so refreshed skills are loaded