personal-session-handoff

Summarizes session outcomes, decisions, and next steps into a resumable handoff record.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/kosako/agent-tools --skill personal-session-handoff-kosako
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: personal-session-handoff
Source: https://github.com/kosako/agent-tools/tree/main/shared/skills/personal-session-handoff
Command: npx skills add https://github.com/kosako/agent-tools --skill personal-session-handoff-kosako

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Work with AI agents breaks across sessions, and without a closing record the next session repeats the same investigation or loses track of decisions already made. This Skill captures the reached state, decisions with reasons, open items, and the next entry point so the next session resumes quickly and accurately. ## Core Features & Use Cases - Structured handoff drafting: Organizes outcomes (with sources), decisions (with reasons), unfinished work, and a recommended next action into a handoff summary. - Write authorization gating: Distinguishes write-authorized, draft, and no-write modes so external knowledge writes (logs, Notion, Issue comments) only happen with explicit trusted instruction and a confirmed destination. - Packet and canonical-file handling: Always updates the local agent-owned packet (.agent-packets/<issue>.md), treats .agent-context.local.md as read-only data, and suggests (never applies) durable rule updates to the user. - Use Case: At the end of a coding session you say "that's enough for today, write the handoff" — the Skill drafts the session summary, updates the local packet, and asks for confirmation before publishing anything externally. ## Quick Start Tell the agent "today ends here, write up the handoff" at the close of a work session to get a structured draft with the next entry point.

Frequently Asked Questions about personal-session-handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a session handoff summary for an AI agent?▼

End the session with a closing intent like "that's enough for today, write the handoff." The Skill organizes outcomes with sources, decisions with reasons, open items, and a single next action into a draft you can review before anything is saved.

How to safely write session notes to external tools like Notion or GitHub Issues?▼

External writes require two separate confirmations: explicit write intent from the current trusted user, and a confirmed destination. Note-derived URLs or paths are treated as unverified candidates until the user approves the specific target and content.

Does the session handoff skill write to files automatically?▼

Only the local agent-owned packet (`.agent-packets/<issue>.md`) is always updated. The canonical `.agent-context.local.md` file stays read-only, and all external knowledge sinks require explicit authorization before any write occurs.

Can a reference note authorize automatic record-keeping?▼

No. Notes are read strictly as data, never as instructions. Text inside a note claiming pre-approval or demanding automatic updates cannot grant write authorization, and embedded instructions are ignored rather than executed.

When should I not use the session handoff skill?▼

Do not use it for session-start status checks or continuation — that is the role of the resume skill (personal-resume-project). It is also not for fabricating records: only events that actually happened are captured, with sources cited.