handover
Skill2 starsChanged 2 months agoMITView on GitHub
Compact the current conversation into a handover document a fresh agent can pick up and continue seamlessly. Invoke when only 5-10% of the session limit remains, when context usage passes 40% (less than 60% of the context window remaining), when context is about to cross an agent or session boundary, when work is blocked, or on explicit user request — never haphazardly mid-task. Covers decisions, shipped changes, key files, running state, verification, deferrals, and open questions.
53 other projects use a version of this, 2 of them edited.
Adopted by
Most recently taken up by
- Kealman/cland-v0their own version, first seen Nov 15, 2026
- gjoranv/claude-plan-skillstheir own version, first seen Nov 15, 2026
- yagizdo/quivertheir own version, first seen Nov 15, 2026
- thiagobluhm/o1memtheir own version, first seen Nov 8, 2026
- randommonicle/claude-skillstheir own version, first seen Nov 5, 2026
- hmislk/hmistheir own version, first seen Nov 2, 2026
Used with
Projects with it also use harness-init, incident and 7 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
steptianSkillharness-init
初始化 .harness 开发框架,集成代码修改影响范围评估和测试覆盖建议功能。触发词:'初始化新项目'、'harness init'、'更新 harness'、'分析影响范围'、'评估修改影响'
Also in 3 projects that use this
JkudjoSkillincident
Production incident response — structured triage, hypothesis tree, safe remediation, incident record
Also in 3 projects that use this
nicolasestremSkillbrainstorm
Structured idea generation and solution exploration with systematic analysis.
Also in 3 projects that use this
GoogleSkillto-tickets
Break a plan, spec, or the current conversation into a set of tracer-bullet tickets, each declaring its blocking edges, published to the configured tracker — edges as text in one file per ticket locally, or native blocking links on a real tracker.
Also in 3 projects that use this
BlockSkillplan
Draft a TDD, PRD, or lightweight plan in the conversation without committing it.
Also in 3 projects that use this
GoogleSkillgrilling
Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
Also in 3 projects that use this
- +2 more from google
Other versions53 projects use a version of this.
Word for word · 0
None found.
Edited · 2
- L-X-T/ng-agentic-skills★ 1316% same
- wakqasahmed/skills★ 296% same
Wrote their own version · 51
- me2resh/apexyard★ 542same name
- hmislk/hmis★ 244same name
- chenklein26-maker/Harness-Starter★ 119same name
- k1ein-chen/Harness-Starter★ 119same name
- eai-org/agent-toolkit★ 94same name
- manusco/resonance★ 38same name
- chacosoldier/compabob★ 34same name
- randommonicle/claude-skills★ 27same name
- yagizdo/quiver★ 16same name
- marcogalluccio/company-brain-os★ 7same name
41 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository31 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ai-agent-pr-metadataSkill
- changesets-releaseSkill
- clarify-workSkill
- decompose-to-issuesSkill
- define-doneSkill
- design-composition-checkSkill
- diagnoseSkill
- docker-db-guardrailsSkill
- docker-volume-guardrailsSkill
- external-campaign-triageSkill
- external-pr-styleSkill
- external-pr-viabilitySkill
- git-guardrails-claude-codeSkill
- git-identity-guardSkill
- hitl-blockerSkill
- open-code-review-setupSkill
- release-gateSkill
- resolving-merge-conflictsSkill
- review-gateSkill
- subagent-pipelineSkill
- tmux-orphaned-socketSkill
- to-prdSkill
- vps-cleanupSkill
- wizardSkill
- workflow-routerSkill
- write-prompt-guideSkill
- writing-for-agentsSkill
- cavemanSkill
- roastSkill
The file
We split this skill into the rules it gives an agent
9 rules. 0 are common, 8 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 40 edited versions we read keep these.
8
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 31
Do not audit the filesystem or git history to reconstruct this.
- Distinctive: line 33
Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs).
- Distinctive: line 35
If the user passed arguments, treat them as what the next session will focus on and tailor the doc accordingly.
- Distinctive: line 39
If the work traces to a GitHub issue or PR:
- Very specific: line 42
Add the label paused by agent (create it if missing).
- Distinctive: line 45
If no issue exists, report the handover file path in chat instead.
- Distinctive: line 81
Never invent state. If a section has nothing to report, write "none" — don't omit the section.
- Distinctive: line 83
If a plan file drove the session, name it first under "Key files."
- Distinctive: line 85
No next steps beyond the single "Pick up here" line — the next agent decides.
“Common” is measured: kept by at least 6 in 10 of the 40 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Handover
Produce a compact, structured summary so a fresh agent or session can continue without re-deriving what already happened. This is a context-handover artifact, not a status report — the audience is the next agent, not a stakeholder. Save to the temporary directory of the user's OS, not the current workspace.
When to invoke
- 5-10% of the session limit remains with work unfinished: pause at the next safe point and write the handover — don't run to the last token and stop silently.
- Context usage passes 40% of the window on unfinished multi-step work.
- Context is about to cross an agent, session, or clear boundary — including when the user signals they're about to clear context — or work is blocked and non-obvious state must be preserved.
- User says "handoff", "handover", "wrap up session", or a near-equivalent.
Skip it when ample context remains and work is progressing, or when the work is complete and legible from the issue, PR, and tests.
How to produce it
- Review the full conversation, not just the last few turns — handovers miss things when they only look at recent context.
- Pull state from these sources, in order:
- Any plan file referenced this session.
- Task/todo list state — anything in progress or pending.
- Background processes started this session — their IDs are load-bearing; the next agent can't rediscover them.
- Files created or modified this session — you already know what you touched, don't re-grep to rediscover it.
- Memory files written or updated this session.
- Current branch/worktree/PR/issue.
- Unresolved questions — things asked that never got a clear answer, or user asks that got deflected.
- Do not audit the filesystem or git history to reconstruct this. It's a synthesis of this session, not a fresh investigation.
- Include a "suggested skills" section listing skills the next agent should invoke.
- Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL.
- Redact secrets, API keys, passwords, personally identifiable information, credential values, and local credential-file paths as
Credential details: [redacted]. Separate local and public rendering: retain absolute paths only in the local temporary artifact. When publishing to GitHub, sanitize machine-local paths to prevent leaking host usernames, private home directory layouts, or internal service environments: omit the temporary handover file path, convert workspace file paths to repository-relative paths (e.g.src/cache/redis_client.py) or commit URLs, and replace all other machine-specific local paths (e.g./home/*,C:\Users\*,/opt/*) with[local path redacted]. - If the user passed arguments, treat them as what the next session will focus on and tailor the doc accordingly.
Publish to the issue
If the work traces to a GitHub issue or PR:
- Comment on the issue with the full handover content, sanitized per Rule 6 above (workspace paths converted to repository-relative, other local paths redacted, temp file path omitted) — temp directories do not survive; the comment is the durable copy.
- Add the label
paused by agent(create it if missing). It marks half-done work waiting for pickup and pairs withpicked by agent. - The agent that resumes removes
paused by agent, appliespicked by agent, and continues from the "Pick up here" line.
If no issue exists, report the handover file path in chat instead.
Output template — use this structure every time
# Handover — <one-line title of what this session was about>
## Where it started
<2-3 sentences: what was asked, key framing or constraints that emerged>
## Decisions locked + what shipped
- <decision or change> — <why, and where it lives (absolute path if a file)>
## Key files for next session
- `<absolute path>` — <why the next agent should read this first>
- Plan file: `<path>` (if a plan drove the session)
- Memory files touched: `<paths>` — or "none"
## Running state
- Background processes: <IDs + what they are + how to stop them> — or "none"
- Dev servers / ports: <url + port> — or "none"
- Open worktrees / branches / PRs / issues: <paths, numbers> — or "none"
## Verification — how to confirm things still work
- `<command>` — <expected outcome>
## Deferred + open questions
- Deferred: <item> — <why pushed to later>
- Open: <question needing the user's input> — <context>
## Pick up here
<1-2 sentences: the single most likely next action for a fresh agent>Hard rules
- Never invent state. If a section has nothing to report, write "none" — don't omit the section; structure stability is the point.
- Absolute paths always in the local artifact so an agent on the same host can locate files directly; in the public issue/PR comment, use repository-relative paths and replace host-specific paths with [local path redacted] to protect environment privacy.
- If a plan file drove the session, name it first under "Key files."
- Terse and concrete: paths, commands, IDs, decisions. Prefer links to issues, PRs, and files over prose. No retrospective, no hype, no emojis.
- No next steps beyond the single "Pick up here" line — the next agent decides.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

