agent-config-sync

name	agent-config-sync
description	Use when syncing, auditing, or converting Claude Code and Codex project configuration; when the user says "sync agent configs", "convert Claude project to Codex", "convert Codex project to Claude", "make this project work with both Claude and Codex", or asks to keep AGENTS.md, CLAUDE.md, .claude, .codex, .mcp.json, agents, commands, and skills aligned.

Agent Config Sync

Keep Claude Code and Codex adapters aligned without pretending their config formats are identical.

What syncs

• CLAUDE.md <-> AGENTS.md project instructions
• .claude/agents/*.md <-> .codex/agents/*.toml subagent/custom-agent definitions
• .claude/commands/*.md -> .agents/skills/claude-command-*/SKILL.md Codex workflow skills
• .claude/skills/*/SKILL.md <-> .agents/skills/*/SKILL.md project-local skills
• .mcp.json <-> [mcp_servers.*] entries in .codex/config.toml
• .codex/config.toml project defaults for Codex instruction fallback and subagent limits

Do Not Sync Blindly

• Claude hooks and Codex hooks are not guaranteed to have the same event payloads. Keep hook scripts shared only after checking each hook's stdin schema.
• Claude permissions in .claude/settings.json and Codex approval rules in .codex/rules/*.rules use different policy languages. Convert intent, not syntax.
• Existing project-specific files win unless the user passes --force or explicitly asks to overwrite.

Workflow

Run an audit first:

python3 /path/to/claudet/skills/agent-config-sync/scripts/agent_config_sync.py --target . --check

Apply missing adapters:

python3 /path/to/claudet/skills/agent-config-sync/scripts/agent_config_sync.py --target .

Overwrite stale generated adapters only when the user explicitly asks:

python3 /path/to/claudet/skills/agent-config-sync/scripts/agent_config_sync.py --target . --force

Convert in one direction only:

python3 /path/to/claudet/skills/agent-config-sync/scripts/agent_config_sync.py --target . --direction claude-to-codex
python3 /path/to/claudet/skills/agent-config-sync/scripts/agent_config_sync.py --target . --direction codex-to-claude

Safety Rules

• Treat root skills/ as the shared global skill source for claudet itself; do not copy it into generated projects.
• Keep project-local skills in .claude/skills/ and .agents/skills/ only when they reference that specific codebase.
• After syncing, inspect git diff and validate any generated TOML/JSON before committing.

Common Prompts

• "Make this Claude project Codex-compatible."
• "Audit this repo for Claude/Codex config drift."
• "Convert Codex agents back into Claude agents."
• "Sync MCP and skills between Claude and Codex here."