session-handoff

Overview

Session Handoff is a skill from softaworks/agent-toolkit that creates comprehensive handoff documents for seamless AI agent session transfers. It solves the long-running agent context exhaustion problem by enabling fresh agents to continue work with zero ambiguity, using a scaffold-and-validate approach with automated pre-filling of git state, modified files, and recent commits.

Key Features

• Automated Scaffold Generation - Python script creates timestamped handoff documents pre-filled with project path, git branch, recent commits, and modified files for quick setup
• CREATE and RESUME Workflows - Separate workflows for creating handoff documents (saving state) and resuming from them (loading state), with proactive suggestions after substantial work
• Handoff Chain Support - Links continuation handoffs to previous work sessions using --continues-from for maintaining project history across multiple agent sessions
• Validation Script - Automated validation checks for remaining TODO placeholders, required sections, potential secrets (API keys, passwords), and referenced file existence
• Proactive Handoff Suggestions - Automatically suggests creating a handoff after substantial work (5+ file edits, complex debugging, major decisions) to prevent context loss

Who is this for?

This skill is designed for developers who use AI coding agents for extended work sessions and need a reliable way to transfer context between sessions when context windows fill up. It is especially valuable for teams working on complex, multi-session projects where preserving architectural decisions, debugging context, and work-in-progress state is critical for productivity.