# Handoff

> Save current work context to a file and sync it, so another machine can restore it with /resume

- **Type:** Skill
- **Install:** `agentstack add skill-maca0229-claude-context-resume-handoff`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [maca0229](https://agentstack.voostack.com/s/maca0229)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [maca0229](https://github.com/maca0229)
- **Source:** https://github.com/maca0229/claude-context-resume/tree/main/skills/handoff

## Install

```sh
agentstack add skill-maca0229-claude-context-resume-handoff
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

The user is about to switch to another machine and wants to save the current work context.

## Task

Summarize the current conversation's work state into a structured snapshot, write it to `~/.claude/handoff.md`, then attempt to push to remote.

## Snapshot Format

First, run the following to get the current time:
```bash
date "+%Y-%m-%d %H:%M"
```

Write the following structure (use the same language as the conversation):

```markdown
---
updated: {current datetime, format YYYY-MM-DD HH:mm}
note: {$ARGUMENTS if provided}
---

## What I'm working on

{1-3 sentences describing the current task and its stage}

## Progress

{bullet list of completed and pending steps, using ✓ and ○}

## Key context

{Important info the Claude on the other machine needs: file paths, decisions made, caveats}

## Next steps

{Up to 3 items — what to do first after resuming}
```

## After writing

Run the following to attempt sync (skip if `~/.claude` is not a git repo):

```bash
if git -C ~/.claude rev-parse --git-dir > /dev/null 2>&1; then
  cd ~/.claude && git add handoff.md && git commit -m "handoff: save session context" && git push 2>/dev/null && echo "Pushed to remote."
else
  echo "~/.claude is not a git repo. Handoff saved locally at ~/.claude/handoff.md — transfer it manually to the other machine."
fi
```

Tell the user the snapshot is saved and they can run `/resume` on the other machine to restore it.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [maca0229](https://github.com/maca0229)
- **Source:** [maca0229/claude-context-resume](https://github.com/maca0229/claude-context-resume)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-maca0229-claude-context-resume-handoff
- Seller: https://agentstack.voostack.com/s/maca0229
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.