handofflisted

Publish a deliberate, structured Handoff document for the current objective into the active notepad and force a git push so it syncs across machines. Use when wrapping a session, handing to a teammate or fresh agent, hitting a milestone, or asked to "create a handoff", "write a handoff", "checkpoint for next session", "hand this off". Writes to <notepad>/handoffs/<date>-<topic>.md (NOT a temp dir), redacts secrets, references artifacts by path/URL, suggests next skills. In agent-notepad this is the on-demand Handoff tier — distinct from the continuous Notes tier (NOTES.md + journal). WARNING - 'hooks keep it fresh' holds ONLY on the compaction path, where pre-compact.sh writes a delimited pc-floor block into NOTES.md. On /clear nothing does, because PreCompact never fires - so NOTES.md is whatever the agent last wrote, and it MUST be refreshed in the same commit as the handoff.
OneDro1d/dark-factory · ★ 0 · AI & Automation · score 70

Install: claude install-skill OneDro1d/dark-factory

# handoff — publish a deliberate Handoff doc into the notepad ## Notes vs Handoff — the terminology split (read first) agent-notepad keeps working memory in **two tiers**, and this skill owns only the second: - **Notes** — the *continuous* tier. `NOTES.md` (compact, rewritten in place) plus the append-only journal (`sessions/<ISO8601>_<id>.jsonl`). Kept fresh **automatically** by the Stop / PreCompact / UserPromptSubmit hooks and auto-loaded every SessionStart. You do **not** invoke a skill for Notes — they just accrue. - **Handoff** — the *deliberate* tier. A single **structured document** you publish on demand at a meaningful boundary (milestone, teammate hand-off, end of a work block). This is what `/handoff` produces. A Handoff **summarizes** the current Notes into a durable, shareable artifact; it does **not** replace them. Notes are the stream; a Handoff is a snapshot you deliberately cut and push. When in doubt: routine progress → let the Notes hooks capture it; a real checkpoint someone else (or a fresh you) will read cold → publish a Handoff. ## What this does 1. Resolves the active **notepad** (nearest ancestor of cwd with `NOTES.md`). 2. Writes the structured handoff to **`<notepad>/handoffs/<date>-<topic>.md`** — inside the notepad, **never** the OS temp dir — so it is versioned and syncs. 3. **Redacts secrets** (API keys, tokens, bearer/JWT, private keys, `password=`…). 4. **References artifacts by path or URL** (PRDs, plans, ADRs, commits, dif