session-handoff

session-handoff is a skill for Claude Code from romiluz13/auto-pi. It costs 83 tokens per session (906 once invoked), scanned A, original, MIT.

A workflow for transferring unfinished work from one coding-agent session to another. It records the current state, decisions, constraints, errors, and next steps.

In plain words
What is it for?
Use it to create a handoff document, save key decisions, and notify the next session about work that is complete, in progress, or blocked.
Why use it?
It prevents important context from being lost when a session becomes too long or work must continue in another project session.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter.

Good fit Use it to create a handoff document, save key decisions, and notify the next session about work that is complete, in progress, or blocked.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/romiluz13/auto-pi/session-handoff
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add romiluz13/auto-pi --skill session-handoff
Clone the repo
git clone --depth 1 https://github.com/romiluz13/auto-pi

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for session-handoff

README.md
[![agentmods](https://agentmods.dev/badge/skills/romiluz13/auto-pi/session-handoff/github.svg)](https://agentmods.dev/skills/romiluz13/auto-pi/session-handoff)
Your own site
<a href="https://agentmods.dev/skills/romiluz13/auto-pi/session-handoff"><img src="https://agentmods.dev/badge/skills/romiluz13/auto-pi/session-handoff/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for session-handoff

Your own site · 80×15
<a href="https://agentmods.dev/skills/romiluz13/auto-pi/session-handoff"><img src="https://agentmods.dev/badge/skills/romiluz13/auto-pi/session-handoff.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 83 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 906 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00083 $0.00906
Opus 5.5 $0.00033 $0.00362
Sonnet 5.5 $0.00017 $0.00181
Haiku 4.5 $0.00008 $0.00091

Measured 1mo ago against content hash 48d5fc34e809, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

session-handoff scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/session-handoff/SKILL.md · 63 lines

How it starts

The opening of the file, as written. The whole thing — 63 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Session Handoff

Transfer work from one Pi session to another without losing context. This is the cross-session version of compact-safe — instead of compressing the current session, you're moving the work to a new session.

When to use

  • Session is getting long (approaching compaction) and you want a fresh context
  • You need to continue work in a different project or branch
  • You're transferring work to a specialist session (e.g., handing a plan to a builder)
  • The user says "handoff", "continue in a new session", "pass this to X"

Procedure

  1. Write the handoff doc. The handoff extension (extensions/handoff.ts) writes a deterministic HANDOFF.md from recent turns + the last compaction summary. No LLM call — it's a snapshot. If the extension is available, it fires automatically. If not, write a markdown file to docs/handoff/<YYYY-MM-DD>-session-handoff.md with:

    • Active constraints — what must not change, what rules are in effect
    • Current state — what's done, what's in progress, what's blocked
    • Key decisions — what was decided and why
    • Errors (verbatim) — any error messages, stack traces, or failures
    • Next steps — what the receiving session should do first
  2. Save key decisions to memory. Use the memory tool to save:

    • Architecture decisions (to project or memory target)
    • Failures and corrections (to failure target with category)
    • User preferences discovered during the session (to user target)

    Capture memory payload BEFORE validation — compaction can fire between return and parse. If memory is full, save to the handoff doc instead.

  3. Discover the target session. Run intercom({ action: "list" }) to see active sessions. Filter by:

    • Same cwd (sessions in the same project)
    • Session name (if the user named it with /name)
    • Status (look for "idle" or "active" sessions that can receive work)
  4. Notify the target session. Run intercom({ action: "send", to: "<session-id-or-name>", message: "..." }) with:

    • The handoff doc path
    • A 3-line summary of what to do next
    • Any blocking constraints ("don't touch X", "Y is in progress")

Read the full file on GitHub · 63 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 63 lines · 83 tokens per session scan A 48d5fc34e809

Subscribe to this mod's changes

session-handoff is a skill published in the GitHub repository romiluz13/auto-pi (10 stars, last pushed 2mo ago), licensed MIT. It adds 83 tokens to every session and 906 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

codebase-memory

Use the codebase knowledge graph for structural code queries. Triggers on: explore the codebase, understand the architecture, what functions exist, show me the structure, who calls this function, what does X call, trace the call chain, find callers of, show dependencies, impact analysis, dead code, unused functions…

narumiruna/pi-extensions · 98 tokens

accordion-context-folding

Read this skill if you see {# FOLDED} markers in your context (e.g. {#3f9a2c FOLDED}), or if earlier parts of your context look summarized. Accordion is a desktop tool that may compact older context blocks to keep you under a token budget. The unfold tool restores a folded block (open from your next turn); the recall…

a-Fig/Accordion · 102 tokens

accordion-context-recall

Read this skill when you need to read the full content of a folded context block RIGHT NOW as a tool result — without opening it in your standing context. Use recall(codes) when you only need a value once and do not want to permanently restore the block. Accordion may fold older parts of your context to keep token…

a-Fig/Accordion · 89 tokens

memory-layer

Standalone persistent memory for Pi — smart search, symbol clustering, dedup, auto-recovery, trust scoring. Zero Python dependency.

GeneGulanesJr/LaPis · 29 tokens

lapis

Use LaPis persistent coding memory via the 'lapis' MCP server: memory-code/doc/save/search tools, repo indexing, and retrieval protocols.

GeneGulanesJr/LaPis · 32 tokens

write-swift

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know…

wangmiaozero/pi-harness · 107 tokens