handoff

Creates or updates .tmp/progress.md structured Goal-Plan-Done-Next-Open-Resume notes for Claude Code and Codex continuity.

3|Updated Jul 4, 2020
One-click install
npx skills add https://github.com/mei28/dotfiles --skill handoff-mei28
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/mei28/dotfiles/tree/main/.claude/skills/handoff
Command: npx skills add https://github.com/mei28/dotfiles --skill handoff-mei28

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write or update .tmp/progress.md so work can be resumed by the other AI tool (Claude Code <-> Codex), typically before switching tools when one nears its usage limit. Captures Goal/Plan/Done/Next/Open/Resume.

Core Features & Use Cases

  • Enables structured handoff notes to preserve execution state across Claude Code and Codex.
  • Ensures a consistent format with sections Goal, Plan, Done, Next, Open, and Resume for smooth re-engagement.
  • Use during tool-switches or pauses to allow the next tool to immediately resume work with full context.

Quick Start

Create or update the .tmp/progress.md with the current Goal, Plan, Done, Next, Open, and Resume sections to ensure seamless handoffs between Claude Code and Codex.

Frequently Asked Questions about handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I share context between Claude Code and Codex when switching tools?

To share context between Claude Code and Codex, you can create or update a `.tmp/progress.md` file containing structured progress notes. This captures the current execution state, ensuring seamless continuity and immediate resumption by the other AI tool.

What is the best way to resume AI coding work after hitting a usage limit?

The best way to resume AI coding work after a usage limit is to write a structured handoff note capturing the current state. By updating `.tmp/progress.md` before pausing, the next AI tool can immediately re-engage with full context.

How does a structured progress note preserve AI execution state?

A structured progress note preserves AI execution state by enforcing fixed sections like Goal, Plan, Done, Next, Open, and Resume. This consistent format captures exact file paths and commands, enabling the receiving AI to smoothly continue the workflow.

Can I use a progress note to transfer file paths and commands between AI tools?

Yes, you can use a progress note to transfer file paths and commands between AI tools. The handoff mechanism populates the `.tmp/progress.md` file with exact file paths and commands within the Resume section, ensuring accurate context sharing.

Does handoff work without setting up specific dependencies?

Yes, handoff works without setting up specific dependencies. It simply requires creating or updating the `.tmp/progress.md` file with the current Goal, Plan, Done, Next, Open, and Resume sections to ensure seamless context transfer between Claude Code and Codex.