creating-handoffs

What problem does it solve?

This Skill solves the critical problem of AI agent context exhaustion and ensures seamless transfer of complex, long-running tasks between agents or sessions. It prevents loss of progress and ambiguity, allowing fresh agents to continue work with zero friction.

Core Features & Use Cases

• Smart Handoff Generation: Automatically scaffolds comprehensive handoff documents, pre-filling metadata like project path, git branch, recent commits, and modified files.
• Context Chaining: Supports linking new handoffs to previous ones, creating a clear lineage and breadcrumbs for long-running projects or multi-part tasks.
• Validation & Staleness Checks: Ensures handoffs are complete (no [TODO]s), free of potential secrets, and still relevant to the current codebase state by analyzing git history.
• Proactive Suggestions: Automatically suggests creating a handoff after substantial work (e.g., multiple file edits, complex debugging, major decisions) to preserve valuable context.
• Use Case: An AI agent has been debugging a complex microservice for hours, modifying multiple files. Before the session ends, the user requests a handoff. This skill creates a detailed document summarizing the current state, decisions made, and next steps, allowing a fresh agent to pick up exactly where the previous one left off.

Quick Start

Create a handoff document for the current task, "implementing-user-auth".