What problem does it solve? When a working session ends or hits a context limit, decisions, open questions, and unwritten constraints vanish with the conversation. This Skill compacts the current session into a single handoff file so a fresh session can resume the work without re-deriving what was already settled. ## Core Features & Use Cases - Root-level file placement: Writes one file per subject to the root of <workspace>/.claude/handoffs/, matching the SessionEnd hook that deletes subdirectories but preserves root-level files. - Supersede, don't duplicate: Reads any existing handoff for the same subject before overwriting, carrying forward open questions and decisions from prior sessions. - Unrecoverable-first structure: Leads with what a fresh session cannot reconstruct (uploaded files, verbal constraints, rejected approaches) and references rather than duplicates memory, tickets, and commits. - Use Case: You are approaching the context limit mid-ticket. Invoke the handoff skill with the next session's focus, and it writes handoff-<TICKET-ID>.md containing the resume point, decisions with reasoning, and suggested skills for the next session. ## Quick Start Ask the assistant to write a handoff for the current session focused on what the next session should work on.
