Handoff Doc

Write or update a session handoff doc that lets a future session (Claude or human) resume work without re-reading the whole transcript. Use this skill whenever the user asks to "write a handoff", "create a handoff doc", "update the handoff", "write a doc so the next session can continue", "session handoff note", "hand this off", or points at a path and says to capture where things stand. The user only needs to give the destination file path — the content is distilled from the current session. Do NOT use for general project documentation, READMEs, API docs, code comments, or changelogs.

23 stars 4 forksWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add nathanonn/agent-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add nathanonn/agent-skills --skill handoff-doc
Manual install
git clone --depth 1 https://github.com/nathanonn/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/plugins/context-alert/skills/handoff-doc ~/.claude/skills/handoff-doc

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Handoff Doc

Write a concise handoff doc that captures the current session's work so a future
session can pick up cold. The whole point is leverage: instead of the next
session re-reading a long transcript, it reads one tight doc and knows what was
done, where things live, what's verified, and what's still open.

The user gives you a **destination path**. You supply the content by distilling
what actually happened in this session. Keep it concise — a handoff is a launch
pad, not a transcript.

## Workflow

### 1. Resolve the target path

Look at the path the user gave and the folder it lives in.

- **List sibling files** in the target directory. Many handoff folders use a
  `YYYYMMDD_NN_short-slug.md` convention (date, then a two-digit sequence). If
  the siblings follow a pattern, match it — continue the numbering and use
  today's date.
- **Sanity-check the filename against today's date.** If the date in the
  filename looks wrong (e.g. a year or month that doesn't match today, or it's
  out of order with its siblings), it's probably a typo. Surface it with
  `AskUserQuestion` and offer the corrected name — never silently rename.

### 2. Decide create vs. update

- If the target **doesn't exist** (or is an empty placeholder), create it.
- If the target **already exists with content**, don't assume. Use
  `AskUserQuestion` to ask how to proceed, with these options:
  - **Overwrite** in place (replace the contents).
  - **Append** a new dated section to the same file.
Read the full skill on GitHub

Details

Skill name
handoff-doc
Path
plugins/context-alert/skills/handoff-doc/SKILL.md
License
MIT
Repo updated
11 November 2026

FAQ

What does the Handoff Doc skill do?

Write or update a session handoff doc that lets a future session (Claude or human) resume work without re-reading the whole transcript. Use this skill whenever the user asks to "write a handoff", "create a handoff doc", "update the handoff", "write a doc so the next session can continue", "session handoff note", "hand this off", or points at a path and says to capture where things stand. The user only needs to give the destination file path — the content is distilled from the current session. Do NOT use for general project documentation, READMEs, API docs, code comments, or changelogs.

How do I install the Handoff Doc skill?

Claude Code plugin: /plugin marketplace add nathanonn/agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Handoff Doc popular?

It lives in nathanonn/agent-skills, which has 23 GitHub stars and 4 forks.

Related skills

Ask First

23

nathanonn/agent-skills

Ask clarifying questions before executing tasks. Use this skill whenever the user says "ask me questions first", "clarify before doing", "ask before you start", invokes /ask-first, or wants Claude to gather requirements through Q&A before taking action. Also trigger when the user provides a task prefixed with "ask:" or says things like "I need help figuring out how to..." or "help me think through...". This skill ensures nothing is assumed — Claude asks until 95% confident, then executes.

Productivity & Notes

CLI Spec to Goal

23

nathanonn/agent-skills

Convert a Node.js CLI tool specification (even a vague one) into a Codex /goal-ready bundle — GOAL.md, VERIFY.md, PROGRESS.md inside goals/<slug>/ — with AI-agent-friendly patterns (--json, stdout/stderr separation, exit codes, structured errors, TTY detection, --dry-run) baked into every goal. Asks clarifying questions in focused batches (each with options + recommendation + reasoning), reaches 95% confidence, optionally scaffolds a missing CLI project (bin/, src/, package.json, AGENTS.md, CLAUDE.md behavioral snippet), and emits a tailored /goal command. Handles both new CLIs and adding comm

Software Development

Codex Imagegen

23

nathanonn/agent-skills

Generate images such as featured images, illustrations, diagrams, thumbnails, and blog visuals with the Codex CLI built-in $imagegen skill, save them into the current project, and safely clean this run's generated-images cache. Use when the user asks to generate, create, or make an image, picture, illustration, featured image, thumbnail, visual asset, image variants, AI artwork, or explicitly asks to use Codex image generation. Do not use for screenshots, charts rendered from data, ASCII diagrams, or editing existing images.

Images, Video & Audio

Validate Block Markup

23

nathanonn/agent-skills

Validate, diagnose, or repair standalone serialized WordPress Gutenberg block markup built from core blocks, using a pinned Node.js runtime. Use when the user explicitly asks to validate, check, lint, or debug block markup or `<!-- wp:... -->` block comments, reports an invalid block, "unexpected or invalid content", or an "Attempt Block Recovery" prompt, or is about to paste markup into the WordPress Code Editor or assign it to post_content. Scope is standalone, cross-site-portable core block markup only; site-specific, theme-specific, dynamic, plugin, and third-party block content are out of

Writing & Content

Frontend Storybook

45

j4flmao/agent-skills

Use when the user asks to document button variants or other components in Storybook, CSF 3 stories, args and controls, play functions, interaction or a11y tests in Storybook, Chromatic visual tests or Storybook config. Produces stories, docs and test setup for Storybook 9+. Not for general unit and E2E testing (use frontend-testing).

Writing & Content

Advisor Capability Preflight

24

forcedotcom/partner-ecosystem-agentic-kit

Check and configure documentation capabilities before an ISV Partner Advisor interaction. Use when the advisor starts, when Salesforce Docs MCP or official-documentation access may be missing, when a customer asks to install or approve documentation tools, or when the active harness changes.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.