session-handoff

Capture current session state into a handoff.md file.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/ChenShizhe/research-session --skill session-handoff-chenshizhe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-handoff
Source: https://github.com/ChenShizhe/research-session/tree/main/session-handoff
Command: npx skills add https://github.com/ChenShizhe/research-session --skill session-handoff-chenshizhe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capturing the state of a research session in a single handoff.md enables seamless resumption of work by the next session, preserving what happened, what remains, key decisions, and open questions.

Core Features & Use Cases

  • Generates a complete handoff.md that records session outcomes, pending tasks, decisions, and context.
  • Overwrites the previous handoff for the same project to keep continuity and avoid drift.
  • Reads prior handoffs to preserve task IDs and statuses, preventing loss of critical state.
  • Derives content strictly from the current session context (conversations, working tree, recent commits).

Quick Start

Invoke the session-handoff skill at session end to generate a fresh handoff.md for the current project.

Frequently Asked Questions about session-handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document an AI assistant session state for a seamless handoff?

To document an AI assistant session state for a seamless handoff, invoke the skill at session end to capture project memory, decisions, and open questions into a single handoff.md file, overwriting any prior version to prevent state drift.

What is the best way to capture project context and pending tasks for the next session?

The best way to capture project context and pending tasks is generating a concise handoff document that strictly derives outcomes, recent commits, and open questions from the current session context, ensuring the next session resumes work without losing critical state.

How does memory management preserve task IDs and statuses across multiple sessions?

Memory management preserves task IDs and statuses by reading prior handoff documents before generating a new one. This ensures continuity by carrying over existing identifiers and tracking states into the newly captured session context.

Can I overwrite a previous handoff document without losing critical project decisions?

Yes, you can overwrite a previous handoff document without losing critical project decisions because the skill reads the existing file to preserve task IDs, statuses, and prior context before creating a fresh capture of the current session state.

When do I need to generate a handoff.md file for my research session?

You need to generate a handoff.md file for your research session when you are ready to end the current interaction and want to ensure seamless resumption by recording outcomes, pending tasks, and context for the next session.

Does generating a session handoff require any specific dependencies or external components?

No, generating a session handoff requires no specific dependencies or external components. The skill operates independently to read your session context and output a complete handoff.md file directly into your project root.