szotasz/marveen/handoff
Claude Code and agent skill by szotasz/marveen
- community
Checking that the SKILL.md file is still in the repository.
Generate a HANDOFF.md context transfer document for session continuity. Use when switching sessions, handing off to another agent, or preserving complex task context before a context window reset. Trigger on "/handoff" command or "handoff:" prefix in inter-agent messages.
Install
npx vskill@latest install szotasz/marveen/handoffSKILL.md
Handoff -- Session Context Transfer
When to use
- You are about to hit context limits and need to preserve task state
- A task needs to continue in a fresh session (yours or another agent's)
- Inter-agent delegation of a complex, multi-step task
- User explicitly says
/handoffor asks to "save context for later" - Before a
/checkpointwhen the task is too complex for 3-5 bullet points
Arguments
| Argument | Required | Description | |
|---|---|---|---|
purpose | YES | What the next session should do with this context | |
target | no | Agent name (e.g. target=dev2) -- sends via inter-agent message instead of writing file | |
output | no | File path override (default: project root HANDOFF.md) |
Examples:
/handoff purpose="Continue the Pipedrive connector PR review and address CI failures"/handoff purpose="Finish the scheduler forceSend implementation" target=dev2/handoff purpose="Debug the auth redirect loop" output=/tmp/handoff-auth.md
Procedure
1. Gather context
Collect data from these sources (skip any that return empty):
Also include from your current conversation context:
- The last significant user/peer messages and decisions
- Any error patterns or debugging findings
- File paths and line numbers you were working on
- Git branch, uncommitted changes, open PRs
2. Generate HANDOFF.md
Structure with exactly these 5 sections:
3. Deliver
File mode (default): Write HANDOFF.md to the project root (or output path).
Inter-agent mode (target= specified): Send the full HANDOFF.md content as an inter-agent message:
4. Confirm
Report to the user/caller:
- Where the handoff was written (file path or inter-agent message ID)
- Summary: how many kanban cards, memories, and log entries were included
- The
purposeline for quick reference
Pitfalls
- Do NOT include secrets, tokens, or .env values in the handoff
- Do NOT include full file contents -- use paths and line numbers
- Keep it under 3000 words -- the receiving session needs room to work
- If
target=agent is not running (check tmux), warn and fall back to file mode - The handoff is a snapshot -- it goes stale. Include the timestamp prominently
Relation to other persistence mechanisms
| Mechanism | Scope | Handoff uses it as | |
|---|---|---|---|
| checkpoint | Session summary (SQLite) | Source: pulls recent checkpoint data | |
| DREAM.md | Nightly consolidation | Not directly -- too high-level | |
| hot memory | Active task state | Source: includes active hot memories | |
| warm memory | Stable project context | Source: includes relevant warm context | |
| kanban | Task tracking | Source: includes assigned/active cards | |
| daily log | Chronological record | Source: includes today's log entries |
The handoff READS from these systems but does not REPLACE them. After a handoff, the receiving session should still check the live state of kanban/memory -- the handoff is a starting-context accelerator, not the source of truth.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingseed-skills/handoff/SKILL.md
Popularity
- 7-day trend score
- 5
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/szotasz/marveen/handoff)