Stop Losing Work When You Compact Claude Code

Every long Claude Code session eventually hits a wall: you have to compact to reclaim the context window — and the moment you do, whatever you didn't write down is effectively gone. Most of us never write it down, because doing it by hand is just enough friction that we skip it.

This video walks through a fix: a skill called handoff-doc. One command reads back through your entire session — the decisions you made, the files you touched, what's still open — and distills it into one structured doc written to a file on disk. That's about thirty seconds of your attention. Because it lives on disk, it's durable BEFORE you ever hit compact: whatever the reset throws away, your handoff is sitting safely in a file.

The full habit in one sentence: when context crosses your threshold (I use ~20%), finish your micro-task, run the skill, then compact. Watch the context percent — that's your sensor. The threshold is the trigger. The skill is the mechanism that makes it effortless. And it's not just for the AI: the doc reads like a structured briefing for a human teammate, or for you after a week away.

🔧 Install handoff-doc
In Claude Code (plugin):
/plugin marketplace add nathanonn/agent-skills
/plugin install handoff-doc@nathanonn-agent-skills

On another agent (Codex, Cursor, Copilot) — one-liner:
npx skills add nathanonn/agent-skills --skill handoff-doc

In Claude Code it shows up as /handoff-doc. On other agents, just describe the task and it triggers automatically.

🔗 Links
Skill + source (open source): https://github.com/nathanonn/agent-skills

⏱️ Chapters
00:00 The one command that saves a session
00:51 Why "on disk" beats the context window
01:30 Install it in two lines
01:56 The 20% rule (and why not wait)
03:10 Invoke it in one line
03:44 What the doc actually captures
04:36 Now you can compact safely
05:14 Fresh window, state intact
05:44 Why this beats writing it by hand
06:43 The habit in one sentence

If you build with AI coding agents, this channel is about getting real work done with them — practical, no hype. Subscribe if that's your thing.

This video uses an AI-generated voiceover and AI-assisted motion graphics, with human-directed scripting, editing, and publishing.

#ClaudeCode #AICoding #AgentSkills

Видео Stop Losing Work When You Compact Claude Code канала The Art of Vibe Coding