agentsclimarketplace

Session handoff

Skill notque/vexjoy-agent/skills/process/session-handoff

VexJoy AI Agent with Intelligent Routing - /do routes plain-English requests to the right specialist agent and gates the work with reviews, tests, and a learning loop.

Install
npx -y skills add notque/vexjoy-agent --skill session-handoff

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Package session state for the next agent, or rehydrate it at start.

SKILL.md

3.6 KB, as published. Nobody here has run it

Session Handoff

Two modes sharing one state contract. HANDOFF packages current work so the next agent (or future session) resumes without re-discovery. PICKUP rehydrates from that package at session start. Pick the mode from intent: ending or pausing work = HANDOFF; starting on existing work = PICKUP.

Mode: HANDOFF

Produce a concise bullet package with these sections, in order. Every claim comes from a command you ran this session — re-run when stale, because a wrong handoff costs more than no handoff.

  1. Scope/status — the task in one line, finished vs. remaining work, blockers.
  2. Working tree — git status -sb summary; note local commits not yet pushed and whether you are in a worktree (pwd contains .claude/worktrees/).
  3. Branch/PR — current branch, PR number/URL, CI status (gh pr checks <num> when a PR exists).
  4. Live processes — long-running jobs the next agent must know about: summarize ps auxww | grep -E '<your-process>', plus a copy-paste attach or log-tail command (tail -f <logfile>, jobs -l). Redact secrets in command lines.
  5. Tests/checks — which commands ran, results, what still needs to run.
  6. Next steps — remaining actions in execution order, most urgent first.
  7. Risks/gotchas — flaky tests, feature flags, brittle areas, approvals still needed.

Gate: every live process has a copy-paste command; every pending step is ordered. Output format: bullet list, Dense-Complete — short enough to paste into a PR comment or session note.

Mode: PICKUP

Rehydrate in this order, then act.

  1. Read the handoff — the prior package, plus repo CLAUDE.md and any docs it names.
  2. Repo state — git status -sb; confirm branch, local commits, worktree path.
  3. CI/PR — gh pr view <num> --comments (derive the PR from the branch when unnumbered); note failing checks.
  4. Processes — check for live jobs named in the handoff; attach or tail logs using its commands.
  5. Tests/checks — note what last ran; decide what you will run first.
  6. Plan — write the next 2–3 actions as bullets, then execute them.

Gate: branch, PR state, and first action are confirmed before any edit. Report discrepancies between the handoff and observed state; observed state wins.

Constraints

  • State only what you verified; mark inherited claims as "per handoff, unverified."
  • In worktrees, follow worktree rules (skills/meta/do/references/worktree-rules.md): verify CWD, feature branch first.
  • Keep secrets out of the package: redact tokens and credential paths as <redacted>.

Error handling

Handoff references a process that is gone

Cause: job exited between sessions. Solution: check its log file for exit status, record the finding, drop the attach step.

Branch in handoff differs from checked-out branch

Cause: another agent or the user moved the worktree. Solution: report the difference and proceed from observed state.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.