Saves session progress in a root HANDOFF.md so the next Claude Code, Codex, or Gemini CLI session can continue from the first open step.
Save or resume work with handoff
Writes current session progress into a repository-root HANDOFF.md so a later-session agent can continue from the first open step.
Source facts
- Repository
- YourAKShaw/handoff
- Last source activity
- November 3, 2026 at 19:46
- Detected SKILL.md language
- English
- Stars
- 0
- Forks
- 0
Uses
Use this Skill when you want to carry work from one agent session to the next through a single HANDOFF.md at the repository root, so Claude Code, Codex, Gemini CLI, Antigravity, Grok, or another agent can continue from the first open step. Ask to save or wrap up a session, to continue from the last session, or to set a repository up for handoffs. The file is rewritten in place, kept under about 80 lines, and must not record secrets, tokens, one-time codes, or personal data. The attached README's phrasing about instant continuation without re-reading the whole repository is author/README wording; the pinned resume workflow still requires the next session to read HANDOFF.md first, compare it with the current branch and recent commits, and raise mismatches before acting. This draft did not execute the Skill or its validator.
Prerequisites
Keep the Skill package together (SKILL.md, references/, workflows/, assets/, and scripts/) so the agent can find its resources. The site's general install module covers Skill-file installation. The attached README and references/agent-setup.md also document optional global install paths and a short rule in AGENTS.md, CLAUDE.md, or GEMINI.md for agents that do not load skills; those install commands are not repeated in the card summary, and they are not treated as work the first-time user has already completed. Python 3.9+ (standard library only) is required only if you run the package validator; it is not required to write or resume a handoff. This draft did not run the validator, an installer, or the Skill.
How to use
Tell the agent what you need: /handoff, "update the handoff", "wrap up", or "save where we are" to rewrite HANDOFF.md; "continue" (or a new session in a repository that already has the file) to resume; or "set this repository up for handoffs" if the repository has no HANDOFF.md or no handoff rule in its agent instructions. The agent chooses the matching workflow, follows the pinned format and capture rules, rewrites HANDOFF.md at the repository root (it never appends), and, when commits are already allowed in the session, commits that file on its own following the repository's commit rules. On resume, it reads HANDOFF.md first, compares the recorded branch and state with git status and recent commits, adopts the recorded constraints, starts the first next step, and asks you about open questions instead of guessing. Your later messages override the file. Finished items are removed, not archived. The workflow steps are agent work, not prerequisites you must already have completed.
Limitations
HANDOFF.md is kept under about 80 lines and is rewritten, never appended. Secrets, tokens, one-time codes, and personal data must not be recorded. The agent respects the repository's own instructions and your standing constraints, and it commits or pushes only when the session already allows it. A later session should raise a mismatch between the file and the repository rather than ignore it. The package validator checks the skill manifest, required files, and local links; the attached README states that it does not measure agent behavior, and this draft did not run it. The repository-root LICENSE is MIT, Copyright (c) 2026 Ayush Kumar Shaw, provided without warranty; those are LICENSE-file terms, not README-only claims. The launch post's wording about making continuity reliable is author/post phrasing, not a measured guarantee. Official reuse of this target is unknown. Your later messages override the file. Before saving, anything that would be harmful if the repository became public is removed.
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
| name | handoff |
|---|---|
| description | Save or resume a session handoff in HANDOFF.md at the repository root, so the next session with any AI agent continues from exactly where this one stopped. Use when the user types /handoff, says "handoff", "update the handoff", "wrap up", "save where we are", or asks to continue from the last session. |