AI Command Transfer Agent

A Claude Code skill that migrates a Claude Code project's .claude/ configuration — slash commands, skills, subagents, and CLAUDE.md — into the equivalent Codex CLI (AGENTS.md + .codex/) and Gemini CLI (GEMINI.md + .gemini/) configurations.

Usage

From inside Claude Code (any working directory):

/migrate /absolute/path/to/target/repo

The skill will:

1. Validate that the target path exists and contains .claude/.
2. Read CLAUDE.md and everything under .claude/commands/, .claude/skills/, .claude/agents/.
3. Generate, in the same target repo:
   • AGENTS.md (Codex top-level instructions, with @-imports inlined)
   • .codex/prompts/<name>.md (one per Claude command/skill, plus agent-<name>.md per subagent)
   • GEMINI.md (Gemini top-level instructions, @-imports rewritten as @{...})
   • .gemini/commands/<name>.toml (one per Claude command/skill, plus agent/<name>.toml per subagent)
   • MIGRATION_REPORT.md describing what was migrated and what still needs manual review.

The source .claude/ directory is never modified.

Caveats (MVP)

• Codex prompts only auto-load from ~/.codex/prompts/. The generated AGENTS.md includes a one-line ln -s (or cp -r) command to activate the repo's .codex/prompts/ for the current user.
• Codex custom prompts are invoked as /prompts:<name>, not /<name> (CLI-imposed prefix).
• Subagents lose auto-dispatch on both targets — they're flattened into manually-invokable commands (/prompts:agent-<name> for Codex, /agent:<name> for Gemini).
• Codex doesn't support @file imports or Claude's bang-backtick shell-injection syntax. The migrator inlines @-references and annotates each shell-injection block with a TODO(migrate) comment for manual fixes.
• Gemini collapses positional/named args ($1, $NAMED) into a single {{args}} token — best-effort.

The generated MIGRATION_REPORT.md lists every dropped frontmatter field and every block that needs manual review.

Source-format → target-format mapping

See .claude/skills/migrate/SKILL.md for the full mapping spec.