handoff
Standardizes session state transfers through factual, compact artifacts.
Install
mkdir -p .claude/skills/handoff-boshu2 && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/18542" && unzip -o skill.zip -d .claude/skills/handoff-boshu2 && rm skill.zipInstalls to .claude/skills/handoff-boshu2
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Write compact session handoffs. Triggers: "handoff", "write compact session handoffs.", "handoff skill".Key capabilities
- →Write factual session artifacts
- →Include caller-supplied goals and summaries
- →Record completed artifacts and exact evidence paths
- →Document unresolved facts or risks
- →Add optional caller-supplied continuation text
- →Provide best-effort read-only repository identity
How it works
The skill writes a factual session artifact that another context can read, including caller-supplied information and end-state facts.
Inputs & outputs
When to use handoff
- →Transfer work context to new session
- →Document completed coding tasks
- →Summarize findings for team review
About this skill
Handoff
A handoff works because the next context can act on exact paths and facts without trusting the author's memory; any line the reader cannot verify from the artifact itself is decoration, not handoff.
Write a factual session artifact that another context can read. Include:
- caller-supplied goal and summary;
- completed artifacts and exact evidence paths;
- unresolved facts or risks;
- optional caller-supplied continuation text;
- best-effort read-only repository identity when useful.
Do not infer a next action, select work, assign ownership, consume the artifact, change tracker or Git state, classify a verdict, govern retries, or restart a runtime. Reading a handoff must not mutate it.
Named failure mode — optimistic closure: writing "done" for work whose evidence path does not exist, so the next context builds on a phantom.
Anti-pattern: narrating the session chronologically ("first I tried…, then…"). Corrective: record end-state facts — artifacts, paths, unresolved risks — and drop the journey.
The ao session handoff and ao session rehydrate commands implement the same boundary for JSON artifacts. The skill may write Markdown when that better serves a human, but the content semantics remain identical.
Return the artifact path and stop.
When not to use it
- →When a next action needs to be inferred
- →When work needs to be selected or ownership assigned
- →When the artifact needs to be consumed or Git state changed
Limitations
- →Cannot infer a next action
- →Cannot select work or assign ownership
- →Cannot consume the artifact or change tracker/Git state
How it compares
This workflow focuses on recording end-state facts and evidence paths, rather than narrating a chronological session journey.
Compared to similar skills
handoff side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| handoff (this skill) | 0 | 15d | Review | Beginner |
| ml-paper-writing | 48 | 5mo | Review | Advanced |
| docs-review | 10 | 7mo | No flags | Beginner |
| claude-md-improver | 21 | 6mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
ml-paper-writing
davila7
Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, reviewer guidelines, and citation verification workflows.
docs-review
metabase
Review documentation changes for compliance with the Metabase writing style guide. Use when reviewing pull requests, files, or diffs containing documentation markdown files.
claude-md-improver
anthropics
Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".
markdown-to-html
github
Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.
write-docs
tldraw
Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.
marker
benchflow-ai
Convert PDF documents to Markdown using marker_single. Use when Claude needs to extract text content from PDFs while preserving LaTeX formulas, equations, and document structure. Ideal for academic papers and technical documents containing mathematical notation.