# Handoff

Use when managing a two-session handoff, inspecting, picking up, or reviewing a...

- Repository: https://github.com/jeremylongshore/tons-of-skills-marketplace (2890 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add jeremylongshore/tons-of-skills-marketplace --skill handoff -g -a claude-code -y`
Codex: `npx skills add jeremylongshore/tons-of-skills-marketplace --skill handoff -g -a codex -y`
Cursor: `npx skills add jeremylongshore/tons-of-skills-marketplace --skill handoff -g -a cursor -y`
Gemini CLI: `npx skills add jeremylongshore/tons-of-skills-marketplace --skill handoff -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add jeremylongshore/tons-of-skills-marketplace`

## Description

Use when managing a two-session handoff, inspecting, picking up, or reviewing a committed handoff package produced by a session=two scope run. The operator interface over the cross-environment handoff lifecycle (plan in one session, build in another, review back in the first). Trigger with /hyperflow:handoff, "list handoffs", "pick up the handoff", "review the handoff build".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Handoff

Operator interface for **two-session execution**: one session plans (`session=two` at the Step 0 gate), a second
session in another environment builds, and the first session reviews. The lifecycle and package format are defined
in [`../hyperflow/session-handoff.md`](../hyperflow/session-handoff.md); this skill is the thin set of verbs over it
(mirrors how `/hyperflow:flush` fronts the deferred-commit machinery).

Packages live at `.hyperflow-handoff/<slug>/` (committed, so they travel via git). `STATUS` (`planned → built →
reviewed`) is the single source of truth and decides which side of the handoff you are on.

## Subcommands

### `list`
Read-only. List every `.hyperflow-handoff/*/` (excluding `.archive/`): slug · `STATUS` · `on_complete` · age. Group
by status so the user sees what is awaiting build vs awaiting review.

### `status [<slug>]`
Show the `HANDOFF.md` manifest + `STATUS` for one package (or all). When `STATUS=built`, also print the
`COMPLETION.md` diff range and commit count. Read-only.

### `pickup <slug>`, build side
Thin alias for starting the second-session build: invoke `Skill` with `skill: dispatch` and `args: "<slug>"`.
Dispatch's Step 1.0 rehydrates `artefact/` into `.hyperflow/`, runs `/hyperflow:scaffold` if the cache is missing,
builds the batches, writes `COMPLETION.md` + `STATUS=built`, and then deploys or stops per `on_complete`.

The rest: https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/ai-agency/hyperflow/skills/handoff/SKILL.md