flurdy/agent-skills / skills/handoffs
handoffs
VerifiedBrowse and load current-repo or workspace-member handoffs, including pruned worktrees. Optional confirmed archiving and checkout recovery; loading alone never executes the saved task.
| File | Kind | Size |
|---|---|---|
| REFERENCE.md | markdown | 45.5 KB |
| SKILL.md | skill md | 36.3 KB |
| scripts/archive.shexecutable | script | 3.4 KB |
| scripts/list.shexecutable | script | 59.6 KB |
| scripts/retention.py | script | 5.0 KB |
| tests/test_list.py | script | 51.7 KB |
| tests/test_retention.py | script | 6.6 KB |
scripts/archive.sh
View on GitHub#!/usr/bin/env bash
# Move handoff files out of the active ~/.agents/handoffs/ listing into
# ~/.agents/handoffs/archive/ so the picker de-clutters without losing the
# grep log. Non-destructive: it MOVES, never deletes, and never overwrites.
# Shared by the wrap-up (supersede-at-save) and handoffs (archive sweep) skills.
#
# Usage: archive.sh NAME [NAME...]
# NAME a handoff filename (e.g. 2026-05-27-foo.md) or an absolute path to
# one. Anything that doesn't resolve to a direct child of the handoffs
# dir is refused (SKIPPED), so a stray path can't move arbitrary files.
#
# Output is delimited for the calling skill to parse:
# ---ARCHIVE-DIR--- the destination directory
# ---ARCHIVED--- one `{basename}|{dest-path}` line per moved file
# ---SKIPPED--- one `{arg}|{reason}` line per refused/missing file
set -uo pipefail
HANDOFFS_DIR="${HOME}/.agents/handoffs"
LEGACY_HANDOFFS_DIR="${HOME}/.claude/handoffs"
ARCHIVE_DIR="${HANDOFFS_DIR}/archive"
if [ $# -eq 0 ]; then
echo "usage: archive.sh NAME [NAME...]" >&2
exit 2
fi
# Hard cutover: never move files while the legacy location still exists. The
# migration itself is a separately approved whole-directory move, not an archive.
if [ -e "$LEGACY_HANDOFFS_DIR" ] || [ -L "$LEGACY_HANDOFFS_DIR" ]; then
echo "WARNING: legacy handoff storage still exists at $LEGACY_HANDOFFS_DIR; nothing archived." >&2
echo "---ARCHIVE-DIR---"
echo "$ARCHIVE_DIR"
echo "---ARCHIVED---"
echo "---SKIPPED---"
for arg in "$@"; do
echo "${arg}|legacy handoff storage present; migrate first"
done
exit 3
fi
ARCHIVED=()
SKIPPED=()
for arg in "$@"; do
# Resolve to a path. A bare name (no slash) is taken relative to the
# handoffs dir; anything with a slash must already point inside it.
case "$arg" in
*/*) src="$arg" ;;
*) src="${HANDOFFS_DIR}/${arg}" ;;
esac
if [ ! -f "$src" ]; then
SKIPPED+=("${arg}|not found")
continue
fi
# Canonicalise and confirm the file is a *direct* child of the handoffs dir
# (not already in archive/, not somewhere else on disk).
abs=$(realpath "$src" 2>/dev/null || true)
parent=$(dirname "$abs" 2>/dev/null || true)
if [ -z "$abs" ] || [ "$parent" != "$HANDOFFS_DIR" ]; then
SKIPPED+=("${arg}|outside handoffs dir")
continue
fi
base=$(basename "$abs")
mkdir -p "$ARCHIVE_DIR" 2>/dev/null || true
# Never overwrite: insert -2, -3, … before the .md extension if needed.
dest="${ARCHIVE_DIR}/${base}"
if [ -e "$dest" ]; then
stem="${base%.md}"
n=2
while [ -e "${ARCHIVE_DIR}/${stem}-${n}.md" ]; do
n=$((n+1))
done
dest="${ARCHIVE_DIR}/${stem}-${n}.md"
fi
if mv "$abs" "$dest" 2>/dev/null; then
ARCHIVED+=("${base}|${dest}")
else
SKIPPED+=("${arg}|move failed")
fi
done
echo "---ARCHIVE-DIR---"
echo "$ARCHIVE_DIR"
echo "---ARCHIVED---"
for line in "${ARCHIVED[@]:-}"; do
if [ -n "$line" ]; then echo "$line"; fi
done
echo "---SKIPPED---"
for line in "${SKIPPED[@]:-}"; do
if [ -n "$line" ]; then echo "$line"; fi
done
# Explicit success. The loops above end on a false test whenever their array is
# empty, and with `&&` that status leaked out as the script's exit code — so a
# clean run (nothing skipped) exited 1 while a failed one exited 0. Callers read
# outcomes from ---ARCHIVED---/---SKIPPED---, not the exit status.
exit 0
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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |