- Home
- Skills
- Agents & Orchestration
- Session Handoff: Save & Resume Claude Work
Works with the AI Agents you already use
Session Handoff: Save & Resume Claude Work
- **Environmental Snapshot**: Documents the active git branch, uncommitted changes, and validated build/test commands.
Free
Session Handoff: Save & Resume Claude Work
Example session with this skill installed
I'm hitting the context limit. Let's do a handoff for the auth refactor. Check the current git status and tests first.
- Read your context and instructions
- Compiled the session handoff
I have verified the current state and generated the handoff file. git status shows 3 uncommitted files and all auth unit tests are passing.
HANDOFF.md
# Handoff — 2024-05-20 — Auth Refactor
## Goal
Migrate session-based auth to JWT-based middleware with refresh token support.
- Acceptance Criteria: Users can login, receive a 15m JWT, and use a 7d refresh token.
## Status
- [x] JWT signing utility implementation
- [/] Middleware integration (Started)
- [ ] Refresh token database schema
## Decisions (and why)
- Using RS256: Allows public key sharing for microservices to verify tokens without access to the private key.
- 15-minute TTL: Short lifespan minimizes risk if an access token is intercepted.
## Files touched
- `src/utils/jwt.ts` — Added sign/verify logic.
- `src/middleware/auth.ts` — Updated to check Bearer headers.
## Commands
- `npm test src/utils/jwt.test.ts`
- Current branch: `feat/jwt-auth`
- Uncommitted: `src/middleware/auth.ts`, `package.json`
## Open issues / risks
- Potential race condition in token refresh if multiple client requests fire at once.
## Next steps (ordered, each doable in one go)
1. Complete the try/catch block in `auth.ts` middleware.
2. Run `npx prisma migrate dev` for the new `RefreshToken` table.
3. Implement the `/refresh` endpoint in `auth.controller.ts`.
## Don't
- Do not use `jsonwebtoken` library; we are using `jose` for Edge compatibility.
Next steps
- Copy the content above into a new
HANDOFF.mdfile at the root. - Start a new session.
- Paste the contents of
HANDOFF.mdto resume exactly where we left off.
Connects securely to your tools. The creator never sees your data.
About this skill
Context window limits and long-running tasks often lead to lost progress and repeated work. This skill formalizes session state management by capturing the current mental model, file changes, and execution state into a portable file.
What it does
- State Capture: Records the high-level goal and specific acceptance criteria for the current task.
- Progress Tracking: Catalogs exactly which files were modified and why specific architectural decisions were made.
- Environmental Snapshot: Documents the active git branch, uncommitted changes, and validated build/test commands.
- Roadmap Planning: Generates a sequential list of actionable next steps to eliminate cold-start friction in new sessions.
- Failure Prevention: Explicitly lists "Dead Ends" to prevent the agent from re-attempting failed approaches.
How it works
- Trigger Handoff: Invoke the skill when the context window is near capacity or ending a workday.
- Fact Verification: The agent runs
git statusand tests to ensure the documented state matches reality. - Generate Document: The agent writes a structured
HANDOFF.mdfile to the repository root. - Resume Session: In a new window, the agent reads the handoff file, verifies the environment, and prompts to start the first pending step.
Frameworks & tools
This skill is platform-agnostic and works with any repository using git. It assumes a standard filesystem and the presence of a CLAUDE.md or similar project-level instruction file for full context.
Why this beats prompting it yourself
Manual handoff prompts often miss the "why" behind decisions or forget to verify if the code actually builds. This skill enforces a strict schema that includes uncommitted change tracking and verified command sequences, ensuring the next session starts with a working environment.
Use cases
- Context Refresh: Save state when the model reaches its context limit to start a fresh, high-performance session.
- Shift Changes: Hand off a complex debugging task to yourself or a teammate the next morning.
- Branch Switching: Document progress on Feature A before context-switching to a hotfix on Feature B.
- Task Archiving: Create a record of work performed during a long-running research or refactoring spike.
Known limitations
Requires git for state verification. Does not store actual secrets or API keys. Best results when HANDOFF.md is deleted or archived after task completion to avoid stale context.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Agents & Orchestration.
Requires git for environment verification. Effectiveness depends on the agent having filesystem access to write and read the HANDOFF.md file.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed 4 days ago
- Free with an Agensi account
- Software
Git