How do I install the Codemap Handoff skill?

Run npx skillmds@latest add shalomb/codemap-handoff in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Codemap Handoff safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codemap Handoff?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codemap Handoff free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Codemap Handoff?

shalomb (@shalomb) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codemap Handoff by shalomb — Agent Skill

Name: Codemap Handoff
Author: shalomb

Codemap Handoff

Create and read cross-agent handoff artifacts. Trigger this skill when the conversation context window is full and you need to resume work in a new session, or when you are asked to pass your current progress to another autonomous agent (e.g., Claude, Cursor, Pi).

shalomb b37454c 1.5 KB Updated Sep 17, 2026

File contents

Multi-Agent Handoff

Building a handoff

codemap handoff .               # Build + save full artifact
codemap handoff --prefix .      # Stable context only (hubs, file count)
codemap handoff --delta .       # Recent work only (changed files, risk, events)
codemap handoff --json .        # Machine-readable for other tools

Reading a handoff

codemap handoff --latest .      # Read most recent saved artifact
codemap handoff --detail <file> . # Full context for one changed file

What's in a handoff

Prefix (stable): file count, hub summaries — cache-friendly, changes rarely
Delta (dynamic): changed files, risk files, recent events, next steps
Hashes: deterministic — validates cache reuse across agent sessions

Artifacts written

File	Content
`.codemap/handoff.latest.json`	Full artifact
`.codemap/handoff.prefix.json`	Stable prefix snapshot
`.codemap/handoff.delta.json`	Dynamic delta snapshot
`.codemap/handoff.metrics.log`	Append-only metrics stream

When to handoff

Switching from one agent CLI to another
Starting a fresh session on the same branch
Context window filling up — compact and resume
Passing work to another developer's AI session

Frequently asked questions