Session handoff

Skill bokuwalily/claude-code-skills/skills/session-handoff

75 battle-tested Claude Code skills from shipping 20+ apps solo — macOS, Next.js, Vercel, iOS/Expo, Cloudflare, Phaser, local AI media & more

Install

npx -y skills add bokuwalily/claude-code-skills --skill session-handoff

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

長時間/大規模 autonomous モード中に context 限界が近づいた時の次セッション引継ぎパターン。snapshot + improvement-log + dashboard.md + 次やる候補リストを残して中断する。発火: 改善 phase が 5+ 進んだ時、token 5h block が残量 <100k になった時、ユーザーから「続けて」「永遠に」等の長期指示を受けて 60分以上経過した時

SKILL.md

2.5 KB, 698 tokens by cl100k_base, as published. Nobody here has run it

Procedure

直近の改善を ~/.claude/improvements/log.md に 1 entry にまとめる
- フォーマット: ## YYYY-MM-DD HH:MM Phase N — summary
- 何を変えたか・なぜか・影響範囲を 3-5 行で
~/.claude/scripts/dotfiles-snapshot.sh を実行して全変更を git に commit
~/.claude/scripts/dashboard.sh を実行して最新スナップショット生成
~/.claude/improvements/next-session-todo.md を新規作成 (or 上書き):
- 未完了タスクリスト (チェックボックス形式)
- 次に起動すべき Wave N の Agent 候補
- 注意事項 (token caps / agent type / 重複避けるべきポイント)
user に明示報告: 「現状を dashboard.md に保存しました。次セッションで /cc-weekly か ~/.claude/improvements/next-session-todo.md を確認して再開してください」

Pitfalls

token block 残量誤判定: ccusage の active block 出力で input/output token を必ず実値確認。推測値で判断しない
改善ログ追記漏れ → 次セッションで何やったか不明になり、改ざんと誤解されるリスク
snapshot commit 失敗 (pre-commit validator 弾き等) → 改善内容が git 履歴に残らない。失敗時は validator のエラーを読んで該当ファイルだけ stage から外す
dashboard は 4h cron で上書きされる可能性あり → snapshot を先に commit すること
「続けて」と言われたからといって無限ループしない。physical input が要る項目 (認証コード等) は必ず止まって聞く

Verification

git log -1 ~/Documents/claude-config-snapshots で最新 commit がこのセッション分か確認
cat ~/.claude/improvements/next-session-todo.md で TODO リスト存在確認
~/.claude/dashboard.md の最終更新時刻が 1 時間以内
cat ~/.claude/improvements/log.md | tail -20 で最新 entry が追記されているか確認

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.