How do I install the Handoff Codex skill?

Run npx skillmds@latest add claude-world-director-mode-lite/handoff-codex in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Handoff Codex safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Handoff Codex?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Handoff Codex free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Handoff Codex?

claude-world (@claude-world-director-mode-lite) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Handoff Codex by claude-world-director-mode-lite

Name: Handoff Codex
Author: claude-world

Handoff Codex

Continue a task in OpenAI Codex CLI through a portable Director handoff packet. Use when the user asks Codex to take over, wants an independent Codex implementation or review, or needs to preserve decisions and verification while changing CLIs.

claude-world Updated Sep 22, 2026

File contents

Handoff to Codex CLI

Use the shared session-relay workflow. Codex starts its own native session and reads a packet containing the goal, current state, decisions, Git evidence, verification, and next steps.

ROOT="${CLAUDE_PROJECT_DIR:-${GROK_WORKSPACE_ROOT:-}}"
[[ -n "$ROOT" ]] || ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
RELAY="$ROOT/.director-mode/bin/director-relay"
[[ -x "$RELAY" ]] || RELAY="$HOME/.claude/bin/director-relay"

"$RELAY" create \
  --from <claude|grok> --to codex \
  --goal "..." --summary "..." --next "..."

"$RELAY" continue --to codex

The second command prints the interactive codex invocation. Add --run only when the user wants it launched now. Use --headless when a one-shot codex exec continuation is appropriate.

Codex reads the repository's AGENTS.md, reusable skills from .agents/skills/, and generated agents from .codex/agents/. Confirm those surfaces with the installed CLI when debugging discovery.

Do not add bypass, approval, sandbox, or network flags as part of the handoff. Those controls belong to the Codex session and remain at their current native settings.

Frequently asked questions