migrate-to-codex

Migrate Claude Code instructions, skills, agents, and MCP config to Codex.

Updated May 11, 2026
One-click install
npx skills add https://github.com/guhans6/agent-workbench --skill migrate-to-codex-guhans6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-to-codex
Source: https://github.com/guhans6/agent-workbench/tree/main/shared/skills/migrate-to-codex
Command: npx skills add https://github.com/guhans6/agent-workbench --skill migrate-to-codex-guhans6

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, toml, json, pathlib, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the migration of Claude Code assets, including instructions, skills, agents, and MCP config, into the Codex project and global files, saving time and reducing manual errors.

Core Features & Use Cases

  • Automated Migration: Migrates supported instruction files, skills, agents, and MCP config into Codex project and global files.
  • Customization: Allows users to specify the source and target directories for migration.
  • Validation: Validates the generated Codex artifacts and reports any issues.
  • Use Case: Imagine you have a large set of Claude Code assets that you want to migrate to Codex. Use this Skill to automate the migration process and ensure that all assets are correctly converted and validated.

Quick Start

Run the migrator with the following command:

MIGRATE_TO_CODEX='python3 .codex/skills/migrate-to-codex/scripts/migrate-to-codex.py' $MIGRATE_TO_CODEX --source ~/.claude/ --target ~/.codex/

Frequently Asked Questions about migrate-to-codex

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

FAQPage Schema
How do I migrate Claude Code assets to Codex?

You can migrate Claude Code assets to Codex by running a Python script that parses and converts instructions, skills, agents, and MCP config files into Codex project and global files.

What Claude Code configuration files can be transferred to Codex?

Supported Claude Code configuration files include instructions, skills, agents, and MCP config, which are parsed and converted into corresponding Codex project and global files.

Do I need Python to automate Claude Code asset migration?

Yes, you need Python along with libraries like toml, json, and pathlib to execute the migration script and perform the necessary file operations and data processing.

How do I specify source and target directories for Codex migration?

You can customize the migration by passing source and target directory arguments to the script, allowing you to map your Claude Code path to your Codex environment.

Can I validate migrated Codex artifacts automatically?

Yes, the migration process includes a validation step that checks the generated Codex artifacts and reports any issues found during the conversion.

What is the best way to move MCP config from Claude Code to Codex?

The best way to move MCP config is using an automated migration script that parses the original configuration and converts it directly into the Codex global file structure.