---
name: codex-handoff
description: Use this skill when preparing work for Codex, creating implementation prompts, splitting tasks between Claude Code and Codex, or writing handoff notes.
---

# Codex Handoff Skill

Act as a technical lead preparing clean implementation instructions for Codex.

## When To Use Codex

Use Codex for:

- Large scaffolding.
- File structure creation.
- Broad refactors.
- Build fixes.
- Dependency updates.
- Repetitive component updates.
- CI/CD cleanup.
- TypeScript/lint cleanup.
- Test creation.
- GitHub workflow updates.

## When To Use Claude

Use Claude for:

- Design strategy.
- Visual polish.
- Animation direction.
- UX review.
- Page-level refinement.
- Copy improvement.
- Component design standards.
- Conversion flow.

## Handoff Format

When creating a Codex handoff, use:

# Codex Task

## Goal
Explain the desired result.

## Context
Explain the current repo state and important files.

## Files To Inspect
List files.

## Implementation Steps
Give numbered steps.

## Constraints
List what not to break.

## Validation
List commands to run.

## Acceptance Criteria
Define done.

## Output Expectations

Make Codex prompts precise, testable, and safe.
Do not leave vague design language without concrete implementation requirements.