pickup

Restore session context from a HANDOFF.md file with project details and git history.

2|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/HermeticOrmus/claude-code-skills --skill pickup-hermeticormus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pickup
Source: https://github.com/HermeticOrmus/claude-code-skills/tree/main/pickup
Command: npx skills add https://github.com/HermeticOrmus/claude-code-skills --skill pickup-hermeticormus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows you to seamlessly resume your work by restoring the exact context of a previous session, eliminating the need to re-orient yourself.

Core Features & Use Cases

  • Context Restoration: Loads project path, branch, last commit, and task summary from a HANDOFF.md file.
  • Key File Loading: Reads important files (under 200 lines) to provide immediate context.
  • Git Orientation: Shows current git status and recent commit history.
  • Use Case: After a long break or switching machines, use /pickup my-project to instantly get back to where you were on the my-project codebase.

Quick Start

Use the pickup skill to restore the session context from the HANDOFF.md file in the current directory.

Frequently Asked Questions about pickup

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

FAQPage Schema
How do I resume a git session and restore context after switching branches?

To resume a git session, the skill parses a HANDOFF.md file to restore context by loading project paths, branch names, commit history, and task summaries. This provides immediate orientation without manual re-reading.

What is the best way to handoff development work to another machine?

The best way to handoff development work is using a HANDOFF.md file. The skill locates this file via direct path, project name search, or directory checks, reads key files under 200 lines, and archives it upon loading.

How do I load key project files automatically when resuming work?

You can load key project files automatically by running the pickup skill, which reads important files under 200 lines specified in the HANDOFF.md file to provide immediate context for your development session.

Can I find my HANDOFF.md file using a project name search?

Yes, you can find your HANDOFF.md file using a project name search. The skill supports locating the file via direct path, project name search, or by checking the current and home directories automatically.

Does the pickup skill show git status and recent commit history?

Yes, the pickup skill shows git status and recent commit history. It provides git orientation by parsing the branch and commit history from the HANDOFF.md file to help you seamlessly continue development work.

What happens to the HANDOFF.md file after session context is restored?

After session context is successfully restored, the HANDOFF.md file is archived by the skill. This ensures your previous workflow details, task summaries, and key file contexts are cleanly preserved after loading.