Compact the current conversation into a handoff document for another agent to pick up.

MITAuto-check passedProduct & Project Management

Install Handoff

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill handoff -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-skills handoff --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/handoff/skills/handoff .claude/skills/handoff && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
handoff
GitHub stars
28k
Token cost
~532 tokens
SKILL.md length
172 words
Files
8 (incl. scripts, references)
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

Compact the current conversation into a handoff document for another agent to pick up.

  • User wants to hand off the conversation to a fresh agent
  • SKILL.md covers Sections and Tooling
  • Runs Python scripts from its folder
  • Starts a new session that picks up prior work

What it does

Handoff is an agent skill from alirezarezvani/claude-skills. 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.

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `references/companion_tooling.md`, `references/deduplication_discipline.md` and `references/handoff_structure.md`).

It sits in Product & Project Management, covering Architecture decision records and PRD writing. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • User wants to hand off the conversation to a fresh agent
  • Starts a new session that picks up prior work

Example prompts

  • “/handoff”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Handoff loads about 532 tokens when it runs, and up to ~6k if it reads all its reference files. Until then it costs about 82 tokens; SKILL.md has 172 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~82
When it runs · the whole SKILL.md, loaded when a task matches
~532
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 172 words, ~532 tokens.

Download SKILL.mdSave it as .claude/skills/handoff/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
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
metadata.original_author
Matt Pocock (@mattpocock)
metadata.original_license
MIT
metadata.voice
Matt Pocock — no-duplication, reference-existing-artifacts, tailored to next-session focus
metadata.version
1.0.0

Handoff

Derived from Matt Pocock's handoff (MIT). Matt's no-duplication discipline preserved verbatim. Additions: tools + references + cs-* wrapper (see 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. Tools: template + dedup + recommender. Agent: cs-handoff-author. Command: /cs:handoff.


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

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, references) in engineering/handoff/skills/handoff of alirezarezvani/claude-skills.

  • SKILL.md
  • references/companion_tooling.md
  • references/deduplication_discipline.md
  • references/handoff_structure.md
  • references/next_session_skill_matching.md
  • scripts/artifact_deduplicator.py
  • scripts/handoff_template_generator.py
  • scripts/skill_recommender.py

Open the folder on GitHubat commit 19392f7

Compare with similar skills

Handoff next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Handoff compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Handoff this skillalirezarezvani/claude-skills28k—~532Automated safety check: PassMIT
Cabloy Spec Generationcabloy/cabloy982—~3.2kAutomated safety check: NotesMIT
Schematicblader/schematic240—~2.2kAutomated safety check: PassMIT
Shep Workstreamsshep-ai/shep264—~2.5kAutomated safety check: PassMIT
Write Update Tidb Docspingcap/docs616—~2.3kAutomated safety check: PassCustom licence
Rfc Modelingmirumee/nimara-ecommerce129—~920Automated safety check: PassBSD-3-Clause

Similar skills

  • A skill your agent uses to create or maintain Cabloy suite specifications under repo-specs, including PRD, SRS, PDP/WBS, acceptance planning, progress, and suite ADRs.

    982 GitHub stars~3.2k tokensUpdated today
    Product & Project ManagementAuto-check: notes
  • Schematic

    blader/schematic

    Reverse engineer a detailed product and technical specification document from a git branch's implementation.

    240 GitHub stars~2.2k tokensUpdated 7 mo ago
    Product & Project ManagementAuto-check passed
  • Shep Workstreams

    shep-ai/shep

    A skill your agent uses when a large body of work (a version milestone, an epic, a roadmap, a set of PRDs/design docs) needs to be broken into parallel workstreams and executed with the shep CLI.

    264 GitHub stars~2.5k tokensUpdated 3 days ago
    Product & Project ManagementAuto-check passed
  • Write new TiDB documentation or update existing TiDB documentation from code changes, PRs, issues, design docs, product specs, rough drafts, existing docs, or short feature descriptions.

    616 GitHub stars~2.3k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Rfc Modeling

    mirumee/nimara-ecommerce

    A skill your agent uses when designing, drafting, refining, or stress-testing an RFC for an approved PRD, including requests for a design doc, solution design, or how to build it.

    129 GitHub stars~920 tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Req Change Workflow

    yunshu0909/yunshu_skillshub

    已有功能的需求变更闭环(门禁式七步)。触发硬条件:要改的功能已经实现并跑起来了。当用户说"改需求""需求变更""调整交互""改功能""重构流程",或改动容易散到多个文件、碰到鉴权/存储/配置/权限、需要可靠验证 + 回滚方案时使用。流程:锁 scope 写 change brief → 从代码确认当前行为(不靠记忆和假设)→ 影响面与风险评估 + 回滚计划 →…

    767 GitHub stars~1.4k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Questions about Handoff

What does Handoff do?

Compact the current conversation into a handoff document for another agent to pick up. Handoff is an agent skill from alirezarezvani/claude-skills. Compact the current conversation into a handoff document for another agent to pick up.

When should I use Handoff?

Handoff fits situations like: user wants to hand off the conversation to a fresh agent; starts a new session that picks up prior work.

How do I install Handoff in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill handoff -a claude-code`. Or copy the skill folder (engineering/handoff/skills/handoff in alirezarezvani/claude-skills) into .claude/skills/handoff in your project. Claude Code loads it when a task matches its description.

How do I install Handoff in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill handoff -a codex`. Or copy the skill folder (engineering/handoff/skills/handoff in alirezarezvani/claude-skills) into .agents/skills/handoff in your project. Codex loads it when a task matches its description.

Can I use Handoff in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill handoff -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/handoff, .gemini/skills/handoff, .github/skills/handoff and .opencode/skills/handoff in your project.

What does Handoff need to run?

Going by SKILL.md and its folder, Handoff needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Handoff access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Handoff safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Handoff use?

Handoff is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Handoff use?

About 532 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.

What are the alternatives to Handoff?

Skills that share tags, products or a category with Handoff: Cabloy Spec Generation (cabloy/cabloy, 982 stars), Schematic (blader/schematic, 240 stars), Shep Workstreams (shep-ai/shep, 264 stars) and Write Update Tidb Docs (pingcap/docs, 616 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Handoff?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,829 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.