| name | ring:creating-handoffs |
| description | Creating a handoff document that captures session state (completed work, decisions, open items, next steps) and delivering it via Plan Mode so the user gets the native 'clear context and continue implementing' resume option. Use when ending a session, when context grows large, or the user says 'handoff', 'save session', or 'context transfer'. Skip when context is minimal or work is fully complete with no resume planned. |
Session Handoff Skill
When to use
- User is ending a session and wants to preserve context for later
- Context window is getting large and a fresh start would be beneficial
- Handing off work to another person or AI session
- User says "handoff", "save session", "wrap up", or "context transfer"
Skip when
- Session has minimal context that does not warrant a handoff document
- User simply wants to end the conversation without resuming later
- Work is fully complete with nothing pending
Creates a handoff document capturing session context, delivered via Claude Code's Plan Mode so the user gets a native "clear context and continue implementing" option.
Execution Protocol (exact order, no skipping)
Step 1: Gather Context
Before entering plan mode, collect:
- Completed work, decisions, and open items from conversation history
- Use
Glob and Read to verify file states and paths as needed
- Use
Bash with date for timestamps
- Session name (from argument or infer from work done)
Step 2: Enter Plan Mode
Call EnterPlanMode tool.
Step 3: Write Handoff as the Plan
Write the full handoff document (template below) to the plan file path specified in the system message. The handoff IS the plan.
Step 4: Exit Plan Mode
