К основному содержанию
скилл CX Codex

catch-up — скилл для Claude Code: сводка изменений и установка

Скилл catch-up для Claude Code собирает короткую сводку по проекту: что сделали агенты, почему и какие решения ждут вашего выбора. Помогает восстановить ход работы после паузы.

MIT 126 установок ★ 49 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add petekp/claude-code-setup --skill catch-up -a claude-code
Открыть на GitHub

Что делает catch-up

Скилл готовит сводку для того, кто вернулся к проекту после паузы. Сначала агент выбирает окно: от прошлого такого отчёта, от понятной вехи вроде мержа или от начала сессии. Потом смотрит, что реально изменилось.

Причина изменений берётся из разговора, а факты сверяются с репозиторием: git log --oneline -20, git diff --stat HEAD~N, git status. Читать файлы целиком не нужно — важна форма правки, а не построчный пересказ. Внутренние имена переводятся на человеческий язык: вместо названия класса в отчёте появится, что этот код делает.

На выходе несколько блоков: что изменилось, почему и «Your call» — открытые развилки с ценой каждого варианта и тем, что уже сделано по умолчанию. Мелкая правка укладывается в пару предложений без заголовков. Отчёт опирается на историю коммитов, поэтому в репозитории без неё сверять не с чем и остаётся только разговор.

Какие задачи решает

  • вернуться к проекту после паузы и понять, что наделали агенты
  • отделить реально закоммиченное от того, что только обсуждалось в чате
  • собрать список решений, которые ещё ждут вашего выбора
  • перевести внутренние названия классов и модулей на понятный язык
  • восстановить ход работы по git-логу, когда транскрипт сессии потерялся

Примеры запросов агенту

  • Догони меня: что изменилось, пока меня не было?
  • Сделай сводку по этой сессии и скажи, где нужно моё решение.
  • Что вы с другими агентами сделали с авторизацией и почему?

Как установить catch-up

1Через Skills CLI (Vercel)

npx skills add petekp/claude-code-setup --skill catch-up -a claude-code

2Вручную: положить файлы

~/.claude/skills/catch-up/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/catch-up/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о catch-up

Как установить catch-up в Claude Code?

Выполните npx skills add petekp/claude-code-setup --skill catch-up -a claude-code. Файл скилла появится по пути ~/.claude/skills/catch-up/SKILL.md.

Что делает catch-up?

Собирает короткую сводку по проекту: что изменилось, почему и какие решения остались за вами. Причину агент берёт из разговора, а факты сверяет по git.

За какой период скилл берёт изменения?

Сначала он ищет свой прошлый отчёт и считает от него. Если такого нет — от заметной вехи вроде мержа или явного «начнём с X», иначе от начала сессии.

Исходный текст

SKILL.md · MIT
---
name: catch-up
description: >-
  Give the human a fast, plain-English catch-up on what changed in the
  project: what the agents did, why, and what decisions need their input.
  Use when the user asks to "catch me up", "what changed", "where are we",
  "recap", "brief me", "give me the rundown", "what did you do", "summarize
  the session", or "fill me in", or otherwise wants to get back up to speed
  after being away.
---

# Catch Up

The person reading this has been away. While they were gone, agents (you and
others) moved the project forward. They are juggling several projects like
this one and do not read the code closely. Your job is to get them back in
the driver's seat in under a minute: what changed, why it changed, and where
their input would actually steer things.

That framing decides everything below. They cannot act on a diff or a commit
list, so do not give them one. They *can* act on plain ideas and clear
choices, so give them those.

## What good looks like

