Handoff

Use when PAUSING/ending a work session (records the current state in docs/STATE.md to resume later) or when RESUMING (reads docs/STATE.md and the active spec and reassembles the context, proposing the next step). Keeps continuity between sessions of humans and agents. Trigger with /handoff.

100 stars 27 forksWriting & Content

Install

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

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

From the SKILL.md

> **Translation note:** Originally authored in Portuguese (pt-BR) by Igor Uehara ([igoruehara/spec-driven](https://github.com/igoruehara/spec-driven), MIT). Translated to English by this hub to keep the repository language consistent. Original content unchanged in meaning; see the upstream repo for the pt-BR source.

# Skill: Session handoff (pause / resume)

Keeps project continuity via `docs/STATE.md` — the volatile working memory
(unlike an ADR, which is a durable decision). Detect the intent from the request or ask.

## PAUSE mode (pause / end)
Update `docs/STATE.md` with the actual state of this session:
1. **In progress / next step** — the active feature/spec and the **next concrete action**
   (specific: "implement AC-3 in adapter X", not "continue the feature").
2. **Recent decisions** — what was decided. If it is hard to reverse, **create/update the ADR**
   and link it; the STATE only summarizes.
3. **Blockers** — what is blocking and who/how unblocks it.
4. **Deferred ideas / todos** — what was left out on purpose, with the trigger to reconsider.
5. Mark the date and author. If there is an open `SPEC_DEVIATION`, record it as a blocker.
6. Offer a commit (`docs: handoff — update STATE`) if it is a git repository.

> Be concise and actionable. The STATE is for someone (or an agent) to resume cold tomorrow.

## RESUME mode (resume)
1. Read `docs/STATE.md` and the `spec.md`/`tasks.md` of the active feature mentioned in it.
Read the full skill on GitHub

Details

Skill name
handoff
Path
cursor-claude-codex/skills/igoruehara-spec-driven/skills/handoff/SKILL.md
License
MIT
Repo updated
2 November 2026

FAQ

What does the Handoff skill do?

Use when PAUSING/ending a work session (records the current state in docs/STATE.md to resume later) or when RESUMING (reads docs/STATE.md and the active spec and reassembles the context, proposing the next step). Keeps continuity between sessions of humans and agents. Trigger with /handoff.

How do I install the Handoff skill?

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

Is Handoff popular?

It lives in adriannoes/awesome-agentic-ai, which has 100 GitHub stars and 27 forks, and is included in 2 curated skill lists.

Related skills

Browserstack

100

adriannoes/awesome-agentic-ai

Run tests on BrowserStack. Use when user mentions "browserstack", "cross-browser", "cloud testing", "browser matrix", "test on safari", "test on firefox", or "browser compatibility".

Testing & QAIn 2 lists27

Coverage

100

adriannoes/awesome-agentic-ai

Analyze test coverage gaps. Use when user says "test coverage", "what's not tested", "coverage gaps", "missing tests", "coverage report", or "what needs testing".

Testing & QAIn 2 lists27

Fix

100

adriannoes/awesome-agentic-ai

Fix failing or flaky Playwright tests. Use when user says "fix test", "flaky test", "test failing", "debug test", "test broken", "test passes sometimes", or "intermittent failure".

Testing & QAIn 2 lists27

Infographic Outline Creator

100

adriannoes/awesome-agentic-ai

Create infographic outline creator operations. Auto-activating skill for Visual Content. Triggers on: infographic outline creator, infographic outline creator Part of the Visual Content skill category. Use when working with infographic outline creator functionality. Trigger with phrases like "infographic outline creator", "infographic creator", "infographic".

Writing & ContentIn 2 lists27

Graphviz Dot Generator

100

adriannoes/awesome-agentic-ai

Generate graphviz dot generator operations. Auto-activating skill for Visual Content. Triggers on: graphviz dot generator, graphviz dot generator Part of the Visual Content skill category. Use when working with graphviz dot generator functionality. Trigger with phrases like "graphviz dot generator", "graphviz generator", "graphviz".

Writing & ContentIn 2 lists27

Interview Style Doc Building

100

adriannoes/awesome-agentic-ai

Use when David wants to build a structured strategic document by answering questions (life priorities, goals docs, framework files, ranked lists, principles, reviews). Interview one question at a time, patch the file after each answer, then re-ask. Not for day planning (use day-plan).

Writing & ContentIn 2 lists27

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