mcpField
H
handoff

handoff

github.com/prathamdbyAgent workflows6624 installsUpdated 3d ago
Repository

About handoff

Handoff is a skill for creating or resuming concise work handoffs between agents. It captures actionable context while enforcing redaction, size limits, and checks for stale artifacts.

Key features

  1. 01Create or resume handoff files
  2. 02Redact sensitive values
  3. 03Validate sections and size limits
  4. 04Check referenced artifacts for drift

Use cases

  1. 01Pass current work context to another agent
  2. 02Resume tasks from a saved handoff
  3. 03Share next steps without exposing credentials

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/prathamdby/skills --skill handoff

After installing, type/handoffin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

REFERENCE.md
references/
create.md
resume.md

Details

From the project README

Handoff

Route and privacy

Default create: <anchor>/handoffs/handoff-<YYYY-MM-DD-HHmmss>.md, with anchor this skill's absolute directory. "Save to " selects create there; "resume " selects resume. Both together, missing values, or malformed required Context/Open tasks block. Resolve all paths absolutely. A named live focus overrides the saved one.

Redact tokens/cookies, keys, passwords/connection credentials, private or authenticated URLs, emails/PII, certificates, and environment values. Use [REDACTED: token], [REDACTED: password], [REDACTED: private-key], [REDACTED: pii], or [REDACTED: url] for those values. Environment values become NAME=[REDACTED]. Preserve variable names, command shapes, exit codes, and artifact pointers, not sensitive values. Never weaken redaction to make a command copyable. No full diffs/plans/logs/transcripts. The bound is 12 KB, eight open tasks, twelve artifacts; one to five bullets per section, omitting empty optional sections.

Create

  1. Resolve a writable path/parent. Record create | path | facts | redaction | written | terminal. Done when output can be written.
  2. Select actionable current facts: plan, branch/PR/commits, dirty paths, blockers, durable decisions; mark superseded material. Apply references/create.md to draft required sections and workflow state. Done when each fact helps the next agent act.
  3. Scan draft twice for sensitive values, validate bounds/sections, atomically replace through a sibling temporary file, then scan the final file. Done when structure, bounds, three scans, and existing file pass.
  4. Report path, captured scope, and resume the handoff at <absolute-path>. Done when file and resume instruction exist.

Resume

  1. Resolve/read; absent → BLOCKED with path. Record resume | focus | artifact status | task | terminal. Done when required Context/Open tasks are valid.
  2. Apply references/resume.md to verify paths, branch/dirty state, commits, PRs, and installed skills; classify current/moved/missing/superseded. Redact while reading referenced artifacts. Done when stale facts cannot act.
  3. Choose highest-priority unblocked task under live focus and begin it, recovering only its artifact context. No task → evidenced BLOCKED, not another summary. Done at success, a real blocker, or confirmation gate.
  4. Report drift and work outcome. Create no new handoff unless requested.

Terminals: SUCCESS, BLOCKED, AWAITING_USER, INTERRUPTED, with evidence. On interruption revalidate artifacts touched since the last validation.

Comments

Markdown supported