Skip to content

v1.1 — session-handoff skill

Choose a tag to compare

@andreab67 andreab67 released this 23 May 02:43
· 51 commits to main since this release

Adds

session-handoff

Manually-invoked skill that rescues critical session context to persistent auto-memory before /clear, /compact, or any conversation wipe.

The whole skill rides on one heuristic: would re-reading the repo recover this? If yes, drop. If no, it's a rescue candidate. That single test eliminates ~80% of false saves.

Highlights:

  • Six rescue categories mapped to the user / feedback / project / reference auto-memory schema
  • Hard exclusions for secrets, code-derivable facts, git history, fixed-bug recipes, and CLAUDE.md duplicates — refused even when explicitly asked
  • Pre-flight read of MEMORY.md to reuse slug prefixes, detect duplicates, and surface contradictions with stale entries
  • Review-before-write via AskUserQuestion: multi-select for ≤ 4 candidates, table format for > 4, with explicit drop reasons shown
  • Conflict resolution that updates existing entries in place rather than writing duplicates
  • Anti-patterns gallery (7 examples a senior engineer would refuse)
  • Worked end-to-end example: 90-minute design session → 11 candidates → 6 keep, 5 drop, with the exact triage table
  • Optional UserPromptSubmit hook (hooks/session-handoff-gate.js) that intercepts the first /clear and routes to the skill — second /clear passes through

Install

npx skills add andreab67/agent-skills@session-handoff -g -y

Full changelog

  • 0ceff0a feat: add session-handoff skill — rescue critical context before /clear