# Catchup

Rebuild the human's lost context on a project from live state, in plain language: what...

- Repository: https://github.com/LilMGenius/paperthin (1365 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add LilMGenius/paperthin --skill catchup -g -a claude-code -y`
Codex: `npx skills add LilMGenius/paperthin --skill catchup -g -a codex -y`
Cursor: `npx skills add LilMGenius/paperthin --skill catchup -g -a cursor -y`
Gemini CLI: `npx skills add LilMGenius/paperthin --skill catchup -g -a gemini-cli -y`

## Description

Rebuild the human's lost context on a project from live state, in plain language: what needs them, what changed, what new words mean. Use when the human returns after a gap, says they can't follow the project anymore, asks what happened or what a term means, or before deciding what to do next when their mental model is stale. Read-only; it briefs, it does not act.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Catch the human up at their eye level, from state, not from memory.

## Goal

`catchup` is the re-entry point for a lost human. Long agent cycles coin words, rename files, run
experiments, and make calls faster than the owner can follow. Before any next action makes sense,
the owner's mental model must be reloaded. `catchup` reads the live project state and returns a
briefing a person with zero retained context can act on. It runs before the next move gets decided:
catchup restores the map, so that decision starts from truth instead of a stale memory of it.

## Workflow

1. Read live state only: recent file mtimes, git log/diffs, plan and state docs, re0-memo notes,
   task boards. Never brief from conversation memory alone, memory is what drifted.
2. Anchor on the human's last touch (their last message, judgment, or commit). Everything after
   that point is the delta; everything before it is assumed known and stays out.
3. Compose in decision order, not chronological order:
   - **Needs you**, decisions, judgments, or inputs only the human can give, each self-contained
     enough to act on without opening another file.
   - **Changed while you were away**, outcomes, not process. "The plan's scoring rule was
     replaced" beats "I ran three analysis passes."
   - **New words**, every term coined or repurposed since their last touch, one line each, with
     where it lives. Skip terms they already used themselves.
4. Gloss on first use: any project-specific term appearing in the briefing gets an inline
   plain-language aside at its first occurrence, even if a glossary section follows.
5. Keep the default short (a screen or less). End with drill-down offers per section, not with
   everything expanded.

## Rules

The rest: https://github.com/LilMGenius/paperthin/blob/HEAD/skills/coil/catchup/SKILL.md