Skip to content

flurdy/agent-skills / skills/handoffs

handoffs

Verified

Browse and load current-repo or workspace-member handoffs, including pruned worktrees. Optional confirmed archiving and checkout recovery; loading alone never executes the saved task.

FileKindSize
REFERENCE.mdmarkdown45.5 KB
SKILL.mdskill md36.3 KB
scripts/archive.shexecutablescript3.4 KB
scripts/list.shexecutablescript59.6 KB
scripts/retention.pyscript5.0 KB
tests/test_list.pyscript51.7 KB
tests/test_retention.pyscript6.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
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall