SkillGild
Development

Handoff

Compacts a long conversation into a handoff document another agent (or a fresh session) can continue from: the goal, decisions made, current state, open questions and the exact next step.

  • 25 free runs a month
  • Runs in your agent, private tools on SkillGild
  • v1.0.0
  • Matt Pocock
skillgild install handoff
Works with
  • Claude Code
  • Codex
  • Cursor
  • Gemini CLI
and any MCP client

License: MIT · Created by Matt Pocock

Free

What you get

  • Compacts a long conversation into a handoff document another agent (or a fresh session) can continue from: the goal, decisions made, current state, open questions and the exact next step.
  • Use it when context is running out or when you move work between Claude Code, Codex or a teammate.

Install the Handoff skill

Pick your agent. The wrapper only tells your agent how to start a session. The skill's instructions arrive with each session, after your access is checked.

  1. Sign in once from your terminal.

    Terminal
    skillgild login
  2. Install this skill for Claude Code.

    Terminal
    skillgild install handoff --agent claude-code
  3. Register the SkillGild MCP server with Claude Code.

    Terminal
    claude mcp add --scope user skillgild -- $(command -v skillgild) mcp

How it runs

  1. Your agent starts a session. SkillGild checks your access and allowance, counts one run, and sends the skill's instructions for this task.
  2. Your agent does the work with its own model and tools, in your project. SkillGild makes no AI model call.

Use it from code

Start a session, follow its guide, then end it. Create an API key under Account and pass it as a bearer token.

Terminal
# Prints the session ID, its tools and the instructions for your agent
skillgild session handoff
skillgild end <session-id>

Questions

How do I install Handoff in Claude Code?

Run skillgild install handoff --agent claude-code and connect the SkillGild MCP server (skillgild mcp). When a task matches, your agent starts a session, which uses one of your 25 free runs this month, and follows the skill's instructions. Use --agent codex, cursor or gemini-cli for other clients.

Is Handoff free?

Yes. It includes 25 free runs every month on SkillGild. Handoff is open source (MIT) by Matt Pocock; SkillGild packages it from https://github.com/mattpocock/skills at a pinned commit and credits the author.

Does Handoff run on SkillGild?

It runs in your coding agent with your own model. SkillGild checks your monthly allowance and delivers the skill's instructions for each session; it makes no model call and never sees your project unless your agent sends it.

Which agents does Handoff work with?

The project lists Claude Code, Codex and other Agent Skills hosts. It is a plain Agent Skills folder (SKILL.md plus supporting files), so any client that reads that format can load it.

Related guides

Setup steps and worked examples for this kind of skill.