handoff-v2

What This Skill Does

The handoff-v2 skill is an advanced state-persistence protocol designed for OpenClaw AI agents to manage cross-session workflows seamlessly. Unlike standard summarization tools, this skill creates a "frozen state" captured within a strictly formatted handoff.md file. It allows users to pause long-term projects, switch between sessions, or migrate contexts without ever having to re-explain their background or project history to the agent. By using a structured 8-slot template (Task, Status, Completed, Decisions, Constraints, Files, Next Steps, and Pending Items), the agent ensures that the next session can resume execution immediately upon recovery.

Installation

To install this skill, run the following command in your OpenClaw terminal: clawhub install openclaw/skills/skills/allen-cao/handoff-session

Use Cases

• Long-term Project Management: When a task spans multiple days and you need to clear your active session context.
• Context Migration: Moving a complex coding or research project from a chat session that has become too long to a fresh, optimized session.
• Deferred Work: Pausing a multi-step execution to resume later without losing track of current dependencies or blocking items.
• Session Cleanup: Reducing token usage in LLM-based agents by effectively "checkpointing" work and starting with a fresh context window.

Example Prompts

1. "I'm wrapping up for now, please perform a handoff out so I can continue this task tomorrow."
2. "handoff in latest - I'm ready to pick up where we left off yesterday."
3. "Let's see what we were working on; list my recent handoff sessions."

Tips & Limitations

• Strict Compliance: The protocol relies on the 8-slot structure. Ensure no slots are left blank; use "None" or "Not Recorded" if necessary.
• Compression is Key: This is not a conversation logger. Always delete fluff, emotional content, or historical discussions before executing handoff out. Keep the document under 120 lines to ensure the agent maintains focus.
• Approval Loop: For safety, handoff in will never execute a task until you explicitly confirm the recovery preview. Always check the proposed 'Next Step' before approving.
• Atomicity: The skill treats handoff.md as the unique source of truth. Do not manually edit the file if you are not prepared for a potential break in the state logic.