Agent skill

Session Handoff Resume

by rohitg00 in rohitg00/agentmemory

Resumes the most recent agent session for the current directory, leading with any question left unanswered and ending with a concrete next step.

Apache-2.0Auto-check passedAgent Workflows

Install Session Handoff Resume

skills CLI
$ npx skills add rohitg00/agentmemory --skill handoff -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rohitg00/agentmemory handoff --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rohitg00/agentmemory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/handoff .claude/skills/handoff && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
handoff
GitHub stars
29k
Token cost
~678 tokens
SKILL.md length
274 words
Files
2
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

Resumes the most recent agent session for the current directory, leading with any question left unanswered and ending with a concrete next step.

  • Works in 5 steps: Resolve the project path: if $ARGUMENTS… → Call memory_sessions. Pick the most… → If the session ended on an unanswered… → …
  • Starting a session with no context about earlier work
  • SKILL.md covers Quick start, Why, Workflow and Anti-patterns, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The agent lists recent sessions with memory_sessions (limit 20) and picks the latest one whose working directory matches the project by directory boundary, meaning equality or one path starting with the other plus a path separator, preferring completed sessions over abandoned ones. A raw prefix check is called out as wrong because it would match a sibling repo such as a staging copy. If nothing matches, it says so and stops rather than borrowing another project's session. An optional argument overrides the directory.

If the session ended on a user-facing question, that question comes first, found in the summary or in recent conversation observations whose narrative ends with a question mark. The agent then summarizes the title, key files and key decisions or errors using memory_recall on the session's top concepts (limit 10), checking each result's session or project provenance, and closes with one next-step pointer. It never invents observations for an empty session. Related skills are recap, session-history and recall, and a shared troubleshooting guide covers missing memory tools.

When your agent uses it

  • Starting a session with no context about earlier work
  • Asked where we left off or to resume
  • Picking up an earlier task in the same directory
  • Checking whether the last session ended on an unanswered question

Example prompts

  • “Where were we on this project? Pick up the last session.”
  • “Resume the last session in this project.”
  • “Pick up where I left off in ../billing-service.”

Requirements

  • The agentmemory memory_sessions and memory_recall tools

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Resolve the project path: if $ARGUMENTS is given, normalize it to absolute
  2. Call memory_sessions. Pick the most recent session whose normalized cwd
  3. If the session ended on an unanswered user-facing question, surface it FIRST.
  4. Summarize: title/summary, key files, key decisions or errors, using
  5. End with one concrete "next step?" pointer.

What it can do on your machine

Read from SKILL.md and the folder at commit 007a1a7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Session Handoff Resume loads about 678 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 274 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~678

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rohitg00/agentmemory at commit 007a1a7, republished under its Apache-2.0 licence (© rohitg00). 274 words, ~678 tokens.

Download SKILL.mdSave it as .claude/skills/handoff/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
handoff
description
Resume the most recent agent session for the current working directory, leading with any unanswered question. Use when the user says "where were we", "resume", "handoff", "pick up where I left off", or starts a session with no fresh context.
argument-hint
[optional cwd override]
user-invocable
true

The user wants to resume work. Optional cwd override: $ARGUMENTS

Quick start

json
memory_sessions { "limit": 20 }

Pick the most recent session whose cwd matches this project, then: memory_recall { "query": "<session top concepts>", "limit": 10 }.

Expected output:

text
Resuming 7f3a9c2 "Auth refresh rework".
Open question: should logout revoke all device tokens or just the current one?
Next step: decide revoke scope, then update auth/logout.ts.

Why

Match the session by directory boundary, not raw prefix, so a sibling repo never gets mistaken for this one. Never invent observations for an empty session.

Workflow

  1. Resolve the project path: if $ARGUMENTS is given, normalize it to absolute (path.resolve(process.cwd(), $ARGUMENTS)); else use the cwd.
  2. Call memory_sessions. Pick the most recent session whose normalized cwd matches by directory boundary: equality, OR cwd.startsWith(projectPath + sep), OR projectPath.startsWith(cwd + sep). Prefer completed over abandoned. No match: report that this project has no matching session and stop. Do not substitute a different project's session.
  3. If the session ended on an unanswered user-facing question, surface it FIRST. Look in summary or recent conversation observations whose narrative ends in ?.
  4. Summarize: title/summary, key files, key decisions or errors, using memory_recall on the top concepts, limit 10. Check each result's session or project provenance before including it; a query alone does not enforce scope.
  5. End with one concrete "next step?" pointer.

Anti-patterns

WRONG: session.cwd.startsWith(projectPath) matches /repo-a-staging when the project is /repo-a, resuming the wrong repo's session.

RIGHT: session.cwd === projectPath || session.cwd.startsWith(projectPath + sep), a directory-boundary check that cannot cross sibling repos.

Checklist

  • cwd override resolved to an absolute, normalized path.
  • Match used a directory-boundary check, not a raw prefix.
  • Unanswered question (if any) leads the response.
  • Empty session is reported plainly, with an offer to start fresh.

See also

  • recap, session-history, recall: same session data, broader views.

Troubleshooting

See ../_shared/TROUBLESHOOTING.md if memory_sessions or memory_recall is not available.

© rohitg00, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugin/skills/handoff of rohitg00/agentmemory.

  • SKILL.md
  • EXAMPLES.md

