{"slug":"create-handoff-2","title":"create-handoff","summary":"Write a handoff file at .turbo/handoff/-.md capturing current session state — task, status, open decisions, in-flight changes, next step — so a fresh session can continue without re-deriving context. Use when the user asks to \"create a handoff\", \"create handoff\"","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-23T08:58:51.441581Z","repo":{"url":"https://github.com/tobihagemann/turbo","stars":403,"forks":31,"license":"MIT","updatedAt":"2026-09-24T14:46:11Z"},"bodyHtml":"
\n

name: create-handoff\ndescription: \"Write a handoff file at .turbo/handoff/

\n

Create Handoff

\n

Write a session handoff file at .turbo/handoff/<YYYY-MM-DD>-<slug>.md so a fresh session can pick up where this one left off.

\n

Step 1: Resolve the Target Path

\n

Get today's date: date +%Y-%m-%d.

\n

Pick a slug for the current task:

\n\n

If the work is anchored to an existing plan at .turbo/plans/<slug>.md, reuse that plan's slug verbatim.

\n

The user may pass an explicit slug or output path; honor it.

\n

The target path is .turbo/handoff/<YYYY-MM-DD>-<slug>.md. A generated slug takes -2, -3, and so on until the path is free. When the user supplied the slug or path and it already exists, use request_user_input to offer overwrite, a numeric suffix, or a different slug.

\n

When an open decision will outlive the rest of the session's state, still unresolved while the work around it is finished, give it its own handoff. Everything else stays in a single file. Slug the split handoff for that decision rather than appending a collision suffix, and write it to stand alone.

\n

State the chosen path before continuing.

\n

Step 2: Gather Session State

\n

Run git status --short to see uncommitted changes in the working tree.

\n

Survey the conversation context for:

\n\n

Read .turbo/improvements.md if it exists and note any entry this handoff takes over. When no entry clearly matches, leave the backlog alone.

\n

When something is genuinely unclear and would leave a gap in the handoff, use request_user_input to resolve it. Default to inferring quietly when the conversation makes the answer clear.

\n

Step 3: Write the Handoff File

\n

Create .turbo/handoff/ if it does not exist. Write the file at the path picked in Step 1.

\n

Lead with # Handoff: <Task Title>. Cover the items gathered in Step 2 in whatever structure fits the session — drafting, refining, implementing, and investigating sessions each have different shapes and don't all map to the same headings. Close with a clear statement of the next concrete action so the new session knows exactly what to do first.

\n

Keep it dense. Omit anything that has no real content.

\n

When this handoff splits an open decision out of an existing one, add a line to that existing handoff pointing at the new path, and remove the content the new file now carries.

\n

Step 4: Confirm

\n

Once the handoff file exists, delete any .turbo/improvements.md entry it takes over, as noted in Step 2. Delete the file if no entries remain.

\n

Tell the user where the handoff was written, name any backlog entry deleted and any existing handoff edited to point at a split, and quote the next-step statement so the path forward is visible at a glance.

\n

Then call update_plan to mark this step completed and continue with the next step of the active workflow.

\n","files":[{"path":"SKILL.md","sizeBytes":4735,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-25T07:39:34.361118Z","sha256":"E6307555F7B24B7F2B1C3B54F59AEC5CE444932D1B8DBC696AF1EBF058362E92","sizeBytes":2227},"review":null,"source":{"repositoryUrl":"https://github.com/tobihagemann/turbo","path":"codex/skills/create-handoff","license":"MIT","commit":"733e9833b3f2bbd29c5811a5eeb22ff358ec2b78","subtreeSha":"AA60F0F2E76891021FEC5CE9D4739448326E061668E8C03EBB600E0BE56D2C67","lastSyncedAt":"2026-09-25T07:38:01.358394Z"},"reviewedAt":"2026-09-25T07:42:24.490763Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/tobihagemann/turbo/tree/main/codex/skills/create-handoff"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install tobihagemann-turbo@llmmart"},{"target":"git","command":"git clone https://github.com/tobihagemann/turbo.git"}]}