handoff-pickup

Lists, selects, and summarizes Markdown handoff artifacts stored per git branch.

2|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/nseng-ai/ns --skill handoff-pickup-nseng-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff-pickup
Source: https://github.com/nseng-ai/ns/tree/main/skills/incubating/handoff/handoff-pickup
Command: npx skills add https://github.com/nseng-ai/ns --skill handoff-pickup-nseng-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Resuming work across sessions or branches often means losing context about what was done, why, and what comes next. This Skill locates stored handoff artifacts, resolves which one you mean, and presents a concise summary so you can decide how to proceed before any work continues. ## Core Features & Use Cases - Handoff Discovery: List handoffs for the current branch, a named branch, all local branches, or even deleted branches for recovery and cleanup. - Deterministic Selection: Resolve a selector (exact key, slug, or free-text words) through a defined selection ladder, surfacing ambiguous matches as choices instead of guessing. - Guided Resume: Present the handoff's branch, slug, continuation focus, proposed next steps, risks, and source session references, then wait for explicit user direction. - Use Case: You return to a feature branch after a week and say "pick up handoff". The Skill lists available handoffs, reads the selected artifact, summarizes where work left off, and asks how you want to proceed. ## Quick Start Ask the agent to pick up the handoff for your current branch and summarize where the previous session left off.

Frequently Asked Questions about handoff-pickup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resume work from a previous session handoff?

Say "pick up handoff" or "resume handoff" and the Skill lists handoffs for your current git branch, reads the selected artifact, and presents a summary of the continuation focus and proposed next steps. It then waits for your explicit instruction before doing any work.

How do I list handoffs across all git branches?

The Skill runs ns handoff list --all --format json to show handoffs grouped by branch, including branch state. Adding --include-deleted also surfaces handoffs on deleted local branches, which is useful for recovery or cleanup.

What happens when a handoff selector matches multiple artifacts?

The selection ladder resolves selectors in order: exact key, slug, sole handoff in scope, then term matching. If the result is ambiguous, the Skill prints the matching branches and slugs and asks you to choose rather than guessing.

Can I pick up a handoff from a deleted branch?

Yes. Listing with --include-deleted includes handoffs whose local branches were deleted, and you can select them by slug. These entries are flagged as deleted since they may be cleanup or recovery candidates.

Does picking up a handoff automatically continue the work?

No. After presenting the summary, including risks, stale assumptions, and proposed next steps, the Skill stops and asks how you would like to proceed. It does not run commands, edit files, or verify the repository unless you explicitly ask.