Session Handoff
live9369/session-handoff-skill
Preserve contexto de agente entre sessões e troca de modelos
Ver no GitHubSkill que salva e restaura o estado completo de um agente (papel, tarefas, decisões, progresso e próximos passos) em um arquivo estruturado, permitindo continuar trabalhos longos entre sessões do Cursor, Claude Code ou mudanças de modelo sem perder contexto.
Instalação
npx convez-ai live9369/session-handoff-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Continuar tarefas longas quando atingir limites de contexto
- Alternar entre modelos rápidos e capazes sem perder progresso
- Migrar trabalho entre Cursor e Claude Code
- Documentar e verificar estado do projeto antes de nova sessão
Veredito

Ferramenta prática e bem desenhada para quem trabalha com agentes em sessões longas. Resolve um problema real de perda de contexto com abordagem simples (arquivo markdown estruturado), embora reconheça suas limitações (não preserva raciocínio implícito).
README
A tradução para o português deste README ainda está na fila.
Session Handoff
English | 简体中文
Save and restore agent role, task state, decisions, progress, blockers, and next steps across Cursor sessions, Claude Code sessions, or model switches.
Why Session Handoff
Long agent tasks lose context when you:
- Start a new chat
- Switch models (fast ↔ capable)
- Hit context-window limits
- Move between Cursor and Claude Code
Session Handoff writes a structured, verifiable snapshot to
.cursor/state/HANDOFF.md so the next session can continue from documented facts
instead of guessing.
It does not claim to preserve hidden reasoning or full chat history.
Features
| Mode | Description |
|---|---|
| save | Create or replace the handoff file from current work |
| resume | Read handoff, verify repo state, continue from next actions |
| update | Refresh handoff after new progress |
| status | Summarize handoff without modifying files |
Quick start
Cursor
-
Install to
.cursor/skills/session-handoff/SKILL.md— see CURSOR.md -
Before ending a session:
/session-handoff save context -
In a new session:
/session-handoff resume
Claude Code
-
Install the plugin — see CLAUDE.md
-
Save:
/session-handoff:session-handoff save current context -
Resume:
/session-handoff:session-handoff resume from HANDOFF.md
Installation
| Method | Cursor | Claude Code |
|---|---|---|
| Project skill | .cursor/skills/session-handoff/SKILL.md | .claude/skills/session-handoff/ |
| Personal skill | ~/.cursor/skills/session-handoff/SKILL.md | ~/.claude/skills/session-handoff/ |
| Plugin | — | .claude-plugin/plugin.json |
Detailed steps:
Clone and link (development)
git clone <repo-url> session-handoff-skill
cd session-handoff-skill
Cursor — project install:
mkdir -p .cursor/skills
ln -sf "$(pwd)/skills/session-handoff" .cursor/skills/session-handoff
Cursor — personal install:
mkdir -p ~/.cursor/skills
ln -sf "$(pwd)/skills/session-handoff" ~/.cursor/skills/session-handoff
Claude Code plugin test:
claude --plugin-dir "$(pwd)"
Repository layout
session-handoff-skill/
├── .cursor/
│ └── skills/
│ └── session-handoff/
│ └── SKILL.md # → skills/session-handoff/SKILL.md
├── .claude-plugin/
│ ├── plugin.json # Claude Code plugin manifest
│ └── marketplace.json # Marketplace metadata (optional publish)
├── skills/
│ └── session-handoff/
│ └── SKILL.md # Canonical skill source
├── CURSOR.md # Cursor usage guide
├── CLAUDE.md # Claude Code usage guide
├── EXAMPLES.md # Prompt and handoff examples
├── README.md
└── README.zh.md
Handoff file
Path: .cursor/state/HANDOFF.md (in your project, not in this repo)
The file includes sections for role, objective, acceptance criteria, completed work, decisions, files, commands/tests, blockers, open questions, next actions, constraints, and a paste-ready resume prompt.
See EXAMPLES.md for a minimal example.
Cross-client workflow
The same handoff file works in Cursor and Claude Code:
- Save in either client
- Commit
.cursor/state/HANDOFF.md(optional) - Resume in the other client
Security
Never store passwords, tokens, private keys, or API keys in the handoff file. Summarize errors and logs; do not paste large secret-bearing output.
Documentation
| Document | Description |
|---|---|
| CURSOR.md | Cursor-specific setup and commands |
| CLAUDE.md | Claude Code-specific setup and commands |
| EXAMPLES.md | Sample prompts and handoff templates |
| skills/session-handoff/SKILL.md | Full skill specification |
License
MIT