Open the folder on GitHubat commit 007a1a7

Compare with similar skills

Session Handoff Resume next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Session Handoff Resume compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Handoff Resume this skillrohitg00/agentmemory29k—~678Automated safety check: PassApache-2.0
Coding Agent Session Findercode-yeongyu/oh-my-openagent70k1 repos~2.8kAutomated safety check: PassCustom licence
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT
Session History Searchslopus/happy24k—~3.1kAutomated safety check: PassMIT
Memori Long-Term MemoryMemoriLabs/Memori17k—~2kAutomated safety check: NotesCustom licence
Mindmemos CLImindscale-noah/MindMemOS1k1 repos~3.4kAutomated safety check: PassNone

Similar skills

  • Coding Agent Session Finder

    code-yeongyu/oh-my-openagent

    Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.

    70k GitHub starsUsed in 1 repo~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check: notes
  • Mindmemos CLI

    mindscale-noah/MindMemOS

    Give an AI agent persistent, cross-session long-term memory through MindMemOS.

    1k GitHub starsUsed in 1 repo~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Memori MCP Memory Usage

    MemoriLabs/Memori

    Teaches an MCP-connected agent when and how to call Memori's recall, summary, compaction, augmentation, feedback and quota tools to keep context across sessions.

    17k GitHub stars~3.8k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed

More from rohitg00/agentmemory

All 17 skills in this repo
  • Sets up and troubleshoots a local agentmemory install, covering the MCP connection, environment variables, ports, authentication and optional feature flags.

    29k GitHub stars~1k tokensUpdated 2 days ago
    Auto-check: notes
  • Commit Context Lookup

    rohitg00/agentmemory

    Traces a file, function or line back to the agent session behind its current commit, using git blame and a memory lookup, and reports only what the records show.

    29k GitHub stars~522 tokensUpdated 2 days ago
    Auto-check passed
  • Agent Commit History

    rohitg00/agentmemory

    Lists recent git commits linked to agent sessions, filterable by branch, repository or a result limit, showing the session id and observation count behind each one.

    29k GitHub stars~524 tokensUpdated 2 days ago
    Auto-check passed
  • Agentmemory Forget

    rohitg00/agentmemory

    Deletes chosen memories from agentmemory only after showing the matches and getting an explicit yes, for privacy requests and cleanup of outdated notes.

    29k GitHub stars~612 tokensUpdated 2 days ago
    Auto-check passed
  • Lesson Memory Recorder

    rohitg00/agentmemory

    Distills a user correction or hard-won rule into a confidence-weighted lesson that resurfaces automatically before similar future work.

    29k GitHub stars~721 tokensUpdated 2 days ago
    Auto-check passed
  • Agent Memory Discipline Loop

    rohitg00/agentmemory

    Makes persistent agent memory pay off by searching before work starts and saving each decision the moment it settles, rather than batching a summary at the end.

    29k GitHub stars~831 tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Session Handoff Resume

What does Session Handoff Resume do?

Resumes the most recent agent session for the current directory, leading with any question left unanswered and ending with a concrete next step. The agent lists recent sessions with memory_sessions (limit 20) and picks the latest one whose working directory matches the project by directory boundary, meaning equality or one path starting with the other plus a path separator, preferring completed sessions over abandoned ones. A raw prefix check is called out as wrong because it would match a sibling repo such as a staging copy.

When should I use Session Handoff Resume?

Session Handoff Resume fits situations like: starting a session with no context about earlier work; asked where we left off or to resume; picking up an earlier task in the same directory; checking whether the last session ended on an unanswered question.

How do I install Session Handoff Resume in Claude Code?

Run `npx skills add rohitg00/agentmemory --skill handoff -a claude-code`. Or copy the skill folder (plugin/skills/handoff in rohitg00/agentmemory) into .claude/skills/handoff in your project. Claude Code loads it when a task matches its description.

How do I install Session Handoff Resume in Codex?

Run `npx skills add rohitg00/agentmemory --skill handoff -a codex`. Or copy the skill folder (plugin/skills/handoff in rohitg00/agentmemory) into .agents/skills/handoff in your project. Codex loads it when a task matches its description.

Can I use Session Handoff Resume in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rohitg00/agentmemory --skill handoff -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/handoff, .gemini/skills/handoff, .github/skills/handoff and .opencode/skills/handoff in your project.

What does Session Handoff Resume need to run?

SKILL.md names no scripts, command-line tools or credentials: Session Handoff Resume is instructions for the agent only. Our summary lists: The agentmemory memory_sessions and memory_recall tools.

Does Session Handoff Resume access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Session Handoff Resume safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Session Handoff Resume use?

Session Handoff Resume is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Session Handoff Resume use?

About 678 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Session Handoff Resume?

Skills that share tags, products or a category with Session Handoff Resume: Coding Agent Session Finder (code-yeongyu/oh-my-openagent, 70k stars), Beads Task Memory (gastownhall/beads, 28k stars), Session History Search (slopus/happy, 24k stars) and Memori Long-Term Memory (MemoriLabs/Memori, 17k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Handoff Resume?

rohitg00 (a GitHub user) maintains it in rohitg00/agentmemory, which has 29,222 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

Source: rohitg00/agentmemory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.