afk-pickup - SKILL.md Agent Skill

name: afk-pickup description: Find and resume from a handoff document saved in the user's OS temporary directory. Use when a previous session wrote a disposable handoff note, the user mentions pickup/resume/handoff from temp, or the user passes a handoff path/topic. argument-hint: "Optional handoff path, repo name, topic, or 'latest'" metadata: short-description: Find and resume from temp-directory handoff notes.

Find a handoff document from a previous session and use it to resume the work.

If the user passed a path, check it directly first. Also check the same basename under /tmp, /private/tmp, and $TMPDIR.
If there is no path or the direct path is missing, run scripts/find-temp-handoffs.sh from this skill folder, passing the user's repo name, topic, or latest text if present.
Read the best match only after confirming it is plausible for the current repo/topic. Prefer files that mention the current repo, workspace path, branch, validation state, next steps, or "handoff".
If there are multiple plausible matches, show the top few paths and ask which one to use.

Search /tmp before broad user folders. On macOS, $TMPDIR and /tmp are different locations, and /tmp is usually a symlink to /private/tmp.
Do not drift into ~/Downloads, Desktop, or the whole home directory unless the user explicitly says the handoff may be there.
Do not hand-roll complex find expressions with ungrouped -o; use the bundled script or direct ls/test -f checks for exact paths.

Treat temp handoffs as disposable and possibly stale. Do not move, rewrite, or delete them unless asked.