- Home
- Skills
- Agents & Orchestration
- claude handoff
claude handoff
Sessions lose context when you switch tasks, close a window, or hit rate limits.
Free
Works with the AI Agents you already use
claude handoff
Example session with this skill installed
Run a handoff for the current session. I've finished the auth logic but the session is getting too long and I need to clear the context.
- Read your context and instructions
- Compiled the claude handoff
Captured state for 1 repository and rescued 2 artifacts.
Session Handoff
Updated: 2025-05-14T15:30:00Z
Previous handoff: 2025-05-14T10:00:00Z
New session: read this file whole and keep it in context. Only [open] items are pending. Check git log --since=2025-05-14T15:30:00Z for commits newer than this file.
Bigger Picture
Refactoring the core authentication service to support OAuth2 providers. Currently moving from JWT-only to a multi-provider strategy.
Objective
Complete the basic OAuth2 strategy implementation for GitHub.
Git State
- Branch:
feature/oauth-github(1 unpushed) - Dirty files:
none - Stashes:
none - Recent commits:
a1b2c3d Session handoff: GitHub OAuth strategy implemented
e5f6g7h Add Passport.js GitHub strategy
i9j0k1l Update user schema for provider IDs
Completed This Session
- Implemented
GithubStrategyinsrc/auth/strategies.ts. - Added
provider_idandprovider_nameto the Postgres User model. - Created
/auth/githuband/auth/github/callbackroutes.
Decisions Made
- Use Passport.js: Standardizes multi-provider integration faster than manual implementation.
Dead Ends — Do Not Retry
- Manual OAuth flow: Attempted custom state validation but found it redundant given Passport's built-in handling.
Rescued Artifacts
~/.claude/session-artifacts/auth-service-2025-05-14T15-30Z
test-token-response.json: Captured API response from GitHub for mocking.debug-flow.sh: Script used to curl the callback endpoint during dev.
Closed Since Last Handoff
- T1 (since 2025-05-14) Research Passport compatibility — done: Integrated in commit
e5f6g7h.
Next Step
- [open] T2 (since 2025-05-14) Map GitHub profile email to existing local users to prevent duplicates.
Open Questions
- [open] T3 (since 2025-05-14) Should we support GitHub Enterprise custom URLs?
- [if prod] T4 (since 2025-05-14) Rotate the client secret in the vault.
Next steps
- Review
SESSION.mdin the root directory. - Check
~/.claude/session-artifacts/for rescued debug logs. - Start the next session by loading the handoff file.
Connects securely to your tools. The creator never sees your data.
About this skill
Sessions lose context when you switch tasks, close a window, or hit rate limits. This skill captures the invisible state of a coding session—failed attempts, confirmed assumptions, and ephemeral files—to ensure the next session starts with full situational awareness. It maintains a clean SESSION.md for immediate action and a SESSION_ARCHIVE.md for historical traceability across multiple repositories.
What it does
- State Capture logs current Git branch, status, stashes, and recent commit history into a structured handoff file.
- Artifact Rescue moves ephemeral files from
/tmp(scripts, datasets, query results) to persistent storage before they are wiped. - History Rotation archives previous handoff notes into a chronological log, preventing context bloat while preserving history.
- Progress Validation cross-references pending tasks against Git logs to verify what was actually completed versus what remains open.
- Task Tracking assigns persistent IDs to open questions and next steps to track work across sessions without duplication.
How it works
- Inventory Repos to identify every directory touched during the session.
- Triage Artifacts by scanning
/tmpfor valuable scripts or data and moving them to a persistent~/.claude/session-artifacts/directory. - Reconcile Tasks by checking the previous handoff against the latest Git history to identify truly "Open" vs "Closed" items.
- Write Handoff by generating
SESSION.mdwith a summary of decisions, dead ends, and concrete next steps. - Commit State to the local repository to ensure the handoff is version-controlled and ready for the next developer or agent.
Frameworks & tools
This skill uses standard Unix utilities and Git commands, including git, grep, bash, find, and filesystem operations. It is designed to work in any terminal environment where Git is present, including WSL and macOS.
Why this beats prompting it yourself
Manual handoffs often miss "negative knowledge"—the things you tried that didn't work. This skill forces an inventory of /tmp and dead ends while using Git logs to prove tasks are actually done, preventing the "hallucinated progress" common in manual summaries.
Use cases
- Shift Handoffs when stopping for the day and needing a clear starting point for tomorrow.
- Context Switching when jumping between feature branches or different microservices.
- Agent Handoffs when moving from a research-focused agent to a coding-focused agent.
- Disaster Recovery ensuring
/tmpartifacts are saved before a VM or container restart.
Known limitations
Does not automatically push commits to remote origins. Restricted from copying secrets or credentials into persistent storage. Requires a local Git repository to function correctly.
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 local Git. Will not push to remote. Does not rescue files >200MB or secrets. Limited to repos touched in the current session.
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
Fresh listing
Recently published to Agensi
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed today
- Free with an Agensi account
- Software
Git