Skip to main content
affpapa.org
RU EN
skill Claude Code

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

Turns the current conversation into a handoff document for another agent. Use it when work moves to a fresh session and existing artifacts should stay referenced.

Install into Claude Code · Plugin marketplace All methods and platforms ↓ 
/plugin marketplace add alirezarezvani/claude-skills
/plugin install handoff-engineering@claude-code-skills
Open on GitHub

What handoff does

The skill creates a handoff document from the current conversation so another agent can continue the work. It records the next session’s goal, the current state, blockers, open decisions, suggested skills, and related artifacts.

The document is saved to a path produced by mktemp -t handoff-XXXXXX.md. PRDs, plans, ADRs, issues, commits, and diffs are referenced by path or URL instead of being copied into the handoff. A user argument sets the focus for the next session. Claude Code and the installed handoff skill are required.

Install it when a task needs to move to a fresh agent or a new session. For a short task with little accumulated context, it adds extra structure you may not need.

What it helps with

  • hand off ongoing work to another agent
  • carry project state into a new session
  • record blockers and open decisions
  • reference PRDs, ADRs, issues, and diffs
  • suggest skills for the next session

Example prompts for the agent

  • Create a handoff for the next session from the current work.
  • Hand off this task to a fresh agent and focus the document on fixing the tests.
  • Write a handoff with the blockers and references to the existing plan and diff.

How to install handoff

1Plugin marketplace

/plugin marketplace add alirezarezvani/claude-skills
/plugin install handoff-engineering@claude-code-skills

This installs the whole handoff-engineering plugin with all its skills

2Skills CLI (Vercel)

npx skills add alirezarezvani/claude-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 set349

The whole set →
engineering-skills Alireza Rezvani An engineering skill index for Claude Code that helps you select one specialist SKILL.md for the task at hand. It covers architecture, testing, DevOps, and data work. Claude Code 2,387installs finance-skills Alireza Rezvani Routes ambiguous finance prompts to the right bundled skill: financial-analyst, saas-metrics-coach, or month-end-close. Claude Code 2,312installs marketing-skills Alireza Rezvani A directory and router for marketing skills in Claude Code. It picks the right specialist skill for SEO, content, CRO, channels, and related tasks. Claude Code 2,264installs business-growth-skills Alireza Rezvani Routes growth and revenue prompts to the right specialized skill across customer success, sales engineering, RevOps, and proposals in Claude Code. Claude Code 2,189installs engineering-advanced-skills Alireza Rezvani An index of 37 engineering skills for architecture, automation, reliability, and platform work. Use it when a project needs task-specific engineering workflows. Claude Code 2,019installs product-skills Alireza Rezvani Product work orchestrator for Claude Code. Routes queries across 16 domain lanes and validates discovery trees with deterministic scripts. Claude Code 1,994installs pm-skills Alireza Rezvani Routes project-delivery requests across 8 PM sub-skills for Jira, Confluence, sprints, reporting, and team communication. Useful for controlled delivery work. Claude Code 1,975installs senior-backend Alireza Rezvani Scaffolds backend APIs, detects database bottlenecks, and runs load tests. Useful when designing Express routes, optimizing PostgreSQL, or preparing for production. Claude Code 1,674installs

Other versions of handoff

handoff Matt Pocock 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. Claude Code 1,038,491installs handoff rohitg00 Resumes the latest agent session for the current directory and surfaces any unanswered questions first. Claude Code CX Codex Cursor +1 13,400installs

Similar

agent-skill-stack official github Finds a small compatible set of AI Agent Skills for a multi-step goal. Use it to audit installed Skills or work out what a project still needs. GitHub Copilot 128installs performance-review-writer official github Drafts self-assessments, peer reviews, and manager feedback using the STAR framework. Pulls work history via WorkIQ or manual notes. GitHub Copilot 121installs find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. Claude Code CX Codex Cursor +1 4,000,000installs 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 handoff Matt Pocock 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. Claude Code 1,038,491installs 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 teach Matt Pocock Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project. Claude Code 862,247installs

Questions about handoff

How do I install handoff in Claude Code?

Run npx skills add alirezarezvani/claude-skills --skill handoff -a claude-code, or add the marketplace with /plugin marketplace add alirezarezvani/claude-skills and install it with /plugin install handoff-engineering@claude-code-skills.

What does the handoff skill do?

It turns the current conversation into a document for the next agent. The document covers the goal, work state, decisions, suggested skills, and references to existing artifacts without repeating their contents.

Where does the handoff document go?

The skill saves it to a path created by mktemp -t handoff-XXXXXX.md. It reads the file before writing to it.

Source text

SKILL.md · MIT 
---
name: handoff
description: Compact the current conversation into a handoff document for another agent to pick up. References existing artifacts (PRDs, plans, ADRs, issues, commits, diffs) by path or URL instead of duplicating them. Use when user wants to hand off the conversation to a fresh agent or starts a new session that picks up prior work.
argument-hint: "What will the next session be used for?"
license: MIT
metadata:
  derived_from: "https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff"
  original_author: "Matt Pocock (@mattpocock)"
  original_license: MIT
  voice: "Matt Pocock — no-duplication, reference-existing-artifacts, tailored to next-session focus"
  version: 1.0.0
---

# Handoff

> Derived from [Matt Pocock's handoff](https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff) (MIT). Matt's no-duplication discipline preserved verbatim. Additions: tools + references + cs-* wrapper (see [references/companion_tooling.md](references/companion_tooling.md)).

Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by `mktemp -t handoff-XXXXXX.md` (read the file before you write to it).

Suggest the skills to be used, if any, by the next session.

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

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

## Sections

- **Goal of next session** (from user argument or inferred)
- **State of play** (what's done, what's blocking)
- **Open decisions** (what the next agent must decide)
- **Skills to use** (concrete list)
- **Artifacts** (paths/URLs to PRDs, plans, ADRs, issues, branches, PRs — do not duplicate)

## Tooling

See [references/companion_tooling.md](references/companion_tooling.md). Tools: template + dedup + recommender. Agent: `cs-handoff-author`. Command: `/cs-handoff`.

---

**Version:** 1.0.0
**Derived:** Matt Pocock (MIT) + this repo's wrapper

© Alireza Rezvani · MIT · alirezarezvani/claude-skills

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

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