Claude Code 기술과 에이전트를 마이그레이션하기위한 실험 도구 키트 Codex 생태계. Reusable 작업 흐름을 Agent Skill Package로 변환합니다. 사용자 정의 시약 TOML 파일로 재사용 가능한 역할, MCP 툴 네임스페이스를 정상화 Codex 및 기본 Codex subagent를 통한 위임 행동 유지 적합한 관현.

⚠Experimental — 인터페이스, artifact 레이아웃 및 검증 규칙은 공지없이 변경.

그것이 무엇인지

이 저장소는 마이그레이션 시스템:

Claude 소스 artifacts는 .claude/skills/]와 .claude/agents/에서 살아있다. 마이그레이션 워크플로는 Codex 기술 패키지와 함께 이 저장소에 살고 Python 스크립트. 생성된 출력 토지 .codex/skills/ 및 .codex/agents/, 검증 및 추적기 상태로 마이그레이션 감사합니다.

키 건축 결정: 이주는 장님 transliteration 아닙니다

이 목표는 작업 흐름을 우선 보존하고, 그 행동을 사용하여 표현합니다. 기본 Codex 표면. 실습에서 이것은 SKILL.md 패키지를 의미합니다. 작업 흐름, .codex/agents/*.toml 재사용 가능한 역할에 대한 사용자 정의 에이전트, underscore-normalized MCP 도구 이름공간, 그리고 spawn_agent(...)-style

ccode-to-codex

Experimental toolkit for migrating Claude Code skills and agents into the Codex ecosystem. It converts reusable workflows into Agent Skill packages, reusable roles into custom-agent TOML files, normalizes MCP tool namespaces for Codex, and preserves delegation behavior through native Codex subagent orchestration where appropriate.

⚠ Experimental — interfaces, artifact layouts, and validation rules may change without notice.

What it is

This repository is a migration system:

Claude source artifacts -> migration workflows -> Codex-native outputs

Claude source artifacts live under .claude/skills/ and .claude/agents/. The migration workflows live in this repository as Codex skill packages and Python scripts. The generated outputs land under .codex/skills/ and .codex/agents/, with validation and tracker state to keep the migration auditable.

Key architectural decision: migration is not blind transliteration

The goal is to preserve workflow intent first, then express that behavior using native Codex surfaces. In practice, this means SKILL.md packages for workflows, .codex/agents/*.toml custom agents for reusable roles, underscore-normalized MCP tool namespaces, and spawn_agent(...)-style orchestration only for source workflows that genuinely delegate work.

Current capabilities

• Migrate Claude skills into Codex Agent Skill packages.
• Migrate Claude agents into Codex custom-agent TOML outputs.
• Classify blockers, dependency gaps, and manual-review cases before writes.
• Normalize MCP namespaces from source tool references into Codex-callable form.
• Preview or dry-run migrations before touching live .codex/ outputs.
• Validate migrated artifacts, refresh migration-state.json, and inspect progress with the dashboard.
• Provide minimal reference examples for both Agent Skills and custom agents.

What is actually required today

• Python 3.11+
• PyYAML>=6.0.2,<7 (installed via requirements.txt)
• Claude source inputs under .claude/skills/ and/or .claude/agents/
• OpenAI Codex CLI when consuming or exercising migrated .codex/ outputs

To invoke these migration workflows as Codex skills in a target repository, install the operational packages under that repository’s .codex/skills/ directory. The .claude/skills/ and .claude/agents/ directories are source inputs only; the migration reads them and writes Codex-facing outputs under .codex/.

mkdir -p /path/to/target-repo/.codex/skills
cp -R .codex/skills/migrate-to-codex /path/to/target-repo/.codex/skills/
cp -R .codex/skills/migrate-agents-to-codex /path/to/target-repo/.codex/skills/
cp -R .codex/skills/verify-skill-migration /path/to/target-repo/.codex/skills/
cp -R .codex/skills/migration-dashboard /path/to/target-repo/.codex/skills/