File contents 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 が追記されているか確認
1 --- 2 name: session-handoff 3 description: Procedure 4 --- 5 6 ## Procedure 7 8 1. 直近の改善を `~/.claude/improvements/log.md` に 1 entry にまとめる 9 - フォーマット: `## YYYY-MM-DD HH:MM Phase N — summary` 10 - 何を変えたか・なぜか・影響範囲を 3-5 行で 11 2. `~/.claude/scripts/dotfiles-snapshot.sh` を実行して全変更を git に commit 12 3. `~/.claude/scripts/dashboard.sh` を実行して最新スナップショット生成 13 4. `~/.claude/improvements/next-session-todo.md` を新規作成 (or 上書き): 14 - 未完了タスクリスト (チェックボックス形式) 15 - 次に起動すべき Wave N の Agent 候補 16 - 注意事項 (token caps / agent type / 重複避けるべきポイント) 17 5. user に明示報告: 「現状を `dashboard.md` に保存しました。次セッションで `/cc-weekly` か `~/.claude/improvements/next-session-todo.md` を確認して再開してください」 18 19 ## Pitfalls 20 21 - token block 残量誤判定: `ccusage` の active block 出力で input/output token を必ず実値確認。推測値で判断しない 22 - 改善ログ追記漏れ → 次セッションで何やったか不明になり、改ざんと誤解されるリスク 23 - snapshot commit 失敗 (pre-commit validator 弾き等) → 改善内容が git 履歴に残らない。失敗時は validator のエラーを読んで該当ファイルだけ stage から外す 24 - dashboard は 4h cron で上書きされる可能性あり → snapshot を先に commit すること 25 - 「続けて」と言われたからといって無限ループしない。physical input が要る項目 (認証コード等) は必ず止まって聞く 26 27 ## Verification 28 29 - `git log -1 ~/Documents/claude-config-snapshots` で最新 commit がこのセッション分か確認 30 - `cat ~/.claude/improvements/next-session-todo.md` で TODO リスト存在確認 31 - `~/.claude/dashboard.md` の最終更新時刻が 1 時間以内 32 - `cat ~/.claude/improvements/log.md | tail -20` で最新 entry が追記されているか確認
commit dfde018ea6
Frequently asked questions How do I install the Session Handoff skill? Run npx skillmds@latest add bokuwalily/session-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.
What does the Session Handoff skill do? Procedure It is listed under Coding & Dev Tools on SkillMD.
Is Session 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 Session 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 Session Handoff free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Session Handoff? bokuwalily (@bokuwalily) published this skill. Their other Agent Skills are listed on their SkillMD profile.
bokuwalily