Agent skill · ma08
sync-codex-claude-skills
Compare, audit drift, and sync skills between botfiles-style visible skill trees (`claude/skills`, `codex/skills`) or hidden project-local skill trees (`.claude/skills`, `.codex/skills`), and sync local Codex skills against upstream skill repositories such as OpenAI curated skills or the Oracle skill with protected local forks. Use when the user asks to keep skills aligned across Claude and Codex, compare local skills to upstream, sync all or selected skills, or identify where drift exists.
What it needs
About 4k tokens when loaded.
What this skill does
Sync Codex Claude Skills Compare skill directories across Claude and Codex, and compare local Codex skills against upstream skill repositories. Use dry-run first, then apply only the changes you intend. Script Use: For upstream curated sync: The script auto-discovers repo root from the current directory. It supports both the botfiles/global visible layout (claude/skills, codex/skills) and the normal hidden project-local layout (.claude/skills, .codex/skills). If needed, pass an explicit root: The upstream sync script uses upstreamsyncpolicy.json in this skill directory by default. Pass --policy for other upstreams, such as the Oracle skill. Layout Convention For ordinary project-local skills, prefer .claude/skills and .codex/skills. Treat visible claude/skills and codex/skills as the botfiles/global exception unless a repo clearly documents a different convention. Botfiles uses visible skill directories because user-level global skill paths are symlinked there for source control and easier inspection. Workflow A: Claude <-> Codex 1. Check drift first This reports: skills only in the active Claude skill root (claude/skills or .claude/skills) skills only in the active Codex skill root (codex/skills or .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) Without --apply, script prints plan only (create, replace, unchanged) and makes no changes. 4. Apply sync Optional pruning when syncing all: This removes target-side skills absent from source. Workflow B: OpenAI Curated -> Codex -> Claude 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ma08/sync-codex-claude-skills