handoff

Prepend a timestamped Recap and Next Actions to .claude/journal.md.

6|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/kok1eee/o-m-cc --skill handoff-kok1eee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/kok1eee/o-m-cc/tree/main/skills/handoff
Command: npx skills add https://github.com/kok1eee/o-m-cc --skill handoff-kok1eee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long interactive LLM sessions can exhaust context windows and are difficult to continue across machines; this Skill captures a concise Recap and concrete Next Actions so work can resume immediately on the same or a different host. It removes ambiguity about what was discovered and what to do next by recording a timestamped, versionable journal entry that can be shared via VCS.

Core Features & Use Cases

  • Prepend Recap + Next Actions: Generates a 2–4 sentence Recap and a 1–5 item Next list and inserts them at the top of .claude/journal.md.
  • Host & Timestamping: Records the current timestamp and optional short hostname for cross-machine identification, and tolerates hostname failures by omitting host info.
  • Safe file handling and recovery: Creates the journal with a standard header if missing, preserves existing entries by prepending without editing, and prompts the user when no Next Actions are specified (headless mode records a placeholder).
  • Use Cases: break long sessions to reduce context pressure, hand off work from one EC2 instance to another via VCS, and produce archiveable session checkpoints for later review.

Quick Start

Run the handoff skill to append a concise Recap and concrete Next Actions to .claude/journal.md so another session or machine can resume work.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I resume a long Claude session on a different machine when context is full?

To resume a long Claude session across machines, you need a session handoff mechanism that writes a concise Recap and Next Actions to a journal file. This allows a new session to read the journal and immediately continue the work with full context.

How does writing a session journal to a markdown file help with cross-EC2 continuation?

Writing a session journal to a markdown file helps cross-EC2 continuation by creating a versionable checkpoint. The journal records discoveries and next steps, which you can share via VCS to let another EC2 instance pull the history and resume work immediately.

What is the best way to create a session checkpoint for an interactive LLM workflow?

The best way to create a session checkpoint for an interactive LLM workflow is to generate a timestamped journal entry containing a session recap and a concrete list of next actions. Prepending this entry to a markdown file preserves existing history for later review.

Can I use a markdown journal file for cross-machine session handoff without losing existing history?

Yes, you can use a markdown journal file for cross-machine session handoff without losing existing history. The handoff process prepends new Recap and Next Actions entries to the top of the file, preserving all previous journal records without editing them.

What happens if no next actions are specified when creating a session recap?

If no next actions are specified when creating a session recap, the process prompts the user to provide them. In headless mode where prompting is not possible, a placeholder is recorded to ensure the journal entry structure remains complete.

Does the session handoff journal record hostname for cross-machine identification?

Yes, the session handoff journal records an optional short hostname alongside the timestamp for cross-machine identification. If hostname retrieval fails, the process tolerates the error by omitting host info and still writing the recap.