- Home
- Skills
- Workflow Automation
- handoff-kit: session pickup & handoff contract.
Works with the AI Agents you already use
handoff-kit: session pickup & handoff contract.
Standardized AI handoff protocol with structured journals, state-of-play docs, and automated Python validation.
Free
handoff-kit: session pickup & handoff contract.
Example session with this skill installed
That's it for today. Wrap up the session: record what we did in the journal, update the handoff, and make sure it validates.
- Read your context and instructions
- Compiled the handoff-kit
Session closed. The journal has a new entry, the handoff is updated in place, and the validator passes.
What changed in the record
| File | Change |
|---|---|
JOURNAL.md | Prepended session-2026-10-21-release-v1 after the <!-- SESSION ENTRIES --> marker. Older entries untouched. |
docs/state-of-play.md | Evidence baseline moved to 2e400e6 (tag v1.0.0). Finished items removed, new next action set. 779 of 800 words. |
.gitignore | Added dist/. |
Journal entry
<a id="session-2026-10-21-release-v1"></a>
2026-10-21 Released v1.0.0
Objective and constraints
Merge the skill package, tag it, and produce the release zip. Listing it is the user's step.
Changes and decisions
PR #2 rebase-merged to main as 2e400e6 (linear history kept), tagged v1.0.0, tag pushed. The zip is built from the tag, not the working tree:
git -c core.autocrlf=false archive --format=zip --prefix=handoff-kit/ -o dist/handoff-kit-1.0.0.zip v1.0.0:skills/handoff-kit
Validation and evidence
The check, kit and GitGuardian checks passed on PR #2 at 3b7b233. The merged tree is identical to the tested tree. The zip holds 14 files with LF endings; extracted to a fresh directory, it installed into an empty project that passed the validator.
Not verified: marketplace review, and a plugin install.
State at the end
main and v1.0.0 pushed. Downstream repositories untouched.
Next action and completion condition
Install the plugin and run a pickup in this repository.
Completion condition: the skill triggers from an install, and the listing result is recorded.
Do not repeat
Build release zips from the tag with core.autocrlf=false. Zipping a Windows checkout ships CRLF files.
Validator
$ python tools/check-handoff.py
Handoff structure, links and anchors OK.
This checks structure, not truth: read the evidence and the contradictions yourself.
Status, scoped
- VERIFIED: CI on the PR, and a clean install from the release zip.
- NOT VERIFIED: the marketplace review and a plugin install. They are the next action, not assumed done.
Next session starts with
Read docs/state-of-play.md, then the entry above. The first job is the plugin install check.
Connects securely to your tools. The creator never sees your data.
About this skill
AI sessions often end with fragmented context and lost momentum. This skill implements a structured handoff protocol that ensures every session starts exactly where the last one left off. It maintains a single source of truth for project state, preventing the "context reset" tax that slows down multi-session AI development.
What it does
- Install handoff infrastructure to set up a standard
AGENTS.mdcontract, state-of-play document, and dated journal. - Automate session pickups by parsing existing state, git status, and recent commits to synchronize context instantly.
- Formalize session ends by generating dated journal entries and updating the live state-of-play document with new evidence baselines.
- Validate handoff integrity using a dependency-free Python script that checks for broken links, word counts, and stale markers.
- Synchronize project tools by configuring
AGENTS.mdspecifically for tools like Claude, Cursor, and GitHub Copilot.
How it works
- Install the kit into a repo using
install.pyto create the standard file structure and config. - Pickup work by reading
docs/state-of-play.mdand confirming the current objective before starting tasks. - Journal progress by prepending anchored entries to
JOURNAL.mdusing the provided session templates. - Validate the state using
python tools/check-handoff.pyto ensure all links and status markers are compliant.
Frameworks & tools
This skill is a pure process implementation using Python 3.8+ standard library scripts. It integrates with Git for state tracking and is compatible with all major LLMs and AI coding assistants including Claude, Gemini, Cursor, and Copilot.
Why this beats prompting it yourself
Generic prompts for "summarizing what we did" result in hallucinated progress or vague bullet points. This skill enforces a schema-based validation via a Python script, ensuring the handoff actually links to evidence and adheres to hard word limits for context window efficiency.
Use cases
- Resuming a complex refactor after a 24-hour break without re-explaining the plan.
- Handing off a repository from a local dev session to a remote agent.
- Maintaining a readable audit trail of AI-generated changes for human review.
- Ensuring CI/CD pipelines fail if the AI forgets to update the project state.
Known limitations
The validator enforces document structure and link integrity but cannot verify the factual accuracy of the AI's reported progress. Requires Python 3.8+ to run the validation scripts.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Workflow Automation.
Validator checks structure, links, and limits only, not factual truth. Requires Python 3.8+. Existing AGENTS.md files are never overwritten automatically.
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
1 use
Times used to date
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed 26 days ago
- Free with an Agensi account
- Software
Python 3.8+
- Optional
Git
Permissions
File Scopes
The installer never overwrites an existing file unless --force is passed, and --dry-run shows the plan first. No network calls, no credentials, no telemetry.