Skip to main content
skill Claude Code

handoff · mattpocock — Claude Code skill: what it does, how to install

Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent.

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock
Open on GitHub

What handoff does

This skill turns the current conversation into a handoff document for a fresh agent. It saves the file in the OS temporary directory: $TMPDIR, /tmp, or %TEMP% on Windows, and redacts sensitive material such as API keys, passwords, and personal data.

The document includes a suggested skills section for skills the next agent should call through the Skill tool. It references existing specs, plans, ADRs, issues, commits, and diffs rather than copying their contents. An argument sets the focus for the next session. Install it when unfinished work regularly moves between agents; it adds an unnecessary step for a short one-off chat.

What it helps with

  • pass conversation context to a new agent
  • write a handoff file to the OS temporary directory
  • redact API keys and passwords from a handoff
  • list skills for the next agent to call
  • avoid duplicating existing plans and diffs

Example prompts for the agent

  • Create a handoff for the next session focused on fixing the current issue.
  • Write a handoff document for a new agent and include suggested skills.
  • Prepare a handoff before another agent takes over without copying the existing plan.

How to install handoff

1Plugin marketplace

/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock

This installs the whole mattpocock-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add mattpocock/skills --skill handoff -a claude-code

3Manually: put the files in place

~/.claude/skills/handoff/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/handoff/

From the same set32

The whole set →
grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. Claude Code 1,219,756installs improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. Claude Code 1,163,035installs tdd Matt Pocock Guides the red-green TDD loop: ensures tests are written first, keep them at public interfaces, and avoid coupling to implementation details. Claude Code 1,141,062installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. Claude Code 990,453installs prototype Matt Pocock Creates throwaway prototypes for checking state logic or exploring UI before committing the decision to the main codebase. Claude Code 986,201installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. Claude Code 979,543installs

Other versions of handoff

Similar

Questions about handoff

How do I install handoff in Claude Code?

Run npx skills add mattpocock/skills --skill handoff -a claude-code. It can also be installed through the Claude Code marketplace.

What does handoff do?

It condenses the current conversation into a handoff document for a fresh agent. The document includes context and a suggested skills section.

Where does handoff save its document?

It writes to the OS temporary directory: $TMPDIR or /tmp, and %TEMP% on Windows. It does not save the document in the current workspace.

Source text

SKILL.md · MIT
---
name: handoff
description: Compact the current conversation into a handoff document for another agent to pick up.
argument-hint: "What will the next session be used for?"
disable-model-invocation: true
---

Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS (`$TMPDIR`, else `/tmp`; `%TEMP%` on Windows) - not the current workspace.

Include a "suggested skills" section in the document, naming which skills the next agent should call the Skill tool for.

Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.

Redact any sensitive information, such as API keys, passwords, or personally identifiable information.

If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.

© Matt Pocock · MIT · mattpocock/skills

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor