CtrlK
BlogDocsLog inGet started
Tessl Logo

ambaba/session-handoff

Save full session context for resumption in a fresh context window.

94

Quality

94%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files
name:
session-handoff
description:
Save or resume a session handoff doc. Triggers on: session handoff, save session, save progress, resume session, handoff, continue later, pick up where I left off, new context window. Captures decisions, actions, pending work, files touched, and skill roster into a structured markdown doc for seamless resumption.

Session Handoff

Two-mode skill: save current session state, or resume a previous session.

Mode Detection

  • No argumentSave mode
  • Argument given (e.g. /session-handoff CXP-32128) → Resume mode for that task
  • If argument given but file doesn't exist → list available handoffs

Save Mode

  1. Determine task slug: derive from JIRA ticket (e.g. CXP-32128) or ask user for a short name
  2. Write to ~/.claude/memory/session-handoff-<task-slug>.md with ALL sections:
    • Synopsis: 2-3 sentence goal + accomplishments
    • Current State: what's done, what's in progress
    • Action Log: numbered significant actions
    • Pending Actions: numbered TODOs in priority order
    • Decisions Made: each decision + rationale
    • Open Questions Resolved: Q&A pairs
    • Key Findings: discoveries, gotchas
    • Files Touched: every path read/created/modified
    • Working Context: repo, branch, env, configs
    • Skill Roster: | Skill | Purpose | When to invoke |
    • Resume Instructions: exact first steps for new session
  3. Validate: confirm file exists and contains all 11 sections
  4. Print: "Saved → /session-handoff <task-slug>" (give user the exact filename to resume)

Resume Mode

  1. Read ~/.claude/memory/session-handoff-<argument>.md
  2. If file missing: ls ~/.claude/memory/session-handoff-*.md and list available tasks
  3. Load skills from Skill Roster — invoke each listed skill to prime context
  4. Print Synopsis + Current State + Pending Actions
  5. Begin first Pending Action automatically
Workspace
ambaba
Visibility
Public
Created
Last updated
Publish Source
CLI
Badge
ambaba/session-handoff badge