handoff

Generate a HANDOFF.md documenting progress, context, commands, and failures.

17|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/ivanrvpereira/.agents --skill handoff-ivanrvpereira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/ivanrvpereira/.agents/tree/main/skills/handoff
Command: npx skills add https://github.com/ivanrvpereira/.agents --skill handoff-ivanrvpereira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents context loss when switching from one AI agent to another by generating a clear HANDOFF.md that captures what’s been done, what’s known, and what to do next.

Core Features & Use Cases

  • Goal/Progress capture: Summarizes the current objective and what has already been accomplished.
  • Key context preservation: Records important decisions, constraints, paths, assumptions, and relevant artifacts.
  • Failure and verification reporting: Logs what didn’t work and what checks/tests were run so the next agent can avoid repeating dead ends.

Quick Start

Tell the agent to run the handoff process so it creates or updates HANDOFF.md at the project root with the current state and next steps.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I transfer project context between AI agents without losing progress?

You can prevent context loss when switching AI agents by generating a HANDOFF.md file that records the current objective, completed work, key decisions, known failures, and next steps for the new session.

What is a project handoff document for multi-agent workflows?

A project handoff document is a structured file that records repository state, diffs, commands, and constraints so a new agent can resume existing work without repeating dead ends or losing prior context.

How do I create an actionable handoff file from the current git status?

To create an actionable handoff file from your current git status, instruct the agent to run a handoff process that reads the repository state and writes a HANDOFF.md with current progress and next steps.

Does the handoff process work with existing HANDOFF.md files?

Yes, the handoff process works with existing HANDOFF.md files by reading the current repository state and incorporating the existing file content to update progress, context, and next steps seamlessly.

Can I include secrets and environment variables in the project handoff document?

No, you cannot include secrets or environment variables in the project handoff document; the generation process explicitly omits secrets to maintain security while transferring progress, context, and commands.