01
It starts by itself
session ends or fills. Runs in Claude Code routine.
- ↻ session ends or fills
context near capacity or you request a handoff
softaworks · 4K installsSession Handoff skill
Runs by itself, when a chat ends or gets full.
You never lose the thread.
Install the Session Handoff skill and make it a habit: follow https://gethabit.dev/skills/softaworks/session-handoff.md
- 1Copy
- 2Paste into Claude Code, Codex or Cursor
- 3It runs by itself
4K installs3K starsMIT licenceSource on GitHub ↗
Session Handoff
by softaworks · 4K installs
The skill
Writes notes so a new chat can pick up your work.
Only when you ask.
Time saved
You never lose the thread. A fresh agent continues right where you stopped.
↻ Runs by itselfwhen a chat ends or gets full
How the habit works.
You don't have to.
When does it start? How does it check its work? What does it remember?
One run, step by step.
Then it stops.
Stops after one validated handoff per run, with 1 retry.
- 01
Scaffold
Run python scripts/create_handoff.py with a task slug, using --continues-from to chain to earlier work.
- 02
Fill the sections
Complete the current state, important context, next steps and decisions in the generated file.
- 03
Validate
Run python scripts/validate_handoff.py and fix placeholders, secrets or a low score.
- 04
Confirm
Report the file location, score and the first action item for the next session.
- 05
Resume later
On resume, list handoffs, check staleness, read the document fully and verify context before working.
What it may do.
Nothing more.
It writes only in its own folder and asks you before anything goes out.
- Writes only in.claude/handoffs/**
- Talks tono outside service
- Sendsnothing
- Your OKNothing goes out, so it needs no OK.
Is it for you?
Use it when it fits.
Read both lists. If the left one sounds like you, the Session Handoff skill helps.
Use it when
- ✓ A session is ending
- ✓ Context is getting full
- ✓ You resume earlier work
Skip it when
- – The task is a quick one-off
- – No context needs preserving
Session Handoff skill, answered.
When should it refuse to finalize?
When secrets are detected or the quality score is below 70.
How does it keep context across long projects?
By chaining handoffs with --continues-from, so each links to its predecessor.
How do I install the Session Handoff skill?
Copy the prompt at the top into your agent. It installs the skill from softaworks/agent-toolkit and sets up the habit. Or run npx skills add softaworks/agent-toolkit --skill session-handoff.
Is the Session Handoff skill free?
Yes. It is published under MIT. Habit is free too.
Session Handoff. Now as a habit.
Install the Session Handoff skill and make it a habit: follow https://gethabit.dev/skills/softaworks/session-handoff.md
All softaworks skills →More notes skills →
Works in
- Claude Code
- Codex
- Cursor
- ChatGPT
- Claude app
Made by softaworks, published under MIT. Habit links to the original and never changes it. Is this your skill?