migrate-claude

Plans a reversible migration of Claude Code project configuration into Codex format.

13|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/frabcd/codex-ai-game-studio --skill migrate-claude-frabcd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-claude
Source: https://github.com/frabcd/codex-ai-game-studio/tree/main/plugins/ai-game-studio-automation/skills/migrate-claude
Command: npx skills add https://github.com/frabcd/codex-ai-game-studio --skill migrate-claude-frabcd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Moving a game project from Claude Code to Codex normally means manually rewriting CLAUDE.md guidance, slash commands, agents, and hooks, with a real risk of losing or corrupting existing configuration. This Skill inspects the Claude project and produces a reviewed, confirmed, and reversible migration plan instead of blind overwrites. ## Core Features & Use Cases - Project Inspection: Reads CLAUDE.md, .claude/, AGENTS.md, .codex/, engine markers, and uncommitted work without modifying anything. - Planned Conversion: Maps Claude slash commands to namespaced $ai-game-studio skill references, converts guidance into root or scoped AGENTS.md files, and places supported agent definitions under .codex/agents/. - Safety Gates: Blocks unsupported Claude-only model names, tool declarations, memory fields, and fixed turn limits, then requires verbatim digest confirmation before applying changes with full rollback support. - Use Case: A studio with an existing Claude Code game project wants to adopt Codex; the Skill generates a migration plan, waits for digest confirmation, applies it, and validates the result with tests and a rollback path. ## Quick Start Use the migrate-claude skill to inspect this Claude Code game project and propose a reversible Codex migration plan before changing any files.

Frequently Asked Questions about migrate-claude

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

FAQPage Schema
How do I migrate a Claude Code project to Codex?

Run the migrate claude command against the project root to generate a plan JSON, review every proposed destination, then confirm the digest verbatim before applying with pack apply. The original Claude files stay unchanged for comparison and rollback.

What happens to Claude slash commands during migration?

Claude slash commands are converted into namespaced $ai-game-studio skill references in the migration plan. Engine and project guidance becomes root or scoped AGENTS.md content, and supported agent definitions move under .codex/agents/.

Can the migration overwrite my existing AGENTS.md or Codex files?

No. If destination files already contain user-authored guidance, the process stops at the proposal stage and shows the overlap. It never silently merges policy text whose precedence is unclear.

Which Claude features are not supported in a Codex migration?

Claude-only model names, tool declarations, memory fields, fixed turn limits, and certain paths are blocked from entering Codex runtime files. These items are flagged during plan review rather than converted.

How do I roll back a Claude to Codex migration?

The applied migration records a transaction ID and supports generating a rollback plan from it. Because the original Claude files are never modified, you can also compare and restore the pre-migration state directly.