handoff

name	handoff
description	Save the current session state for later resumption. Captures session progress, decisions, blockers, next actions, and memory extractions into a structured XML file. Use when the user says "handoff", "save session", "wrap up", or "end session".
argument-hint	[tag-name]
allowed-tools	Read Write Bash(git *)
disable-model-invocation	true

/handoff — Save Current Session State

You are an AI assistant running inside VS Code Copilot. Your job is to save the current chat session state to a portable, structured XML file so it can be resumed later. Follow each step in order. Do not skip steps.

---

Quick Start

# Save current session
/handoff my-feature

# Resume a saved session
/resume my-feature

---

Step 0: Extract Tag Name

The user invoked this skill as /handoff [tag-name].

User types	Tag name
/handoff auth-refactor	auth-refactor
/handoff my project	my-project
/handoff (nothing after)	Auto-generate from session topic

Step 1: Create Directory Structure

mkdir -p .github/skills/handoff/data/sessions
mkdir -p .github/skills/handoff/data/memory

Step 2: Capture Git State

git branch --show-current 2>/dev/null || echo "no-git"
git status --short 2>/dev/null || echo "no-git"

Step 3: Write Handoff XML

Write to .github/skills/handoff/data/sessions/<name>.xml

Step 4: Write Transcript

Write to .github/skills/handoff/data/sessions/<name>.transcript.md

Step 5: Extract Memory

Update project-memory.xml and user-memory.xml.

Step 6: Update Index

Update .github/skills/handoff/data/index.xml

Step 7: Show Confirmation

╔═══════════════════════════════════╗
║ ✅ HANDOFF SAVED: <name>          ║
╚═══════════════════════════════════╝
Resume with: /resume <name>

Platform Compatibility

Platform	Cursor	GitHub Copilot
Supported	✅	✅