handoff

Generate a redacted Markdown handoff document summarizing a session for the next agent.

Updated May 10, 2026
One-click install
npx skills add https://github.com/cookkie03/skills --skill handoff-cookkie03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/cookkie03/skills/tree/main/handoff
Command: npx skills add https://github.com/cookkie03/skills --skill handoff-cookkie03

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When an AI agent session ends or hits context limits, all accumulated context is lost and the next agent starts from zero. This Skill compacts the current conversation into a structured handoff document so a fresh agent can resume work without re-discovering decisions, file paths, or blockers. ## Core Features & Use Cases - Structured Handoff Generation: Produces a Markdown document with YAML frontmatter and seven standard sections covering summary, completed work, decisions, files, blockers, next steps, and suggested skills. - Automatic Secret Redaction: Strips API keys, tokens, JWTs, and passwords using regex patterns before writing the document. - Git Context Capture: Records the current branch, commit hash, and working directory so the next agent knows the exact repository state. - Use Case: Before ending a long debugging session, run the handoff skill with a note like "continue fixing the auth timeout bug" to produce a document the next agent can read to resume immediately. ## Quick Start Ask the agent to create a handoff document for the next session focused on your upcoming task, and it will save a redacted summary to your OS temp directory.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I hand off an AI agent session to another agent?

Invoke the handoff skill with a short description of the next session's focus. It writes a structured Markdown document with summary, decisions, files, blockers, and next steps to your OS temp directory for the incoming agent to read.

How to compact a long AI conversation into a summary document?

Use the handoff skill to distill the conversation into a seven-section Markdown document with YAML frontmatter. It references existing artifacts like specs and commits by path instead of duplicating their content.

Does the handoff document redact API keys and secrets?

Yes, the generator script applies regex patterns to redact OpenAI, GitHub, GitLab, AWS, Google, Slack, and HuggingFace tokens, plus JWTs and password assignments, before writing the file. The output file is also saved with owner-only permissions.

Where is the handoff document saved?

By default it is saved to the operating system's temporary directory with a timestamped filename like handoff_20240101_120000.md. You can override the location with the script's --output argument.

What information does the handoff document include?

It includes an executive summary, completed work, key decisions, critical file paths, current blockers, actionable next steps, and suggested skills for the incoming agent. It also captures the working directory, git branch, and commit hash when available.