Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/sei-newbear/xp-harness/handoff-docsnpx skills add sei-newbear/xp-harness --skill handoff-docsgit clone --depth 1 https://github.com/sei-newbear/xp-harnessWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/sei-newbear/xp-harness/handoff-docs)<a href="https://agentmods.dev/skills/sei-newbear/xp-harness/handoff-docs"><img src="https://agentmods.dev/badge/skills/sei-newbear/xp-harness/handoff-docs.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00106 | $0.01978 |
| Opus 5 | $0.00053 | $0.00989 |
| Sonnet 5 | $0.00021 | $0.00396 |
| Haiku 4.5 | $0.00011 | $0.00198 |
Grade A, and why
handoff-docs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 73 lines — stays where its author put it; the contents beside it link to each section on GitHub.
引き継ぎ可能な自己完結ドキュメントを書く
なぜこの skill があるか
別セッションのエージェントへ引き継ぐ成果物を書くとき、書き手の会話文脈が "のり" になる。ドキュメントに書かれていない前提を書き手は脳内で補完しながら読むため、本人には完成・自己完結して見える。だから書き手自身の自己点検では穴が見つからない。
この skill は、そういう「別セッションへ引き継ぐ前提の成果物」を自己完結に書くための規律と、書き終えたときに文脈ゼロで点検する動線を配る。
想定読者と方針
- 想定読者は会話文脈を持たない別セッションのエージェント。
- 人間向けの読みやすさ・簡潔さのために情報を削らない。削ると、別セッションで前提・判断の経緯が欠落し、設計意図とズレた実装に流れる。
- 簡潔さより文脈の完全性を優先する。長くてよい。 別セッションでそのまま動くために必要なコンテキストを漏れなく書き起こす方向に倒す。
自己完結性の規律 (漏らさず書く)
引き継ぎ先が会話文脈ゼロで読んで下流タスクに着手できるように、次を漏らさず書く:
- Why: なぜやるか、何の課題を解くか
- 決定の根拠: なぜこの判断にしたか
- 前提: 何を所与としているか
- 制約: 動かせない条件
- スコープ境界: やること / やらないこと
- 却下案とその理由: なぜ他の選択肢を採らなかったか (これがないと引き継ぎ先が同じ選択肢を再検討して時間を溶かす)
- 残タスクの続き: 残タスクは字面通りに着手できるだけでなく、続く可能性が高いこと (例: レビュー対応 → 再検証) に進める前提まで残す。ありうること全部でなく高確率なものに絞る
- やった検証・調査: 既にやった検証・調査は、その条件と結果を漏らさず残す (結論だけに畳まない)。条件には前提 (どんな環境・版で何を固定して確かめたか)・仕込み・手順・観測基準を含む — 結果はその前提の上でしか成り立たず、前提が落ちると次の人が結果を読み違える。再現・再確認できる形で書き、高確率で絞らず網羅する (既にやった事実だから)
表現の規律:
- 文脈なしで読めるように書く。会話文脈に依存する指示語・略号を持ち込まない (「案 A」「さっきのあれ」「上記の方針」で外部の会話を指す、など)。対象は具体名で書く。
- 番号・識別子だけで参照しない。内容で参照する。読み手は番号が指す中身を会話で共有していないので、番号だけでは伝わらない。
書き終えたら文脈ゼロで点検する (handoff-verifier を呼ぶ)
成果物を「自己完結した」「引き継げる」と宣言する前に、handoff-verifier subagent を呼んで文脈ゼロで点検する。書き手自身は会話文脈が "のり" になって穴が見えないので、自己点検では引き継ぎ可能性を担保できない。文脈ゼロの読み手を再現できるのは、会話を持たない独立の点検者だけ。
呼び出し側の規律 (文脈ゼロを壊さないために必須):
- handoff-verifier を呼ぶとき、渡すのは成果物のファイルパスと下流タスクの指定だけ (例「この要件定義から実装に着手できるか」)。
- 会話の背景・要約・意図の補足を渡す指示に書かない。背景を書くと、引き継ぎ先の条件 (会話文脈ゼロ) が再現できず、点検の意味が消える。書き手が「ここはこういう意図」と補足したくなるが、その補足こそ点検すべき穴 (ドキュメントに書かれていない前提) なので、渡してはいけない。
- 「文脈ゼロ」でゼロにするのは会話文脈であって、プロジェクトの既存資産ではない。handoff-verifier はプロジェクトのコードや他ドキュメントは読んでよい (引き継ぎ先の別セッションも読めるので、条件を揃える)。
Yes になるまで回す
handoff-verifier は「Yes / No と穴の具体指摘」を返す。read-only なので成果物は直さない。ループを回すのは呼んだ側 (あなた):
- No なら、指摘された穴を 1 つずつ直して、再度 handoff-verifier を呼ぶ。
- Yes になるまで繰り返す。
- 収束しない (同じ No が続く) ときは、成果物の構造自体を見直す。自己完結性の穴に見えて、根因が要件・設計そのものの欠落のことがある。
点検を通ったら引き継ぎの一言を出す
handoff-verifier が Yes になったら、成果物を「引き継げる」と宣言して終わりにせず、次のセッション / エージェントへの引き継ぎの一言 を出す。成果物を書いただけでは、受け手はどのファイルを読み何に着手すればいいか分からない。実際に引き継ぎを起動する一言まで出して、引き継ぎが完了する。
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 73 lines · 106 tokens per session scan A 8e3d12d95cd4
handoff-docs is a skill published in the GitHub repository sei-newbear/xp-harness (9 stars, last pushed 27d ago), licensed MIT. It adds 106 tokens to every session and 1,978 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
auto-perf-optimize
Run agent-driven VS Code performance or memory investigations. Use when asked to launch Code OSS, automate a VS Code scenario, run the Chat memory smoke runner, capture renderer heap snapshots, take workflow screenshots, compare run summaries, or drive a repeatable scenario before heap-snapshot analysis.
chat-perf
Run chat perf benchmarks and memory leak checks against the local dev build or any published VS Code version. Use when investigating chat rendering regressions, validating perf-sensitive changes to chat UI, or checking for memory leaks in the chat response pipeline.
chat-pet-sprite-creation
Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.
cpu-profile-analysis
Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…