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
Install
npx skills add sidneyswift/skills --skill handoff-specgit clone --depth 1 https://github.com/sidneyswift/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/handoff-spec ~/.claude/skills/handoff-specPersonal 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.
Details
- Skill name
handoff-spec- Repository
- sidneyswift/skills
- 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
9sidneyswift/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?
Design Visual Experiences
9sidneyswift/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.
Ecosystem Mapping
9sidneyswift/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.
Humanizer Kill Gpt
9kargnas/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).
Graph Max
9sidneyswift/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?
Industrial Waste Heat Recovery
5dungnotnull/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".
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.