vunm-io/passdown / plugins/passdown/skills/passdown-pickup
passdown-pickup
VerifiedUse when starting or resuming work in a workspace that keeps passdown handoff logs — reads the latest handoff and plan state, verifies them against the working tree, and briefs the session so work resumes from files instead of a replayed transcript
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.3 KB |
SKILL.md
View on GitHub---
name: passdown-pickup
description: Use when starting or resuming work in a workspace that keeps passdown handoff logs — reads the latest handoff and plan state, verifies them against the working tree, and briefs the session so work resumes from files instead of a replayed transcript
---
# Passdown Pickup
Start of shift: read the previous passdown before touching anything. The
handoff wrote state into small files; pickup turns those files back into
working context for a fraction of what replaying a transcript costs.
## Configuration (read first)
Build the effective passdown configuration root-to-nearest. Read applicable
`AGENTS.md` files from the workspace/repository root down to the current
directory, plus any parent file explicitly referenced by a thin entrypoint.
Merge `## passdown` keys in that order: nearer values override the same key and
inherit omitted keys. Resolve relative paths against the file that declared
them.
The effective configuration should contain:
```markdown
## passdown
- log_dir: <path for session logs>
- planning: markdown | openspec # used to locate plan state
- plan_dir: <path for markdown plans> # when planning: markdown
```
If `log_dir` is still missing, ask where session logs live and suggest adding
it to the appropriate `AGENTS.md`.
## Process
1. **Locate the handoff**: list `<log_dir>` and sort by the filename's date
and `HHMMSS` suffix, newest first. Read the newest log's frontmatter
(`status`, `branch`, `agent`, `plan`); also read the frontmatter of any
other recent logs, in case another agent worked in parallel. Frontmatter
first, full text only for the logs that matter — that is what keeps pickup
cheap.
2. **Read the passdown**: for the relevant log(s), read Summary, Next steps,
and especially Caveats / traps in full. Task state lives in the plan;
session-scoped traps live nowhere but the log.
3. **Verify against reality** — files may have moved on since the log was
written:
- the current branch vs the log's `branch:`;
- `git status` and recent commits vs the log's "What was done";
- each plan listed in `plan:` (a single path or a YAML list, resolved
from the workspace root) — compare its checkboxes and any
`Dispatched:` outcome lines against the log's next steps.
- **completion authority** in each plan: a delegated worker cannot
accept its own work (see `passdown-dispatch`), so check every `[x]`
task that shows signs of delegation:
- `[x]` whose latest `Dispatched:` line is not an accepted verdict
as `passdown-dispatch` defines it — **inconsistent**: the checkbox
claims completion the host never recorded. An accepted verdict
records `accepted` and names a host check after `verified:`. Lines
written before the `accepted` wording existed count as accepted when
they report success and name a host check after `verified:`.
- `[x]` on a `[dispatch: external-ok]` task with no `Dispatched:` line
at all — **unconfirmed**: nothing records who did it or whether it
was verified.
Report each such task by plan path and task ID, and treat it as not
accepted — still pending verification — in the briefing and the
proposed first action.
Report any mismatch instead of silently reconciling it; the working tree
and the plan win over the log, and an inconsistent `[x]` does not win
over the missing host verdict.
4. **Brief, then wait**: report status, verified next steps, and the traps.
Pickup produces a briefing and a proposed first action — it
never starts executing on its own. If the proposed work is a multi-task
plan, the `passdown-dispatch` gate still applies before implementation.
## Rules
- An empty or missing `log_dir` is a fact to report, not an error to fix:
say so and brief from plan/task state alone.
- Pickup does not fix an inconsistent `[x]` itself; the host that verifies
the task (or unticks it) records the verdict, per `passdown-dispatch`.
- Never modify a previous shift's log. Corrections and discoveries belong in
this session's own handoff or the workspace inbox.
- An `IN_PROGRESS` or `BLOCKED` log from another agent may mean that shift is
still active — surface it before building on that work.
- Trust files over the transcript: when a summarized conversation and the
logs disagree, the logs and the plan are the source of truth.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |