Handoff Spec

Produces a single markdown handoff document for a stateless successor agent (possibly on a different platform or session) to pick up in-progress work with zero conversation context. Combines a stable Goal/Spec section with a point-in-time Handoff Status section covering what's done, out-of-scope work, remaining required work, nice-to-haves, what's live in production, what's merged but not deployed, and what's still in progress. Use when the current agent is running low on usage credits, context, or tokens; when the user says things like "I'm running out of credits/usage", "we need to hand this

9 stars 1 forksAI, LLMs & Agents

Install

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

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 Spec

## Overview

Produces a handoff document that lets a completely stateless successor agent resume in-progress work — it has never seen this conversation, but can read the repo, git history, PRs, and issues.

## Process

1. **Verify current state — don't rely on conversation memory.** Your own recollection of "what I did" can be stale or wrong compared to what's actually on disk or in the tracker. Before writing anything, check the real state:
   - `git status` and `git log --oneline -20`
   - `git diff <base-branch>...HEAD` (or against the last handoff commit, if one exists)
   - `gh pr list --state all --limit 20`, and `gh pr view <n>` for anything relevant
   - `gh issue list` for open issues tied to this work
   - If deploy/production status isn't derivable from the repo (e.g. no CI/CD visible), ask the user rather than guessing.

2. **Decide finished vs. not finished, first.** If there is no required in-scope work remaining, the very top line of the document must say `FINISHED — no in-scope work remains`. Never bury a "we're actually done" under status sections that read as if more work is needed.

3. **Check for a prior handoff doc for this same task.** If one exists (e.g. `HANDOFF-*.md` in the repo, or the user points to one), reuse its **Goal / Spec** section verbatim — that section is the stable north star and should not drift between handoffs. Only the **Handoff Status** section gets rewritten each time.
Read the full skill on GitHub

Details

Skill name
handoff-spec
Path
handoff-spec/SKILL.md
Repo updated
9 November 2026

FAQ

What does the Handoff Spec skill do?

Produces a single markdown handoff document for a stateless successor agent (possibly on a different platform or session) to pick up in-progress work with zero conversation context. Combines a stable Goal/Spec section with a point-in-time Handoff Status section covering what's done, out-of-scope work, remaining required work, nice-to-haves, what's live in production, what's merged but not deployed, and what's still in progress. Use when the current agent is running low on usage credits, context, or tokens; when the user says things like "I'm running out of credits/usage", "we need to hand this

How do I install the Handoff Spec skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sidneyswift/skills --skill handoff-spec. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Handoff Spec popular?

It lives in sidneyswift/skills, which has 9 GitHub stars and 1 forks.

Related skills

Design Inspiration

9

sidneyswift/skills

Break through design blocks by systematically mining curated inspiration sources. When you're stuck on UI, brand, layout, or visual direction, this skill walks you through nine high-signal design galleries — each covering a different design surface — to find patterns, steal structure, and restart your creative momentum. Use when someone is stuck, needs visual references, wants to explore design directions, or asks "what should this look like?

Frontend & Design

Design Visual Experiences

9

sidneyswift/skills

Create or refine original digital visual experiences where art direction, motion, interaction, or spatial behavior is central. Use for expressive interfaces, interactive explainers, creative coding, and visual films; translate relevant references into implementation decisions and inspect the delivered result.

Writing & Content

Ecosystem Mapping

9

sidneyswift/skills

Take a core solution or transformation and map every friction point around it into a compounding product ecosystem — instead of building standalone products. Walks the user through identifying their core transformation, mapping friction points (before, during, after), spotting two-sided market opportunities, and designing products that strengthen each other. Use when someone has a working solution but is stuck on "what's next," wants to expand beyond a single product, or is thinking about leverage and ecosystem strategy.

Other

Humanizer Kill Gpt

9

kargnas/skills

Runs a cross-language cleanup for writing tells shared by large frontier LLMs, not only GPT: English source constructs that survive other language translation and language-surface translationese. Use only when the user asks to remove AI/GPT tells from text (de-GPT, GPT 티, AI 티, 번역체 GPT, 자폐 말투 — colloquial shorthand for rigid or over-complete model prose, not a claim about autism).

AI, LLMs & Agents

Graph Max

9

sidneyswift/skills

Turn any hand-drawn workflow graph into a working multi-agent script. Draw the graph in any tool (whiteboard, paper, Excalidraw, napkin), photograph or screenshot it, send it to a coding agent with a single prompt, and get a running orchestration script back. The skill teaches graph literacy — how to draw nodes, edges, fan-outs, feedback loops, and decision gates so the coding agent can implement them faithfully. Use when someone has a workflow in their head but no code, wants to orchestrate multiple agents, or asks "how do I wire these steps together?

AI, LLMs & Agents

Industrial Waste Heat Recovery

5

dungnotnull/industrial-waste-heat-recovery-agent-skill

Industrial Waste-Heat Recovery System Design — Production-grade evidence-backed analysis harness with flexible agent architecture, skill registry, and modular sub-agents. Use for: waste-heat recovery design, heat exchanger selection, ORC systems, pinch analysis, energy efficiency assessment, industrial thermal system optimization. Triggers on: "waste heat", "heat recovery", "ORC", "pinch analysis", "heat exchanger", "energy efficiency", "thermal optimization", "industrial heat", "steam system", "condensate recovery".

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.