Handoff

SkillProductivity

Create or resume a verified cross-session task handoff.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Handoff skill

What this skill tells your AI

The instructions your AI receives, as published by hachej/boring-ui in .agents/skills/handoff/SKILL.md and read by ahel’s review.

Transfer one bounded task between sessions without making the handoff a new source of task truth. Read docs/procedures/session-handoff.md (procedure) and .agents/skills/handoff/CONTRACT.md (full contract template and semantics), then take exactly one branch:

  • create <receiver-or-purpose> — probe current authority and execution state, persist the compact contract, then notify the receiver.
  • resume <artifact-reference> — verify authority, drift, and atomic admission; record consumption, then take the exact next action.

An empty, incomplete, or unknown branch returns this usage and stops:

/skill:handoff create reviewer-for-bead-123
/skill:handoff resume <artifact-reference>

If a human owes the next decision, use docs/procedures/owner-review-card.md instead. When that handoff or decision is hard to understand in prose, read ../show-me/SKILL.md and follow its visual composition guidance. Every Worker handoff comment for a Bead touching more than one file includes one diff-shaped show-me view (a fenced text/diff block) of what changed; a single-file Bead may skip it and say so in the handoff. For bead work, put the handoff artifact pointer and a one-line friction note on the bead.

In the Factory, a Bead you were dispatched to must carry its handoff comment before your turn ends, even when the work is incomplete or blocked (say what is done, what is not, and why); the host treats a claim whose Worker went idle without a handoff as stale and releases it. The "receiver" is never a person waiting in chat: the durable handoff IS the Bead comment ([Feature Name] handoff · <bead id> · <short sha> per docs/procedures/naming-conventions.md), and the next Worker or Orchestrator that claims the bead reads it to re-prime — there is no other delivery step. Follow the naming convention for every title this skill produces (session titles, comments, artifacts).

Return branch-specific evidence:

  • create: artifact reference/revision/digest, sender/intended receiver, authority probes, task-link and notification receipts, and resume command;
  • resume: receiving session, authority/admission probes, consumption receipt and started action, or a durable stopped/conflict receipt.

Use none: not applicable to <branch> for any shared output field that does not apply.

Signals

GitHub stars
46
Forks
2
Last commit
Sep 2026
Hacker News mentions
20
Advanced
Catalog kind
skill
Gateway key
handoff-hachej
Source
github.com/hachej/boring-ui