handoff

Create a handoff.json, thread file, and HQ commit for session continuity.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prepare for a new session by capturing a compact thread state, writing handoff.json, and committing HQ changes so you can resume with minimal foreground work.

Core Features & Use Cases

  • Writes a minimal thread file and handoff.json to lock in context.
  • Triggers HQ commit via handoff-finalize.sh and schedules heavy tasks for a detached post-script.
  • Keeps session continuity across mid-handoff context changes and supports knowledge repos.

Quick Start

Begin a new session and run handoff to snapshot thread state, create handoff.json, and queue the post-handoff tasks.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I maintain session continuity when handing off work across knowledge repos?

Session continuity is maintained by capturing a compact thread state and writing a handoff.json file to lock in context. This allows you to resume ongoing knowledge work with minimal foreground setup.

What is a durable handoff thread and when do I need one?

A durable handoff thread is a minimal snapshot of your current work state stored alongside handoff.json. You need one when preparing for a new session or deferring heavy background tasks across knowledge repos.

How do I defer heavy tasks to a detached post-process script after a commit?

You defer heavy tasks by triggering a controlled HQ commit via handoff-finalize.sh, which schedules the heavy work for a detached post-process script. This minimizes foreground work during the active session transition.

Can I queue background indexing tasks while performing a controlled HQ commit?

Yes, you can queue background indexing and other heavy tasks by running a handoff operation. It performs the controlled HQ commit and schedules the deferred heavy work to a detached post-process script for later execution.

Does session handoff support mid-handoff context changes in knowledge repos?

Yes, the session handoff process keeps continuity across mid-handoff context changes. It applies specifically to ongoing knowledge work sessions requiring quick handoffs across knowledge repos and HQ components.

What are the limitations of using a minimal thread file for session handoff?

The limitation of a minimal thread file is that it only captures compact thread state and handoff.json context. It is designed for quick handoffs and deferring heavy tasks, rather than comprehensive full-state system backups.