skills.rest
ankitjh4
ankitjh4COMMUNITY
Explore all skills by this author →
WebsiteGitHub

handoff

Persist and restore AI task state across conversations via a JSON handoff file.

Updated Mar 8, 2026
Search Tags:#CLI#handoff#workflow state#conversation continuity#pause resume#workspace data#context handover
One-click install
npx skills add https://github.com/ankitjh4/skill-builder --skill handoff-ankitjh4
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/ankitjh4/skill-builder/tree/main/handoff
Command: npx skills add https://github.com/ankitjh4/skill-builder --skill handoff-ankitjh4

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of losing progress when an AI needs the user’s input to continue, by persisting a clear task state for the next conversation.

Core Features & Use Cases

  • Cross-conversation pause/resume: Saves the current task, context, and the exact question, then restores it at the start of a new conversation.
  • Boot-time handoff detection: Runs a required check each conversation to detect pending handoffs automatically.
  • Safe single-handoff workflow: Enforces one pending handoff at a time and requires clearing after resolution.
  • Use Case: You start investigating a bug, need a specific log line from the user to proceed, and then the session ends; the next conversation resumes directly from the saved question and context.

Quick Start

Ask the AI to save a handoff with the current task, include the context and the specific question you need answered, and tell the user to reply anywhere to continue next conversation.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I resume an AI task across separate conversations after a session ends?▼

A structured handoff file persists the current task state, context, and exact question. This file is automatically detected and reloaded at the start of the next conversation to resume work.

How does cross-conversation context handover maintain workflow state?▼

Context handover maintains workflow state by saving a single JSON state file in the workspace Data directory. This file captures the paused task and restores it reliably regardless of the reply channel used.

Can I save multiple pending handoffs at the same time?▼

No, you cannot save multiple pending handoffs. The system enforces a safe single-handoff workflow, allowing only one pending handoff at a time and requiring it to be cleared after resolution.

What CLI commands are needed to manage workspace data for a paused task?▼

The CLI supports four commands to manage workspace data for a paused task: check, save, clear, and show. These operate on the single JSON state file to control the handoff lifecycle.

When do I need to pause work and save a handoff file?▼

You need to pause work and save a handoff file when an AI investigation requires a specific user answer to proceed, such as needing a specific log line to continue debugging a bug.

Related Skills

Explore More Software Engineering Skills→
EmrebenerEmrebener

ss-workflow-generating-handoff

Generate a single markdown handoff file with YAML frontmatter and redacted secrets.

Community
Intermediate
Khamel83Khamel83

resume-handoff

Resume work from a handoff document and continue the next pending task.

Community
Advanced
UniquecreteUniquecrete

handoff

Save pending task context and user questions for cross-channel resume.

Community
Intermediate
DektoraDektora

rotation-handoff

Generate and read structured DekSpec session handoff records in dekspec/.scratch/rotation-handoff/.

Official
Advanced