One-click install
npx skills add https://github.com/marchatton/agent-skills --skill handoff-marchatton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/marchatton/agent-skills/tree/main/.agents/skills/00-utilities/handoff
Command: npx skills add https://github.com/marchatton/agent-skills --skill handoff-marchatton

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of saving your current work state, ensuring that another agent (or your future self) can quickly understand and resume your tasks without losing context.

Core Features & Use Cases

  • State Persistence: Captures the current working environment, including code status, running processes, and next steps.
  • Contextual Handoff Notes: Generates a structured Markdown file detailing the work in progress, blockers, and required actions.
  • Use Case: Before stepping away from a complex coding task, use this Skill to create a detailed handoff note that includes your current branch, active tmux sessions, and a list of pending items, allowing a teammate to pick up exactly where you left off.

Quick Start

Prepare a handoff note for the current work session.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I save my current git working state for another agent to resume?

To save your current git working state for agent handoff, this Skill packages your scope, working tree status, branch details, running processes, and next steps into a persistent Markdown note. The note is saved to a git-tracked handoff area within your repository for easy pickup in a fresh thread.

What is the best way to persist agent context before starting a fresh thread?

The best way to persist agent context is generating a structured handoff checklist that captures work in progress, blockers, and required actions. This ensures another agent or your future self can quickly understand and resume tasks without losing context.

Can I track running processes and active tmux sessions in a workflow persistence note?

Yes, you can track running processes and active tmux sessions in a workflow persistence note. The Skill captures your current working environment, including code status and active sessions, alongside pending items to allow a teammate to pick up exactly where you left off.

Does this handoff checklist capture branch and PR details automatically?

Yes, the handoff checklist captures branch and PR details automatically. It persistently records your working tree status, branch/PR information, running tests, next steps, and risks to provide a comprehensive state snapshot for agent collaboration.

How do I document project risks and next steps for agent collaboration?

To document project risks and next steps for agent collaboration, this Skill generates a contextual handoff note detailing pending items and blockers. It saves this structured Markdown file to your repository, ensuring another agent can quickly resume your tasks.

Are there limitations to what state management details I should include in handoff notes?

The Skill captures scope, working tree status, running processes, tests, next steps, and risks, but relies on saving these to a git-tracked handoff area. You should ensure your repository supports this workflow and that sensitive runtime data is safe to persist in version control.