- **Plain English, zero jargon.** Every technical term either gets
  translated or explained the first time it appears. If a reader who has
  never seen the code would stumble on a word, rewrite it. See
  [Translating jargon](#translating-jargon).
- **Altitude, not inventory.** Group changes by what they *mean*, not by
  file. One idea per bullet. The headline is the thing, not the line count.
- **The why is the payload.** The diff says what changed; only the
  conversation says why. The reader steers on the why, so make sure it
  survives.
- **Surfaces the forks.** The single most useful thing you can give a
  steerer is the list of decisions that are still open, or were made by
  default and could be reversed. That is where their attention belongs.
- **Honest.** If something is half-done, untested, or went sideways, say so.
  A catch-up that hides loose ends makes steering worse, not better.

## How to do it

### 1. Find the starting line

State the window you are summarizing, in one short phrase, so the reader
knows the frame. Infer it from the conversation, in this order:

1. **A previous catch-up.** Scan the transcript for the last time you ran
   this skill (your own output, led by a window line like the ones below).
   If you find one, summarize only what happened *after* it. This is the
   common case when they check in repeatedly.
2. **A clear milestone.** A merge, a shipped PR, a finished plan, or an
   explicit "let's start on X" is a natural starting line. Summarize since
   then and name it: *"Since the auth refactor merged"*.
3. **The session start.** If neither of the above is clear, summarize the
   whole session and say so: *"This session so far"*.

If the transcript was compacted or you genuinely cannot tell, default to
session start, say that is what you did, and lean on git (below) to recover
the missing history rather than guessing.

Good window lines: *"Since your last check-in"*, *"Since we started on
search"*, *"This session so far"*, *"Since the v2 branch merged"*.

### 2. Gather what changed

Lead with the **conversation**. In an agent-driven project it holds both
the work and the reasoning. Then ground it against the repo so you are
reporting what actually landed, not what was merely discussed:

```bash
git log --oneline -20        # what actually got committed
git diff --stat HEAD~N       # rough shape of the change (pick N from the log)
git status                   # what is still uncommitted / in flight
```

Use git to confirm the *what* and catch anything that happened off-screen.
Use the conversation for the *why*. Do not read every file. You are after
the shape of the change, not a line-by-line account. A quick look at one or
two key files is fine when you need to understand an abstraction well enough
to name it plainly; reading ten is a sign you have lost the altitude.

### 3. Keep only what helps them steer

Keep: the core moving parts that were added or reshaped (named in plain
words), the approach chosen and any real alternative that was rejected, the
reasoning, decisions that now lock things in, open forks, and anything
surprising or risky.

Drop: file-by-file churn, line counts, formatting and lint noise, mechanical
renames, and anything the reader could not act on. If you are unsure whether
something belongs, ask "could they steer on this?" If not, cut it.

### 4. Write the briefing

Use the structure below. Scale it to how much actually changed. See
[Scale to the change](#scale-to-the-change). Drop any section that would be
empty; an honest short note beats a padded template.

```
[Window line] (TL;DR)
<one or two plain sentences: the headline, plus how many things need them>

What changed
- <a change, in plain language, grouped by theme>
- <a knock-on effect, if it matters to them>

Why
- <the problem being solved or the reasoning behind the approach>

Your call
- <open decision>: <the tradeoff in plain terms>. <what you did by default>.
```

Keep each bullet tight: lead with the point in one line. Add at most one
plain sentence after it, and only when a term genuinely needs unpacking for
someone who has not seen the code. More than that and you have slipped from
briefing into narration. Cut it back, or split it into two bullets.

The **Your call** section is the steering payload. List real forks: things
left undecided, or decided by default and easy to flip. For each, give the
tradeoff in one plain sentence and say what you did in the meantime so they
know the current state. If nothing needs them, say so in one line
(*"Nothing needs you right now."*) rather than inventing a decision.

## Translating jargon

This is the core move, so it is worth doing well. Name the underlying idea,
not the implementation. A few examples of the translation:

| Instead of | Say |
|---|---|
| "Added a reducer to centralize state" | "Put all the app's 'what's true right now' bookkeeping in one place instead of scattered around" |
| "Memoized the selector" | "Made a slow lookup remember its answer so it stops recomputing every time" |
| "Introduced a discriminated union for the result" | "Made a result always be exactly one of a few clearly-labeled shapes, so we can't mix them up" |
| "Extracted the API client into a shared module" | "Moved the code that talks to the server into one shared spot so every screen uses the same one" |
| "Added optimistic updates" | "The screen now shows your change instantly and fixes itself if the server disagrees" |

Two practical tells. First, if a name in your draft only means something to
someone who has read the code (a class name, a file name, an internal
codename), replace it with what it *does*. Second, write the way you would
explain it out loud to a smart colleague on a different team. That voice is
almost always the right altitude.

## Scale to the change

The structure is a guide, not a quota. Match the output to the substance:

- **Tiny change** (a fix, a tweak): one or two sentences. No headers. *"Fixed
  the bug where the export button did nothing on empty lists. Nothing needs
  you."*
- **Normal session:** the full briefing, a few bullets per section.
- **Big or sprawling session:** still lead with one TL;DR line, then group
  the body by theme so it stays skimmable. Resist the urge to be
  comprehensive: completeness is the enemy here. Pick the handful of things
  that change how they would steer, and note that smaller stuff was skipped.

## Voice

Short sentences, one idea each. No em dashes. Skip AI throat-clearing such
as "It's worth noting that...". Write like a sharp colleague catching them
up between meetings, not like a release note.

© petekp · MIT · petekp/claude-code-setup

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
spec-impl Klerith Скилл spec-impl для Claude Code и Codex запускает пошаговую кодогенерацию по готовой спецификации. Находит документ в каталоге specs/, проверяет подтверждение статуса и создаёт отдельную ветку в Git. CX Codex +1 4 900установок om-auto-fix-issue open-mercato Скилл om-auto-fix-issue для Claude Code ведёт задачу из трекера от разбора до pull request. Получив номер issue или описание проблемы, он выбирает маршрут для бага или новой функции. CX Codex +1 4 700установок om-auto-create-pr open-mercato Скилл om-auto-create-pr превращает свободное описание задачи в автономный запуск: составляет план, реализует код в отдельном git worktree и открывает pull request. Запускается по текстовому брифу инженера. CX Codex +1 4 700установок create-branch getsentry Скилл create-branch для Claude Code создаёт Git-ветки по соглашениям Sentry. Он включается по просьбе создать ветку или при начале работы в ветке по умолчанию. CX Codex +1 4 400установок checkpoint codewithmukesh Скилл checkpoint делает git-коммит с описанием и короткую заметку о состоянии работы, не завершая сессию. Пригодится перед рискованным рефактором. CX Codex +1 4 000установок new-branch-and-pr cursor Скилл new-branch-and-pr для Claude Code, Codex, Cursor и других агентов берёт задачу и проводит её по полному циклу: создаёт ветку от актуального main, делает коммит и открывает pull request. CX Codex +1 2 300установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой