{"slug":"catchup-2","title":"catchup","summary":"Summarize and review what changed while you were away. Use after a weekend, vacation, or flight to check missed PRs, git commits, Linear tickets, and meetings — one prioritized brief, not a firehose.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-04T15:14:18.690718Z","repo":{"url":"https://github.com/oliver-kriska/claude-elixir-phoenix","stars":560,"forks":44,"license":"MIT","updatedAt":"2026-10-02T04:11:38Z"},"bodyHtml":"
\n

name: catchup\ndescription: \"Summarize and review what changed while you were away. Use after a weekend, vacation, or flight to check missed PRs, git commits, Linear tickets, and meetings — one prioritized brief, not a firehose.\"\neffort: medium\ndisable-model-invocation: true\nargument-hint: \"[--since \"friday\"|\"2h\"|\"last-active\"|\"last-commit\"] [--scope repo|all] [--sources github,git,linear,calendar] [--depth quick|standard|deep] [--focus prs,reviews-requested,mentions,impact]\"

\n

Catchup — Async-Team Return Briefing

\n

You've been away. This skill is a thin orchestrator: it resolves\nthe window + sources here, then delegates the I/O fan-out, impact\nanalysis, and brief assembly to the catchup-runner agent (Sonnet) so\nyour (often Opus) session does not pay for summarization. You only\nprint what the agent returns.

\n

Usage

\n
/catchup                                  # since you were last active\n/catchup --since \"friday\"\n/catchup --since \"2h\" --focus reviews-requested\n/catchup --since last-commit --depth deep\n/catchup --scope all                      # include cross-repo pings/reviews\n
\n

Default is repo-scoped: every GitHub signal (reviews requested,\nnotifications, mentions) is filtered to the repo you ran it in. Pass\n--scope all to also include cross-repo activity, which is then listed\nin its own separate section — never mixed into this repo's lists.

\n

Iron Laws

\n
    \n
  1. Delegate the heavy work — spawn catchup-runner (sonnet) for\nfan-out + assembly. Do NOT run the gh/git fan-out in this\nsession; that defeats the cost/speed purpose.
    2. \n
  2. Resolve the window here, once — the agent must never re-resolve\nit. Pass absolute SINCE_* values.
    3. \n
  3. MCP runs here, not in the agent — Linear/Calendar MCP tools are\nunreliable in subagents. If present, fetch in this context and pass\nthe text to the agent; else mark absent.
    4. \n
  4. Validate --since before any shell — match the grammar; on no\nmatch fall back to 24h and note the assumption.
    5. \n
  5. Stop after the brief — print the agent's summary, never\nauto-transition to another command.
    6. \n
  6. Repo-scoped by default — pass SCOPE=repo unless the user\npassed --scope all. A brief run inside one repo must not leak\nanother repo's reviews/notifications. Cross-repo is opt-in only.
    7. \n
\n

Workflow

\n

1. Parse arguments

\n

From $ARGUMENTS: --since, --scope, --sources, --depth,\n--focus. Defaults: --since last-active, --scope repo, all\ndetected sources, --depth standard, no focus. --scope accepts\nrepo (default — every GitHub signal filtered to the current repo) or\nall (cross-repo allowed, listed in its own section).

\n

2. Resolve the time window (here, in this context)

\n

Read ${CLAUDE_SKILL_DIR}/references/time-window.md. Resolve calendar\nwords (friday, yesterday, a date) in the user's local timezone\n(this machine = the user's TZ), pivot through SINCE_EPOCH, derive\nSINCE_ISO (UTC) + SINCE_LABEL (with TZ abbrev) + LOCAL_TZ.

\n

Default last-active = MAX of: newest Claude session mtime for this\nrepo, your last own commit (git log --author=<you> -1 --format=%ct),\nyour last own PR in this repo (gh pr list --repo <repo> --author @me --state all, repo-scoped — a global search would anchor to other\nrepos). The latest footprint is \"you were last here\". Record which\nsignal won. Variants: last-session (sessions only),\nlast-commit/last-mine (your git/PR only). No signal → 24h, noted.

\n

3. Detect sources + pull MCP data (here)

\n
gh:   command -v gh && gh auth status               → github ON\ngit:  git rev-parse --is-inside-work-tree           → git ON\nlinear/calendar: a Linear / Google-Calendar MCP tool present?\n
\n

If Linear/Calendar MCP is present, query it in this context now\n(assigned/updated tickets since SINCE_ISO; missed + today's\nmeetings in LOCAL_TZ) and keep the short text as LINEAR_DATA /\nCALENDAR_DATA. If absent, set them to absent (the agent will\nproxy-harvest XXX-#### refs for Linear; skip calendar with a note).

\n

4. Delegate to catchup-runner (Sonnet)

\n

Spawn one agent, foreground, passing a self-contained prompt:

\n
Agent(subagent_type: \"catchup-runner\", prompt: \"\"\"\nSINCE_EPOCH={…}  SINCE_ISO={…Z}  SINCE_LABEL=\"{… local TZ}\"\nLOCAL_TZ={…}  SOURCES={github,git}  SCOPE={repo|all}  DEPTH={…}  FOCUS={…}\nOUT_PATH={cwd}/.claude/catchup/brief-{YYYY-MM-DD}.md   # local date (date +%F), not UTC\nLINEAR_DATA={text or \"absent\"}\nCALENDAR_DATA={text or \"absent\"}\nWindow anchor signal: {which one won, for the Risks note}\nDo the gh+git fan-out, impact analysis, and brief assembly per your\ninstructions. Write the file. Return ONLY the inline summary.\n\"\"\")\n
\n

The agent inlines all recipes (it cannot read this plugin's\nreferences). Do not re-implement its work here.

\n

5. Present + stop

\n

Print the agent's returned summary verbatim and the brief path.

\n

If the agent returned no summary (e.g. it hit its turn budget\nmid-assembly — the brief file is usually already written): do NOT\nre-summarize the brief yourself; that pulls the expensive step back\ninto this (often Opus) session, defeating the delegation. Instead\nSendMessage the agent by the agentId from its stop usage:\n\"Return only the inline summary now.\" — it finishes cheaply in\nSonnet. Only if that also fails, read the brief's Intent + Top\npriorities section (not the whole file) and print that.

\n

Do NOT auto-invoke any other command. The user decides what's\nfirst.

\n

Sources at MVP

\n

GitHub (gh), Git (git), Linear MCP (optional), Google Calendar MCP\n(optional). Slack/Gmail are v2 opt-in — never queried, never piped\nraw. Scheduling + per-project config are designed in\n${CLAUDE_SKILL_DIR}/references/config-schema.md, not built at MVP.

\n

Graceful degradation contract

\n

A missing source degrades the brief, never breaks it. git log alone\n(always available in a repo) is a valid minimum brief. Every absent or\nfailed source becomes one honest line under the brief's\nRisks/assumptions block, so the reader knows what it does not cover.

\n","files":[{"path":"references/brief-format.md","sizeBytes":6350,"isText":true},{"path":"references/config-schema.md","sizeBytes":3283,"isText":true},{"path":"references/source-adapters.md","sizeBytes":9547,"isText":true},{"path":"references/time-window.md","sizeBytes":7807,"isText":true},{"path":"SKILL.md","sizeBytes":6125,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-04T15:15:44.52846Z","sha256":"57793B11AC7144F3684101F205A4701FC8BE539B1FEABA0632E88950DC3A42ED","sizeBytes":16499},"review":null,"source":{"repositoryUrl":"https://github.com/oliver-kriska/claude-elixir-phoenix","path":"plugins/catchup/skills/catchup","license":"MIT","commit":"9767a82d24ddddad553e85f88efc2869a7fd7d88","subtreeSha":"D92C5014D5F4A88A91118230F48A820218B0031E637A63989FE99A738DA5A536","lastSyncedAt":"2026-10-04T15:14:09.139242Z"},"reviewedAt":"2026-10-04T15:17:57.910771Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/plugins/catchup/skills/catchup"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install oliver-kriska-claude-elixir-phoenix@llmmart"},{"target":"git","command":"git clone https://github.com/oliver-kriska/claude-elixir-phoenix.git"}]}