Session Handoff Skill
This skill creates structured handoff documents for session continuity.
Usage
Invoke with /handoff followed by optional arguments:
- •
/handoff- Create handoff for current session - •
/handoff --summary- Brief summary only - •
/handoff --file <path>- Save to specific file - •
/handoff --task "<description>"- Include specific task context
Workflow
1. Gather Session Context
- •Review conversation history
- •Identify files modified
- •Note decisions made
- •Capture current task state
2. Capture State
bash
# Run these commands to gather context git status git diff --stat git log -3 --oneline
3. Generate Handoff Document
Output Format
Save to .handoff/YYYY-MM-DD_HH-MM.md:
markdown
# Session Handoff **Date**: [timestamp] **Duration**: [approximate session length] **Branch**: [current git branch] ## Summary [2-3 sentence overview of what was accomplished] ## Task Context **Original Request**: [what the user asked for] **Current State**: [in-progress / blocked / completed] ## What Was Done - [Completed item 1] - [Completed item 2] - [Completed item 3] ## Files Modified - `path/to/file1.ts` - [brief description of changes] - `path/to/file2.ts` - [brief description of changes] ## Decisions Made - [Decision 1]: [rationale] - [Decision 2]: [rationale] ## Current Blockers - [Blocker if any, or "None"] ## Next Steps 1. [Immediate next action] 2. [Following action] 3. [Future consideration] ## Context for Next Session [Any important context the next session needs to know] ## Commands to Resume ```bash # Suggested commands to get started cd [project-directory] git status [relevant command]
code
## Best Practices ### What to Include - Specific file paths and line numbers - Error messages encountered - URLs or references consulted - Test results and their meaning ### What to Avoid - Excessive detail on completed work - Speculation about future approaches - Personal opinions not relevant to task ## Storage Default location: `.handoff/` directory in project root - Creates directory if it doesn't exist - Uses timestamped filenames - Keeps last 10 handoffs, archives older ones ## Integration Works well with: - `/pickup` - Resume from handoff - `/ship` - Complete and handoff