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.
Install
/plugin marketplace add nathanonn/agent-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add nathanonn/agent-skills --skill handoff-docgit 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-docPersonal 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.
Details
- Skill name
handoff-doc- Repository
- nathanonn/agent-skills
- 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
23nathanonn/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.
CLI Spec to Goal
23nathanonn/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
Codex Imagegen
23nathanonn/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.
Validate Block Markup
23nathanonn/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
Frontend Storybook
45j4flmao/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).
Advisor Capability Preflight
24forcedotcom/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.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.