Session Handoff Document skill for Claude and Codex

Session Handoff Document as an AI skill. It asks for Session goal, What happened, Artifacts and 2 more, then does the rest. Free to install in Claude or Codex.

Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.

Download the skill (.zip) · View SKILL.md

When it is used

Use when a long working session must be summarised so another person or agent can continue without the history. Do not use for summarising a meeting for stakeholders or writing project documentation. Related topics: AI, productivity.

What it will ask you for

• Session goal (free text, e.g. "What we set out to do")
• What happened (longer free text)
• Artifacts (longer free text)
• Who picks it up (choose one: A teammate, A fresh agent session, Me later)
• Next step known (choose one: Yes, No)

How it works

1. Write a three-sentence opener stating the goal and where the work stands now.
2. List completed work by artifact path instead of pasting content.
3. Record each decision with its reason and each failed attempt with why it failed.
4. List open questions and blockers, then state the first concrete next action if it is known.
5. Trim to one page with the most important item first.

What you get

A one-page handoff with sections for state, done, decisions, failed attempts, open questions and next action, every artifact given as a path.

What it watches out for

• Pasting long logs into the handoff, which buries the state the reader needs.
• Leaving out failed attempts, so the next person repeats them.
• Writing in shorthand only the author understands.

How to install

Claude.ai and the Claude desktop app

1. Download the skill .zip.
2. Open Settings, then Capabilities, and find Skills.
3. Choose Upload skill and select the .zip.
4. Ask Claude for help with the task. It loads the skill when your request matches.

Claude Code

1. Download the skill .zip.
2. Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
3. Start a new session. Claude Code loads the skill when your request matches.

Codex

1. Download the skill .zip.
2. Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
3. Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.

Cursor

1. Download the Cursor rule (.mdc).
2. Save it in .cursor/rules/ inside your project.
3. Cursor's agent applies the rule when your request matches its description.

AGENTS.md (Codex, Cursor, and other coding agents)

1. Copy the AGENTS.md section.
2. Paste it into AGENTS.md at the root of your repository, creating the file if needed.
3. Coding agents that read AGENTS.md follow it when your request fits.