SessionHandoffSkill

SessionHandoff

A Claude Code skill that splits the work in your current conversation across several fresh sessions and writes one ready-to-paste handoff prompt for each.

What it does

1. You give Claude a batch of work, for example 10 tasks (3 easy, 4 medium, 3 hard).
2. You run /SessionHandoff.
3. Claude asks how many sessions you want, for example 3.
4. Claude rates each task, groups them from easy to hard, and writes one self-contained prompt per session. In this example you get one prompt each for the easy, medium and hard tasks.
5. Each prompt is printed as a copy-paste block and saved to handoffs/ in your project:

1st prompt (easy), saved to /home/jason/project/handoffs/session-1-easy.md

See examples/example-output.md.

Grouping rules

• Sessions are ordered easy to hard. More sessions means finer splits.
• Tasks that touch the same code, or depend on each other, stay in the same session. If that is not possible, the overlap is flagged and each session gets its own branch.
• Asking for more sessions than tasks gives a warning and caps the number.
• A huge task can be split across sessions.
• Each prompt suggests a model that fits its difficulty.

What each prompt contains

Summary, tasks, files, constraints, acceptance criteria, branch, and a report-back format.

Install guide

Requires Claude Code and git.

1. Clone the repo

git clone https://github.com/JasonPieterK/SessionHandoffSkill.git
cd SessionHandoffSkill

2. Copy the skill into Claude Code's skills folder

macOS

mkdir -p ~/.claude/skills
cp -R .claude/skills/SessionHandoff ~/.claude/skills/

Linux

mkdir -p ~/.claude/skills
cp -r .claude/skills/SessionHandoff ~/.claude/skills/

Windows (PowerShell)

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null
Copy-Item -Recurse -Force ".claude\skills\SessionHandoff" "$env:USERPROFILE\.claude\skills\"

Windows (Command Prompt)

mkdir "%USERPROFILE%\.claude\skills"
xcopy /E /I /Y ".claude\skills\SessionHandoff" "%USERPROFILE%\.claude\skills\SessionHandoff"

This installs the skill for all your projects. To install it for one project only, copy the folder into that project's .claude/skills/ instead.

3. Restart Claude Code and check

Restart Claude Code, then type /SessionHandoff. If it appears, you're done.

Update

Run git pull in the cloned folder and repeat step 2.

Usage

> (describe or list your tasks)
> /SessionHandoff
How many sessions do you want to split the work into?
> 3

You can also pass the number up front: /SessionHandoff 3.

Repository layout

.claude/skills/SessionHandoff/SKILL.md   the skill
examples/example-output.md               sample output
LICENSE                                  MIT

Contributing

Issues and pull requests are welcome. Keep SKILL.md short and the prompt template stable.

License

MIT License

Copyright (c) 2026 JasonPieterK

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.