Skip to content
mcp/skillhub

Agent Skill

Session Handoff skill

session-handoffsoftaworks/agent-toolkitskills/session-handoff/SKILL.md

Creates comprehensive handoff documents for seamless AI agent session transfers. Triggered when: (1) user requests handoff/memory/context save, (2) context window approaches capacity, (3) major task milestone completed, (4) work session ending, (5) user says 'save state', 'create handoff', 'I need to pause', 'context is getting full', (6) resuming work with 'load handoff', 'resume from', 'continue where we left off'. Proactively suggests handoffs after substantial work (multiple file edits, complex debugging, architecture decisions). Solves long-running agent context exhaustion by enabling fresh agents to continue with zero ambiguity.

2.6kMIT

always on

140 tokname + description

once used

1,322 tokSKILL.md body

bundled files

115 scripts

repo stars

2.6kGitHub

Install the Session Handoff skill

Skills CLI (Claude Code, Codex, Cursor and others)

npx skills add https://github.com/softaworks/agent-toolkit --skill session-handoff

Claude Code, by hand (all projects)

git clone --depth 1 https://github.com/softaworks/agent-toolkit.git /tmp/agent-toolkit
mkdir -p ~/.claude/skills
cp -R /tmp/agent-toolkit/skills/session-handoff ~/.claude/skills/session-handoff

For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.

What it costs your context

Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.

WhenWhat loadsCost
Every sessionName and description140 tok
When the agent uses itThe SKILL.md instructions1,322 tok
Only if opened11 bundled files (74 KB)varies

Until it is used, session-handoff costs about 9.7× less than the median MCP server we measured (1,363 tokens on every turn). Installing all 43 skills from softaworks/agent-toolkit would load 2,462 tokens of descriptions. Skills vs MCP study

Checks

  • Ships scripts the agent can run. Read them before installing.

Checked 2026-10-22 · method

What's inside

The headings of its SKILL.md. Read the full file on GitHub.

  • Handoff
  • Mode Selection
  • CREATE Workflow
  • Step 1: Generate Scaffold
  • Step 2: Complete the Handoff Document
  • Step 3: Validate the Handoff
  • Step 4: Confirm Handoff
  • RESUME Workflow
  • Step 1: Find Available Handoffs
  • Step 2: Check Staleness
  • Step 3: Load the Handoff
  • Step 4: Verify Context
  • Step 5: Begin Work
  • Step 6: Update or Chain Handoffs
  • Handoff Chaining
  • Storage Location
  • Resources
  • scripts/
  • references/

More skills from softaworks/agent-toolkit

All skills in this repo
  1. agent-md-refactorsoftaworks/agent-toolkit

    Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.

    2.6k40 tok idle · 1,732 in use
  2. backend-to-frontend-handoff-docssoftaworks/agent-toolkit

    Create API handoff documentation for frontend developers. Use when backend work is complete and needs to be documented for frontend integration, or user says 'create handoff', 'document API', 'frontend handoff', or 'API documentation'.

    2.6k55 tok idle · 1,139 in use
  3. c4-architecturesoftaworks/agent-toolkit

    Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure, create C4 diagrams, or generate context/container/component/deployment diagrams. Triggers include "architecture diagram", "C4 diagram", "system context", "container diagram", "component diagram", "deployment diagram", "document architecture", "visualize architecture".

    2.6k82 tok idle · 2,505 in use
  4. codexsoftaworks/agent-toolkit

    Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing. Uses GPT-5.2 by default for state-of-the-art software engineering.

    2.6k55 tok idle · 1,275 in use
  5. command-creatorsoftaworks/agent-toolkit

    This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.

    2.6k66 tok idle · 1,492 in use
  6. commit-worksoftaworks/agent-toolkit

    Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits.

    2.6k54 tok idle · 522 in use
  7. crafting-effective-readmessoftaworks/agent-toolkit

    Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.

    2.6k35 tok idle · 589 in use
  8. daily-meeting-updatesoftaworks/agent-toolkit

    Interactive daily standup/meeting update generator. Use when user says 'daily', 'standup', 'scrum update', 'status update', 'what did I do yesterday', 'prepare for meeting', 'morning update', or 'team sync'. Pulls activity from GitHub, Jira, and Claude Code session history. Conducts 4-question interview (yesterday, today, blockers, discussion topics) and generates formatted Markdown update.

    2.6k194 tok idle · 2,779 in use