Handoff

Pause-and-resume system for cross-conversation continuity. Use when your AI needs the user's input to continue a task but the current conversation must end. Checked on every boot to detect pending handoffs. Triggers on conversation start (boot check) and when the AI explicitly needs to pause for input.

46 stars 56 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add zocomputer/skills --skill handoff
Manual install
git clone --depth 1 https://github.com/zocomputer/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/Community/handoff ~/.claude/skills/handoff

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Handoff

Enables your AI to pause work, ask you a question, and resume in a future conversation with your answer, regardless of which channel you respond through (SMS, email, new chat thread).

## Setup

1. Install this skill to `Skills/handoff/`
2. Add to your boot sequence (in rules or AGENTS.md): run `python3 Skills/handoff/scripts/handoff.py check` at the start of every conversation
3. Ensure `Data/` directory exists in your workspace

## State File

Single file: `/home/workspace/Data/handoff.json`

Only one handoff exists at a time. If a handoff file exists, there is unfinished business.

## Boot Check (Every Conversation)

At the start of every conversation, after loading your persona/profile context:

```bash
python3 /home/workspace/Skills/handoff/scripts/handoff.py check
```

**If no handoff exists**: Output says "No pending handoff." Continue normally.

**If a handoff exists**: Output includes the full handoff context. Do the following:

1. Read the handoff context carefully
2. Tell the user: "I have a pending handoff from a previous session" and summarize what was in progress and what was asked
3. If the current message appears to be a response to the handoff question, resume the work using their input, then clear the handoff
4. If the current message is about something else entirely, mention the pending handoff briefly and ask if they want to address it or shelve it
5. After the handoff is resolved, clear it:
Read the full skill on GitHub

Details

Skill name
handoff
Path
Community/handoff/SKILL.md
License
MIT
Repo updated
29 July 2026

FAQ

What does the Handoff skill do?

Pause-and-resume system for cross-conversation continuity. Use when your AI needs the user's input to continue a task but the current conversation must end. Checked on every boot to detect pending handoffs. Triggers on conversation start (boot check) and when the AI explicitly needs to pause for input.

How do I install the Handoff skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add zocomputer/skills --skill handoff. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Handoff popular?

It lives in zocomputer/skills, which has 46 GitHub stars and 56 forks.

Related skills

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.