dot_claude/skills/handoff/SKILL.md
Use when generating or updating a handoff document to transition the session to another agent or TUI. DO NOT trigger when the user says "read the handoff", "load the handoff", or "here's the handoff"—handle those as plain file reads.
npx skillsauth add nijaru/dotfiles handoffInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| User said | Action |
| :--------------------------------------------------- | :----------------------------------------------------------------------- |
| "read/load/open the handoff" or "here's the handoff" | Read ./handoff.md, summarize it, and stop. Do NOT generate. |
| "update the handoff" | Read ./handoff.md first, then update it in place. |
| /handoff invoked or "make/write/create a handoff" | Generate or overwrite ./handoff.md. Proceed below. |
| Ambiguous | Default to generating. If the user wanted to read it, they would say so. |
Gather context: run tk ls, git log --oneline -20, note any active jb jobs.
Write ./handoff.md — this is the primary deliverable. If context runs out mid-way, the next agent still has a usable doc:
handoff.md is a temporary baton—not a permanent artifact. Do NOT commit it unless explicitly asked.
| Mistake | Correction |
| :---------------------------------------------- | :-------------------------------------------------- |
| Generating a new handoff when asked to read one | Read the file; do not regenerate |
| Committing handoff.md | Ephemeral by design—only commit if explicitly asked |
development
Use after completing a bug fix, feature, refactor, or tk task when the first implementation taught enough context to replace it with a simpler, cleaner, or more coherent version before finalizing.
development
Use when writing, migrating, or reviewing Zig code across recent stable versions (0.14-0.16), especially to correct stale syntax or stdlib, build.zig, allocator, formatting, or runtime API knowledge.
documentation
Use when reviewing or revising text (prose, docs, commits) to remove AI patterns and improve voice/clarity.
content-media
Use when fetching X/Twitter post content by URL, or searching for recent X posts.