Handoff

SkillAI & models

skills-handoff lets your AI write a handoff document that sums up the current conversation. When a new agent takes over, it can read that summary and continue the work without starting from scratch or losing context.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add the skill, then ask your agent to write a handoff document whenever you plan to switch agents. Pass that document to the new agent so it can continue with full context.

Then ask your AI: use the Handoff skill

What your AI can do with it

  • Write a handoff document based on the current conversation
  • Summarize what was discussed and decided
  • Capture the state of the work in one readable place
  • Let a new agent pick up where the previous one left off

What this skill tells your AI

The instructions your AI receives, as published by alirezarezvani/claude-skills in .gemini/skills/skills-handoff/SKILL.md and read by ahel’s review.

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

Signals

GitHub stars
27k
Forks
4k
Last commit
Aug 2026
Advanced
Item type
skill
Key
skills-handoff
Source
github.com/alirezarezvani/claude-skills