unpark
npx machina-cli add skill technicalpickles/pickled-claude-plugins/unpark --openclawUnpark
Resume work from a parked handoff document.
Process
1. Find Handoff
Check parking locations in order:
- Project
CLAUDE.md→## Handoffsor## Parking→Location: - User
~/.claude/CLAUDE.md→ same lookup - Default:
.parkinglot/in project root
If multiple handoffs exist, list them and ask which to resume:
Found parked sessions:
(A) jwt-authentication.md - Parked 2026-01-30
(B) fix-login-bug.md - Parked 2026-01-29
(C) Other location
2. Read and Present
Read the handoff document and present a summary:
Resuming: [Topic]
Parked: [Date]
Branch: [branch]
Current state: [Brief summary]
Next steps:
1. [Step 1]
2. [Step 2]
3. Validate
Check that the handoff is still valid:
- Git branch matches (or can be checked out)
- Worktree exists (if specified)
- Key files still exist
- Decisions still seem relevant
4. Handle Validation Results
If valid:
Validation passed. Ready to continue with: [first next step]
Proceed?
(A) Yes, continue
(B) Review the full handoff first
(C) Adjust the plan
If stale or invalid:
Validation found issues:
- [Issue 1]
- [Issue 2]
Options:
(A) Update handoff and try again - I'll revise based on current state
(B) Start fresh - discard this handoff
(C) Continue anyway - I understand the context has changed
If option A: Update the handoff file with current findings, then recommend running /unpark again.
Edge Cases
- Branch doesn't exist: Offer to create it or pick a different branch
- Files deleted: Note in validation, may still be able to continue
- Handoff is very old: Extra scrutiny on decisions, they may need revisiting
Source
git clone https://github.com/technicalpickles/pickled-claude-plugins/blob/main/plugins/agent-meta/skills/unpark/SKILL.mdView on GitHub Overview
Unpark resumes work paused by a parked handoff. It locates parked sessions across project handoffs, user CLAUDE files, or the default parking folder, then presents a concise summary and validates the handoff before continuing.
How This Skill Works
Unpark searches parked handoffs in order: project CLAUDE.md, ~/.claude/CLAUDE.md, and the default .parkinglot. If multiple handoffs exist, it lists them and asks which to resume. It then reads the handoff, presents a concise summary with topic, date, branch, current state, and next steps, and validates the handoff by checking the Git branch, worktree, key files, and decision relevance, offering options to continue, review, adjust, or update.
When to Use It
- You need to resume work paused by a parked handoff in a project.
- Multiple parked handoffs exist and you must choose which to resume.
- The handoff seems outdated or invalid and requires validation.
- You want to verify the required Git branch, worktree, and key files before continuing.
- You need to update the handoff with current findings and run /unpark again.
Quick Start
- Step 1: Find Handoff in CLAUDE.md, ~/.claude/CLAUDE.md, or .parkinglot.
- Step 2: Read and present a concise summary including topic, date, branch, and current state.
- Step 3: Validate and decide to continue, review, adjust, or update (then run /unpark again if needed).
Best Practices
- Search parking locations in the defined order to locate handoffs.
- If multiple handoffs are found, list them clearly and confirm which to resume.
- Read the handoff and note the topic, date, branch, and current state before acting.
- Validate the handoff by checking branch existence, worktree presence, key files, and relevance of decisions.
- If issues are found, update the handoff and re-run /unpark instead of proceeding.
Example Use Cases
- Resuming jwt-authentication.md parked 2026-01-30; Branch: main; Current state: add JWT middleware; Next steps: implement middleware, write tests.
- Resuming fix-login-bug.md parked 2026-01-29; Branch: bugfix/login; Current state: reproduce issue; Next steps: craft regression test and fix.
- Handoff found at ~/.claude/CLAUDE.md; Current state: document architecture notes; Next steps: convert notes into actionable tasks.
- Handoff is stale: validation shows outdated decisions; update handoff with current findings and re-run /unpark.
- Edge case: Branch doesn't exist; offer to create it or pick a different branch.