SH
Session Handoff
🔵 Stable🕐 updated 2026-06-30
🔷 SkillSpec L3
pm-tokens
Write a handoff summary so another agent or person (or a fresh session) can pick up the work with full context. Use when ending a work session, hitting a context limit, switching agents, or pausing a task mid-flight. Produces a structured handoff: what the goal is, what's done, the current state, what's next, and the gotchas — so no context is lost across the boundary.
What to give it
▸The objective — what we're ultimately trying to achieve.
▸Progress — what's been done and decided so far.
▸Current state — what's in-flight right now, what's working/broken, where files/branches are.
▸Next step — the single most important thing to do next.
▸Gotchas — dead ends tried, constraints, things that will bite the next person.
✅ The bar it holds itself to
Every skill in this library self-verifies — these are this skill's own quality checks, straight from its definition.
✓Objective and definition-of-done are stated up front
✓Current state is concrete (branch/PR, what runs, what's broken) — not "made progress"
✓The next step is specific enough to act on immediately
✓Dead ends and gotchas are captured so they aren't repeated
✓Pointers (files, commands, links) are included; the whole thing is skimmable in ~a minute
⚠️ What it refuses to do
Do not write a vague status ("worked on the feature") — state exactly what's done and what's not
Do not omit dead ends — repeating failed attempts is the most common handoff waste
Do not bury the next step — it should be obvious and immediately actionable
Do not assume shared memory — the reader may have zero prior context
Do not pad it — a handoff nobody reads is worthless; keep it tight and scannable
Install
npx pm-claude-skills add --agent claude # or codex · cursor · gemini · hermes
# or one-line MCP (every skill, any client):
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp
Related skills
🔌 Embed this skill
Drop this on your blog, docs, or site — it renders a "Run this skill" card:
<div data-pm-skill="session-handoff"></div>
<script src="https://mohitagw15856.github.io/pm-claude-skills/embed.js" async></script>
💬 Discussion
Session Handoff is one of 750 open-source professional AI agent skills — all SkillSpec L3.
Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog