クロードコードのスキルとエージェントを移行するための実験ツールキット コーデックスエコシステム。 再使用可能なワークフローを Agent スキル パッケージに変換し、 カスタムエージェントTOMLファイルへの再利用可能なロール、MCPツール名空間を正規化 Codex は、ネイティブの Codex の subagent によって委任行動を保ち、 適切なオーケストレーション

⚠ Experimental — インターフェイス、アーティファクトレイアウト、および検証ルールは、 予告なく変更

それは何ですか

このリポジトリはマイグレーションシステムです。

クロードソースアーティファクトは.claude/skills/と.claude/agents/の下に住んでいます。 移行ワークフローは、Codex スキルパッケージとしてこのリポジトリに住んでおり、 Pythonスクリプト。 生成された出力は [.codex/skills/ の下の土地で、 [.codex/agents/]、バリデーションとトラッカーの状態でマイグレーションを維持 監査可能。

主要な建築決定:移行は盲目の翻訳ではありません

目標はワークフローの意図を最初に保存し、その動作を明示することです。 ネイティブのCodexの表面。 練習では、これは[SKILL.md]を意味します。 ワークフロー, [.codex/agents/*.toml] 再利用可能なロールのカスタムエージェント, アンダースコア正規化 MCP ツール名空間, [spawn_agent(...)]-スタイル

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/