# Claude Skill Sync

> 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.

- Skill: `majiayu000/claude-skill-sync` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/claude-skill-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/claude-skill-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/claude-skill-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.