Get the FREE Ultimate OpenClaw Setup Guide →

unpark

npx machina-cli add skill technicalpickles/pickled-claude-plugins/unpark --openclaw
Files (1)
SKILL.md
1.7 KB

Unpark

Resume work from a parked handoff document.

Process

1. Find Handoff

Check parking locations in order:

  1. Project CLAUDE.md## Handoffs or ## ParkingLocation:
  2. User ~/.claude/CLAUDE.md → same lookup
  3. 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

  1. Step 1: Find Handoff in CLAUDE.md, ~/.claude/CLAUDE.md, or .parkinglot.
  2. Step 2: Read and present a concise summary including topic, date, branch, and current state.
  3. 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.

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers