create-handoff

Generate structured handoff documents with YAML frontmatter and Markdown.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/swtch1/dotfiles --skill create-handoff-swtch1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-handoff
Source: https://github.com/swtch1/dotfiles/tree/main/.claude/skills/create-handoff
Command: npx skills add https://github.com/swtch1/dotfiles --skill create-handoff-swtch1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you create comprehensive handoff documents that capture the current state of your work, learnings, and next steps, enabling seamless transitions to new sessions or team members.

Core Features & Use Cases

  • State Capture: Documents current progress, key learnings, and working files.
  • Contextual Handoff: Provides essential context for the next agent to pick up efficiently.
  • Use Case: Before ending a complex debugging session, use this Skill to document the root cause, failed attempts, and the specific next step needed to resolve the issue, ensuring the next person doesn't waste time re-diagnosing.

Quick Start

Run the init script to create a handoff file for the current state of your work.

Frequently Asked Questions about create-handoff

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

FAQPage Schema
How do I capture context and document work state for a session handoff?

To capture context for a session handoff, generate a structured document detailing your current progress, discovered knowledge, and actionable next steps. This facilitates seamless context transfer to a new agent or team member.

What is the best way to write a handoff document for an ongoing debugging task?

The best way to write a handoff document for a debugging task is to record the root cause, failed attempts, and specific next steps. This prevents the next agent from wasting time re-diagnosing the issue.

How does state capture work when transferring context to a new agent?

State capture works by detailing working files, key learnings, and current progress into a structured format. This provides essential context for the next agent to pick up the task efficiently.

Can I use YAML frontmatter and Markdown to structure handoff documents?

Yes, you can use YAML frontmatter for metadata and Markdown for content to structure handoff documents. This format organizes state capture details, making context transfer and human review straightforward.

Do I need to run an init script to create a handoff file for my current state?

Yes, you need to run the init script to scaffold and create a handoff file for your current state. This script execution automates the generation of the structured document for your ongoing task.