Skip to main content
ClaudeWave
Skill79 repo starsupdated yesterday

handoff-codex

The handoff-codex skill enables delegation of straightforward code tasks to OpenAI's Codex CLI, preserving Claude's context for complex reasoning. Use it for simple file edits, bulk refactoring, code generation from specifications, and documentation updates. The skill includes preparation templates, command generation patterns, and process guidelines to ensure efficient task handoff while maintaining code quality through post-completion verification steps.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/claude-world/director-mode-lite /tmp/handoff-codex && cp -r /tmp/handoff-codex/skills/handoff-codex ~/.claude/skills/handoff-codex
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Handoff to Codex CLI

Delegate tasks to OpenAI Codex CLI to save Claude context.

---

## When to Use Codex

| Use Codex For | Keep in Claude |
|---------------|----------------|
| Simple file edits | Complex reasoning |
| Bulk refactoring | Architecture decisions |
| Code generation from specs | Problem analysis |
| Documentation updates | Multi-step workflows |

---

## Prerequisites

```bash
npm install -g @openai/codex
```

---

## Handoff Process

### 1. Prepare Context
```markdown
## Task for Codex
**Goal**: [What needs to be done]
**Files**: [Which files to modify]
**Details**: [Specific requirements]
```

### 2. Generate Command
```bash
# Single file
codex "Update login function in src/auth.ts to add rate limiting"

# Multiple files
codex "Refactor console.log to logger in src/**/*.ts"
```

### 3. Provide Instructions
- Why Codex is suitable
- Expected changes
- After completion steps

---

## Example

```markdown
## Task: Update All Import Statements

**Command:**
codex "Update all imports from 'lodash' to 'lodash-es' in src/**/*.ts"

**Expected:**
- ~15 files modified
- Each import updated

**After:**
1. Run `npm test`
2. Return if issues arise
```

---

## Benefits

- **Token Savings**: Simple tasks don't consume Claude context
- **Speed**: Fast for straightforward edits
- **Context Preservation**: Keep Claude fresh for complex reasoning