Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

handoff

/handoff

Zapisuje plik kontynuacji sesji w .handoff przed kompaktowaniem kontekstu lub zakończeniem pracy, by następna sesja wczytała go sama.

Repozytorium
line-harness ↗
Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Zapisuje plik kontynuacji sesji w .handoff przed kompaktowaniem kontekstu lub zakończeniem pracy, by następna sesja wczytała go sama.

Wyzwalacze z opisu

pack upwrap upsave statecompact protocolsave creditsgoing to sleepbefore /compact
Oryginalny opis (EN)

Write a session-continuation handoff file at .handoff/handoff-<DD-mon-YYYY>-<HHMM>.md before context compact, session close, or end-of-work. The SessionStart hook auto-loads the newest one so the next session resumes without re-reading the whole transcript. Auto-triggers on slash commands /handoff, /clear, /pack, /save, or natural phrases like 'pack up', 'wrap up', 'save state', 'compact protocol', 'save credits', 'going to sleep', 'before /compact'.

Jak działa

  1. How to write one
  2. When to refuse / negotiate
  3. Things to NOT put in a handoff
  4. Verification before saying done
  5. Why this exists
Sekcje z nagłówków SKILL.md, w oryginale · 93 linii, 573 słów
Podgląd SKILL.md
---
name: handoff
description: "Write a session-continuation handoff file at .handoff/handoff-<DD-mon-YYYY>-<HHMM>.md before context compact, session close, or end-of-work. The SessionStart hook auto-loads the newest one so the next session resumes without re-reading the whole transcript. Auto-triggers on slash commands /handoff, /clear, /pack, /save, or natural phrases like 'pack up', 'wrap up', 'save state', 'compact protocol', 'save credits', 'going to sleep', 'before /compact'."
verified: 2026-08
layer: utility
category: workflow
triggers: ["/handoff", "/clear", "/pack", "/pack-up", "/save", "/save-state", "/wrap", "/wrap-up", "/sleep", "pack up", "pack this up", "wrap up", "wrap this up", "save state", "save the state", "handoff", "make a handoff", "compact protocol", "before compact", "before /compact", "before quitting", "save credits", "save tokens", "going to sleep", "imma sleep", "i'm going to sleep", "end of session", "session end", "close session"]
---

# Handoff — write a session-continuation file

When the user signals end-of-session (any trigger above) OR you notice the
conversation is about to compact (long context, near a known compact point),
write `.handoff/handoff-<DD-mon-YYYY>-<HHMM>.md` at the repo root **before**
anything else happens.

This file is auto-loaded by `.claude/hooks/handoff-load.sh` on the next session
start, so the next agent (Claude or codex) resumes from your **Next step**
without re-reading the whole transcript.

## How to write one

1. **Get the timestamp**: run `date "+%-d-%b-%Y-%H%M" | tr '[:upper:]' '[:lower:]'`
   → use that as the filename suffix. Example: `handoff-14-may-2026-2308.md`.

2. **Make sure the dir exists**: `mkdir -p .handoff` (it's gitignored — purely
   local working state, never committed).

3. **Write the file** using the **Write** tool. The file MUST contain these
   six sections in this order:

   ```markdown
   # Handoff — <YYYY-MM-DD HH:MM Day>

   ## What we're building
   <one paragraph naming the overall target of the work>

   ## Current state
   <one paragraph: what's done / deployed / pushed / running locally>

   ## Files in flight
   <bullet list of uncommitted edits with a short note each — run
    `git status --short` to populate>

   ## What changed this session
   <bullet list of commits made + significant edits, oldest-first.
    Run `git log @{u}..HEAD --oneline` or pick a sensible cutoff>

   ## What failed and why
   <bullet list of things attempted that didn't work, with root cause.
    Stops future-you from repeating the same trap>

   ## Next step
   <ONE concrete action the next session should try first. Not a list.
    The single thing>
   ```

   Optional: a final `## Open questions` section for things the user asked
   that aren't blocking.

4. **Confirm to the user** in one short sentence — e.g. *"Handoff at
   .handoff/handoff-14-may-2026-2308.md — next session auto-resumes from
   the Next step."* Don't print the file contents back; the user wrote
   them with you and reading it on disk if they want is faster.

## When to refuse / negotiate

- **If the user signals a different intent** — e.g. they said "pack up" but
  meant something else — ask before writing. The skill should err toward
  acting, but a 5-second confirmation is fine if it's ambiguous.
- **Don't double-write**: if you wrote a handoff earlier in the same session
  and nothing significant has changed, update the existing file's content
  via Edit rather than creating another timestamp.
- **Don't write trivially small handoffs**: if the session did nothing
  load-bearing, just say so to the user instead of creating noise.

## Things to NOT put in a handoff

- Secrets — `.handoff/` is gitignored but rsync / backup tools may still pull
  it; treat as low-trust storage.
- Raw command output, full file dumps — reference by `path:line` instead.
- The entire conversation transcript — just the load-bearing decisions and
  the things that broke.
- > 200 lines total — that's a session log, not a handoff. Compress.

## Verification before saying done

After Writing:
- `ls -la .handoff/` to confirm the file exists
- Confirm it's gitignored: `git check-ignore .handoff/handoff-*.md`
  should print the path (file is ignored) — if it prints nothing, the
  `.gitignore` entry is broken and you need to fix it.

## Why this exists

Context resets (compact, new session, agent quit) lose state. Re-reading a
1000-message transcript to recover is expensive in tokens AND time. The
handoff is a 100-line summary that costs ~2k tokens to load and replaces
the whole "where were we?" exchange. See `CLAUDE.md` → "Handoff Protocol"
for the full spec.
Pliki w paczce (2)
  • SKILL.md 5 KB
  • agents/openai.yaml 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · LineLuLan/line-harness100MIT
lumpen-mya/claude-handoff100MIT
generous-corp/pulp100MIT
Ovid/paad100MIT
Ovid/paad100MIT
Ovid/paad100MIT
webdevnerdstuff/claude-marketplace100MIT
terencebristol/terencebristol-toolkit100MIT
verkyyi/claude-fleet100MIT

Migawka bazy z 13.11.2026 · wersja paczki 9d5d1789debc (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90m-handoff
    Zapisuje lub przywraca stan pracy w pliku przekazania przed kompaktowaniem, zmianą modelu lub końcem sesji.
  • 100m0-handoff
    Zapisuje lub odczytuje compact_checkpoint przed kompaktowaniem i na koniec sesji, żeby zimny start zamienił się w kontynuację także w Cursorze lub Claude Code.
  • 95Qcompact
    Zapisuje stan pracy i przekazuje sesję do dalszej pracy, zachowując kontekst przed zakończeniem.
  • 100session-handoff
    Zapisuje stan pracy w pliku STATUS.md przed wyczyszczeniem kontekstu, przy dowolnym rodzaju pracy: budowie, badaniu lub harmonogramie.
  • 100context-handoff
    Zachowuje kontekst przy kompaktowaniu i przywraca stan sesji z pliku HANDOFF.md, także automatycznie po poleceniach compact lub clear.
  • 100session-save
    Zapisuje plik kontynuacji przed zakończeniem lub przy małym kontekście, by później wznowić pracę bez utraty wątku.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.