syncing-claude-codex

Synchronizes Claude and Codex skill directories bidirectionally with YAML frontmatter handling and path substitution.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/pelchers/MockTrialGame --skill syncing-claude-codex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: syncing-claude-codex
Source: https://github.com/pelchers/MockTrialGame/tree/main/.claude/skills/syncing-claude-codex
Command: npx skills add https://github.com/pelchers/MockTrialGame --skill syncing-claude-codex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides bidirectional synchronization between the Claude (.claude/) and Codex (.codex/) provider directories to keep agents, skills, and system documentation consistent, handling format transformations and path references.

Core Features & Use Cases

  • Maintains parity of definitions across both repositories by syncing changes from either side.
  • Handles provider-specific conventions and path substitutions during the transformation process.
  • Supports verification steps and structured workflows to ensure completeness and accuracy.

Quick Start

Execute a Claude-to-Codex sync for all skills to align both provider directories.

Frequently Asked Questions about syncing-claude-codex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep Claude and Codex skill directories synchronized?

To keep Claude and Codex skill directories synchronized, you can use a bidirectional sync process that propagates updates from either the .claude/ or .codex/ directories to maintain cross-repo parity. It handles path substitution and YAML frontmatter formatting.

What does bidirectional sync do for Claude and Codex agent definitions?

Bidirectional sync for Claude and Codex agent definitions ensures consistent definitions across both providers by applying per-item transformation rules and handling provider-specific path conventions during updates. This parity prevents configuration drift.

Can I sync YAML frontmatter between Claude and Codex directories?

Yes, you can sync YAML frontmatter between Claude and Codex directories. The sync process handles YAML frontmatter formatting natively, ensuring metadata is correctly transformed and maintained across both provider directories during synchronization.

How do I handle path substitution when syncing content to the Codex directory?

When syncing content to the Codex directory, path substitution is handled automatically by applying per-item transformation rules, which adjusts internal references to match the target provider's directory structure and conventions.

Does the Claude and Codex directory sync support references and assets subdirectories?

Yes, the Claude and Codex directory sync supports optional references, scripts, and assets subdirectories, ensuring these additional resources are included when synchronizing skills, agents, or system docs across providers.

What's the best way to maintain cross-repo parity for system docs across providers?

The best way to maintain cross-repo parity for system docs is to execute a bidirectional sync after creating or updating documents in either provider, ensuring structured workflows and verification steps confirm completeness across both repositories.