claude handoff

    1

    Sessions lose context when you switch tasks, close a window, or hit rate limits.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    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 GithubStrategy in src/auth/strategies.ts.
    • Added provider_id and provider_name to the Postgres User model.
    • Created /auth/github and /auth/github/callback routes.

    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.md in 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

    1. Inventory Repos to identify every directory touched during the session.
    2. Triage Artifacts by scanning /tmp for valuable scripts or data and moving them to a persistent ~/.claude/session-artifacts/ directory.
    3. Reconcile Tasks by checking the previous handoff against the latest Git history to identify truly "Open" vs "Closed" items.
    4. Write Handoff by generating SESSION.md with a summary of decisions, dead ends, and concrete next steps.
    5. 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 /tmp artifacts 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.

    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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    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 forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed today

    • Free with an Agensi account

    Requires

    Git

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Listedtoday

    What's inside

    Frequently Asked Questions

    This skill solves "context drift" by automating the capture of invisible session data, such as failed experiments, ephemeral files in /tmp, and uncommitted Git stashes that manual summaries often overlook.

    The skill is compatible with any AI agent or IDE (like Claude Desktop or VS Code) that has access to a local terminal and standard Unix utilities like Git and Bash.

    Yes, the skill is designed to inventory every repository touched during a session, generating structured handoffs and archiving history across multiple project directories simultaneously.

    Absolutely; by assigning persistent IDs to open questions and reconciling Git logs, the skill ensures that a new agent can pick up exactly where the previous one left off without repeating work.

    For security reasons, the skill is hardcoded to avoid copying secrets or credentials into persistent storage, and it does not automatically push commits to remote origins without your manual intervention.

    You will receive the complete tool definitions and scripts required to integrate the handoff logic into your agent's workflow, along with documentation for initial setup.

    New in Agents & Orchestration