handofflisted
Install: claude install-skill izo/Ulk
# Handoff — Session Continuity Snapshot
Generate a concise `docs/_handoff/HANDOFF.md` that lets the next session resume instantly without re-onboarding. Completes 2b3 (commit-level) and lovecraft (long-term memory) on the missing dimension: immediate session-to-session continuity.
---
## Mode Detection
```bash
# Parse args passed to the skill
MODE="default"
for arg in "$@"; do
case "$arg" in
--quick) MODE="quick" ;;
--read) MODE="read" ;;
esac
done
```
---
## Mode: --read (display only)
If `docs/_handoff/HANDOFF.md` exists, display it. Otherwise print "No handoff found — run /ulk:handoff to generate one."
```bash
HANDOFF="docs/_handoff/HANDOFF.md"
if [ -f "$HANDOFF" ]; then
cat "$HANDOFF"
else
echo "No handoff found — run /ulk:handoff to generate one."
fi
```
Stop here. Do not generate anything.
---
## Mode: --quick (5-line snapshot)
Gather minimal git state and print a compact summary. Do NOT write a file.
```bash
BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
LAST=$(git log -1 --format="%h %s" 2>/dev/null || echo "no commits")
STATUS=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
CARD=$(find docs/backlog -name "CARD.md" -exec grep -l "status: in-progress\|status: todo" {} \; 2>/dev/null | head -1)
```
Output format:
```
Handoff (quick) — <date>
Branch : <branch>
Commit : <hash> <subject>
Dirty : <N> files
Card : <path or "none">
Next : <ask user for next step, or "?">
```
Stop here. Do not write a