resuming-handoff

Resumes work from handoff documents by validating context and planning next actions.

1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/stefanfaur/roach-marketplace --skill resuming-handoff-stefanfaur
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: resuming-handoff
Source: https://github.com/stefanfaur/roach-marketplace/tree/main/roach/skills/resuming-handoff
Command: npx skills add https://github.com/stefanfaur/roach-marketplace --skill resuming-handoff-stefanfaur

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Continuing work from a previous session often means losing context, repeating mistakes, or acting on stale assumptions. This Skill reads handoff documents, verifies that referenced changes and learnings still hold in the current codebase, and turns them into a confirmed action plan before implementation begins. ## Core Features & Use Cases - Handoff Discovery and Reading: Locates handoff documents by direct path or by domain under thoughts/shared/handoffs/<domain>/, selecting the most recent file by timestamp when multiple exist. - Context Validation: Reads linked research and plan documents, verifies that recorded changes and learnings still match the current codebase, and flags divergences or regressions. - Action Planning: Converts handoff action items into a tracked task list and confirms the approach with the user before starting implementation. - Use Case: A developer returns to a feature after a week away. They invoke the skill with the domain name, and it loads the latest handoff, verifies the referenced files still exist, summarizes validated learnings, and proposes the next tasks. ## Quick Start Resume work from the most recent handoff for the payments domain and propose the next steps.

Frequently Asked Questions about resuming-handoff

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

FAQPage Schema
How do I resume work from a handoff document?▼

Invoke the skill with the handoff file path or a domain name. It reads the handoff fully, loads linked research and plan documents, validates the current state, and proposes a course of action for your confirmation.

How does the skill find the latest handoff for a domain?▼

It lists the directory thoughts/shared/handoffs/<domain>/ and selects the most recent file using the YYYY-MM-DD_HH-MM-SS timestamp in the filename. If no files exist, it asks you to provide a path.

What happens if the codebase changed since the handoff was written?▼

The skill verifies every referenced change, file, and learning against the current state before acting. It reports divergences, missing files, or regressions and adapts the proposed plan accordingly.

Can I use this skill without providing a handoff path?▼

Yes. With no parameters, it asks which handoff you want to resume from and explains that you can pass a path directly or a domain name to use the most recent handoff for that domain.

When should I not rely on a handoff document?▼

Avoid relying on stale handoffs after major refactoring or long gaps, since the original approach may no longer apply. The skill flags these cases, but a fresh research pass may be the better starting point.