Skip to main content
skill CX Codex

session-handoff · rohitg00 — Claude Code skill: what it does, how to install

session-handoff generates a structured handoff document capturing git state, open tasks, decisions, and a resume prompt for your next session.

MIT ★ 2,966 updated 2026-09-29

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

What session-handoff does

Context disappears once a terminal session closes. Unlike a personal wrap-up checklist, this skill writes specifically for the next agent session, outlining current branch status, uncommitted diffs, and exact lines needing attention.

The workflow queries local git history using git status, git diff --stat, git log --oneline -5, and git branch --show-current. It organizes findings into completed work, in-progress items, key choices with rationale, and unexpected gotchas encountered along the way. At the bottom, it outputs a ready-to-paste resume command.

The target project must be an initialized git repository, or the status collection commands will fail immediately.

What it helps with

  • document incomplete tasks before closing the CLI
  • preserve architectural decisions and context between sessions
  • pinpoint exact file paths and line numbers left mid-work
  • produce a copy-paste prompt to restart the next session

Example prompts for the agent

  • Wrap up and prepare a session handoff document
  • Save progress with session-handoff, I will continue later
  • Generate a session transfer note with a resume command

How to install session-handoff

1Plugin marketplace

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

This installs the whole pro-workflow plugin with all its skills

2Skills CLI (Vercel)

npx skills add rohitg00/pro-workflow --skill session-handoff -a claude-code

3Manually: put the files in place

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

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about session-handoff

How to install session-handoff in Claude Code?

Run both marketplace commands in sequence: first /plugin marketplace add rohitg00/pro-workflow, then /plugin install pro-workflow@pro-workflow.

What makes session-handoff different from wrap-up?

Wrap-up focuses on a personal checklist for the author, while handoff is written strictly as structured input for the next session.

What git commands does session-handoff execute?

It inspects the repository using git status, git diff --stat, git log --oneline -5, and git branch --show-current.

Source text

SKILL.md · MIT
---
name: session-handoff
description: Generate a structured handoff document capturing current progress, open tasks, key decisions, and context needed to resume work. Use when ending a session, saying "continue later", "save progress", "session summary", or "pick up where I left off".
user-invocable: true
---

# Session Handoff

Different from wrap-up. Wrap-up is a checklist for *you*. Handoff is a document written for the *next session*.

## Trigger

Use when saying "handoff", "continue later", "pass to next session", "session transfer", or ending a session and wanting to resume smoothly.

## Workflow

1. Gather current state from git.
2. List completed, in-progress, and pending work.
3. Note key decisions made and their reasoning.
4. Capture any learnings from this session.
5. Generate a resume command for the next session.

## Commands

```bash
git status
git diff --stat
git log --oneline -5
git branch --show-current
```

## Output

```markdown
# Session Handoff — [date] [time]

## Status
- **Branch**: feature/xyz
- **Commits this session**: 3
- **Uncommitted changes**: 2 files modified
- **Tests**: passing / failing / not run

## What's Done
- [completed task 1]
- [completed task 2]

## What's In Progress
- [current task with context on where you stopped]
- [file:line that needs attention next]

## What's Pending
- [next task that hasn't been started]
- [blocked items with reason]

## Key Decisions Made
- [decision 1 and why]
- [decision 2 and why]

## Learnings Captured
- [Category] Rule (from this session)

## Files Touched
- `path/to/file1.ts` — [what changed]
- `path/to/file2.ts` — [what changed]

## Gotchas for Next Session
- [thing that tripped you up]
- [non-obvious behavior discovered]

## Resume Command
> Continue working on [branch]. [1-2 sentence context]. Next step: [specific action].
```

## Guardrails

- Write for the reader (next session), not the writer.
- Include specific file paths and line numbers where relevant.
- The resume command should be copy-pasteable into the next session.
- Keep it factual — describe changes functionally, don't infer motivation.

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Similar skills

All skills for Agent setup: memory, context, orchestration →

session-handoff by other authors comes first.

session-handoff softaworks session-handoff creates handoff documents for AI agent session transfers. Useful when context window fills up or projects span multiple sessions. CX Codex +1 4,300installs session-handoff entireio session-handoff — a skill for Claude Code carries work context between agents and summarizes recent sessions. It activates when a task must continue in another agent. CX Codex +1 615installs session-handoff Alireza Rezvani session-handoff writes a structured handoff note with goals, open decisions, and artifact links so a fresh agent picks up right where work stopped. CX Codex +1 ★ 30,251repo stars session-handoff SethGammon session-handoff turns the current session into a structured HANDOFF block so the next session can pick up work without re-auditing the project. CX Codex +1 ★ 937repo stars project-session-manager Yeachan-Heo project-session-manager automates creation of separate git worktrees for each task, PR, or feature, with optional tmux session orchestration. Work on multiple branches in parallel without conflicts. CX Codex +1 937installs handoff ykdojo Creates or updates a HANDOFF.md file so an agent in a fresh session can pick up the task with full context. CX Codex +1 ★ 10,363repo stars vibe-handoff KhazP vibe-handoff creates a compact project handoff for another session or coding tool. It captures current work without copying chat transcripts or secrets. CX Codex +1 ★ 3,267repo stars handoff-doc Ronny (MiniMax Code team) handoff-doc is a Claude Code skill that writes a structured handover file before a session reset or task switch. It preserves critical context without relying on full chat history. CX Codex +1 ★ 741repo stars session-wrap ai-native-camp session-wrap walks through finished work before you close a session: what to commit, what to document, what is still open. CX Codex +1 1,300installs resume-handoff parcadei resume-handoff reads a handoff document, checks it against the actual repo state, and suggests a way forward. Useful when a session got cut off and the context needs to come back fast. CX Codex +1 486installs

From the same set83

The whole set →
core-rules core-rules — a rule file for your project: commit checks, Git habits, context discipline and the way the agent replies. Paste it into CLAUDE.md or keep it standalone. CX Codex +1 ★ 2,966repo stars context-optimizer The context-optimizer command checks context window fill rates in Claude Code and helps cut token waste before responses degrade. CX Codex +1 ★ 2,966repo stars module-map The module-map skill builds a compact map of an unfamiliar codebase area, covering entry points, core modules, data flow, and callers. Use it when you need to get oriented. CX Codex +1 ★ 2,966repo stars parallel Run multiple Claude Code sessions in parallel with isolated git worktrees. Ideal for working on features, testing, and code review simultaneously without file conflicts. CX Codex +1 ★ 2,966repo stars replay-learnings The replay-learnings skill searches project memory and similar sessions for lessons tied to a new task. Run it before coding to bring earlier corrections into view. CX Codex +1 ★ 2,966repo stars skill-optimize skill-optimize runs an offline optimization loop over a skill's accumulated examples, proposes improvements to its description file, validates candidates, and updates only when performance strictly improves. CX Codex +1 ★ 2,966repo stars orchestrate orchestrate coordinates multi-phase feature development with research, planning, gated implementation, and code review in Claude Code. CX Codex +1 ★ 2,966repo stars debugger debugger is a Claude Code subagent that investigates difficult bugs, failed tests, and runtime errors. It traces the cause before proposing a code change. CX Codex ★ 2,966repo stars

Project sponsors

Companies that keep this analytics open