session-handoff

Installation
Summary

Seamless AI agent session transfers with comprehensive context preservation and validation.

  • Automatically triggers on user requests, context window capacity warnings, task milestones, or work session endings; proactively suggests handoffs after substantial work
  • CREATE workflow generates timestamped handoff documents with pre-filled project metadata, git history, and modified files, then validates for completeness and security
  • RESUME workflow loads handoffs with staleness checking, context verification, and chaining support for multi-session projects
  • Includes validation scripts to detect secrets, check file references, and score handoff quality; staleness checker compares git commits and file changes since creation
SKILL.md

Handoff

Creates comprehensive handoff documents that enable fresh AI agents to seamlessly continue work with zero ambiguity. Solves the long-running agent context exhaustion problem.

Mode Selection

Determine which mode applies:

Creating a handoff? User wants to save current state, pause work, or context is getting full.

  • Follow: CREATE Workflow below

Resuming from a handoff? User wants to continue previous work, load context, or mentions an existing handoff.

  • Follow: RESUME Workflow below

Proactive suggestion? After substantial work (5+ file edits, complex debugging, major decisions), suggest:

"We've made significant progress. Consider creating a handoff document to preserve this context for future sessions. Say 'create handoff' when ready."

CREATE Workflow

Related skills

More from softaworks/agent-toolkit

Installs
3.7K
GitHub Stars
1.8K
First Seen
Jan 20, 2026