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

release-debrief — скилл для Claude Code: что делает и как установить

Скилл release-debrief для Claude Code сравнивает свежий релиз поддерживаемого инструмента с последней сохранённой сводкой. Разбирает изменения в Claude Code, OpenCode, llama-swap и llama.cpp.

Apache-2.0 ★ 173 обновлён 2026-10-24

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

Что делает release-debrief

release-debrief определяет инструмент по запросу, читает его профиль и файл с предыдущей сводкой, затем получает актуальный changelog. Он выделяет версии после last_seen_version, группирует изменения по категориям профиля и отбрасывает малозначимые пункты. Для контекста скилл использует WebFetch и команды gh release или gh api.

После ответа скилл обновляет файл resources/outputs/<tool>.md: записывает последнюю версию, дату и новую секцию, оставляя две самые свежие сводки. Если файла состояния ещё нет, он берёт последние 3 релиза. Правила сравнения версий зависят от профиля инструмента, поэтому результат связан с содержимым resources/tools/<tool>.md.

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

  • сравнить свежий релиз с последней сводкой
  • выделить изменения после сохранённой версии
  • разложить новости по категориям инструмента
  • сохранить новую историю changelog
  • отфильтровать малозначимые пункты релиза

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

  • Сделай сводку изменений в Claude Code с момента последней проверки.
  • Что нового в llama.cpp? Обнови сохранённую сводку.
  • Покажи последние изменения в OpenCode и сохрани результат.

Как установить release-debrief

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill release-debrief -a claude-code

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

~/.claude/skills/release-debrief/SKILL.md

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

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

Вопросы о release-debrief

Как установить release-debrief в Claude Code?

Выполните npx skills add sammcj/agentic-coding --skill release-debrief -a claude-code, затем используйте файл ~/.claude/skills/release-debrief/SKILL.md.

Что делает release-debrief?

Скилл получает changelog поддерживаемого инструмента, сравнивает его с последней сохранённой версией и формирует краткую сводку изменений. Затем он обновляет историю в файле состояния.

Какие инструменты поддерживает release-debrief?

Скилл работает с Claude Code, OpenCode, llama-swap и llama.cpp. Для каждого инструмента используются отдельные профиль и файл сохранённых сводок.

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

SKILL.md · Apache-2.0
---
name: release-debrief
description: >-
  Summarises the delta between a tool's latest release and the last summary the user saw.
  Use when the user asks about what's new, the latest release, release notes, or the changelog
  of one of the supported tools: Claude Code, OpenCode, llama-swap, or llama.cpp.
allowed-tools: >-
  Read Write Edit Grep Glob
  WebFetch(domain:claude.com)
  WebFetch(domain:code.claude.com)
  WebFetch(domain:platform.claude.com)
  WebFetch(domain:opencode.ai)
  WebFetch(domain:github.com)
  WebFetch(domain:raw.githubusercontent.com)
  Bash(gh release list *)
  Bash(gh release view *)
  Bash(gh api *)
  Bash(open *)
metadata:
  author: 'Sam McLeod (adapted from Arjen Schwarz)'
disable-model-invocation: true
argument-hint: "What's been the latest changes in llama.cpp since we last checked? Give me a debrief"
---

# Release Notes Catch-Up

Summarise what's changed in a supported tool since the user last ran this skill against it. No walkthroughs, no exercises. Focused digest of the delta.

## Supported Tools

Each tool has a **profile** in `resources/tools/<tool>.md` (source URLs, buckets, gotchas) and an **output file** in `resources/outputs/<tool>.md` (last-seen version and summary history). Resolve both paths relative to this `SKILL.md`, not the user's current working directory.

| Tool        | Aliases the user may type      | Profile                          | Output                             |
| ----------- | ------------------------------ | -------------------------------- | ---------------------------------- |
| Claude Code | claude-code, claudecode, cc    | `resources/tools/claude-code.md` | `resources/outputs/claude-code.md` |
| OpenCode    | opencode, open-code            | `resources/tools/opencode.md`    | `resources/outputs/opencode.md`    |
| llama-swap  | llama-swap, llamaswap          | `resources/tools/llama-swap.md`  | `resources/outputs/llama-swap.md`  |
| llama.cpp   | llama-cpp, llama.cpp, llamacpp | `resources/tools/llama-cpp.md`   | `resources/outputs/llama-cpp.md`   |

Tool selection: match the tool from the user's prompt against the aliases above. If the user names something not in this table, reply with the supported list and stop.

## Flow

1. **Load the tool profile.** Read `resources/tools/<tool>.md`. It tells you where to fetch the changelog, how the version scheme works, which buckets to group under, what to drop, and what to watch out for. Treat the profile as authoritative for that tool.

2. **Read state.** Load the tool's output file. Parse `last_seen_version` from the frontmatter. If the file is missing, empty, or has no frontmatter version, treat as a first run: summarise the **last 3 releases** per the profile's version scheme, without prompting.

3. **Fetch the current changelog.** Use `WebFetch` or `ctx_fetch_and_index` against the profile's **Primary** source. Pull **Supporting** sources only when you need context for an entry (config schema comparison, API doc linking, editorial summary for colour). When the profile lists **Conditional** sources, test each condition against the delta once you have it and fetch the ones that hold - those carry buckets of their own.

4. **Identify the delta.** Keep entries newer than the stored version, up to the latest release. Compare versions using the scheme in the profile:
   - `semver` - parse major.minor.patch and compare numerically per component.
   - `build-number` - strip any prefix (`b`, `v`) and compare as integer.
   - `github-release-tag` - use GitHub's release order (chronological).

   Never compare version tags as lexicographic strings.

5. **Summarise.** Group entries under the profile's **Buckets**. For each item:
   - One line on what it is.
   - One line on why it matters or when you'd reach for it.
   - A doc link (from the profile's Feature Link Table, or the release page itself) when the feature is non-trivial.

   Apply the profile's **Out of Scope** list to drop low-signal entries. Apply the profile's **Gotchas** when deciding how to parse, group, or flag things. Keep tone dense and direct. Flag anything experimental, breaking, or schema-affecting prominently.

6. **Persist state.** Use `Edit` (or `Write` if the output file doesn't yet exist) to update the tool's output file:
   - Set `last_seen_version` in the frontmatter to the latest version from the fetched changelog (the single newest one, even if the summary covers a range).
   - Set `last_updated` to today's date (ISO format).
   - Prepend a new `## <version> (<date>)` section under `# <Tool> Changelog Summaries` containing the bucketed summary you just presented. When a single run covers multiple versions, use a range heading: `## <oldest> → <newest> (<date>)`.
   - Keep only the newest **two** `##` sections. If adding the new section would leave three or more, remove the oldest so exactly two remain.

   Confirm in one line: `Updated resources/outputs/<tool>.md to <version>.` If the run fails or the user aborts before the summary is delivered, leave the file alone.

7. **Output the full file path.** After a successful write: "Debrief saved to: /absolute/path/to/resources/outputs/<tool>.md "

## Storage File Format

Each output file follows this shape:

```markdown
---
last_seen_version: 2.1.112
last_updated: 2026-04-17
---

# <Tool> Changelog Summaries

## <version> (<date>)

### <Bucket>
- ...

## <prior version> (<prior date>)

### <Bucket>
- ...
```

`<version>` in the heading can be a single version (`2.1.112`) or a range when one run covered several (`2.1.109 → 2.1.112`). `last_seen_version` in the frontmatter is always the single newest version. At most two `##` sections: newest at top, prior run directly below. When prepending, drop the oldest.

## Scope Overrides

- **Explicit version** ("what's new since 2.1.90"): use the user's version instead of `last_seen_version`. Still persist state unless they say not to.
- **Date range** ("everything in the last 2 weeks"): use changelog dates rather than version. Still persist state.
- **Area filter** ("just hooks"): filter the delta to that area, but still persist state. Note the filter in the new section's heading: `## <version> (<date>, hooks only)`.
- **No persist** ("don't update state"): skip step 6, tell the user state was not persisted.

## Common Gotchas

- Resolve `resources/tools/<tool>.md` and `resources/outputs/<tool>.md` relative to this `SKILL.md`. Users invoke the skill from arbitrary working directories.
- Version parsing differs per tool - always read the profile's **Version Scheme** section before comparing. Don't assume semver.
- If the stored version is newer than anything in the fetched changelog (user bumped it manually, or the source hasn't updated yet), say so plainly and don't invent a delta.
- Use `Edit` to prepend the new section and remove the oldest so only two remain. Fall back to `Write` only when the file doesn't yet exist.
- Don't mix tools in one output file. Each tool owns its own output file.
- First-run heuristic (last 3 releases) applies per tool, not per invocation. If the user ran the skill on Claude Code yesterday and asks about OpenCode today, OpenCode is still a first run.

© Sam McLeod (adapted from Arjen Schwarz) · Apache-2.0 · sammcj/agentic-coding

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
generate-release-notes donnfelker Скилл generate-release-notes для Claude Code, который превращает историю коммитов в release notes и changelog. Запускается, когда нужно собрать отчёт о релизе из conventional commits. CX Codex +1 764установок jackin-release-notes jackin-project Скилл jackin-release-notes собирает PR после последнего тега, раскладывает их по категориям Keep a Changelog и обновляет [Unreleased] в CHANGELOG.md. CX Codex +1 469установок draft-release-notes Cobus Greyling Скилл draft-release-notes превращает вывод сканирования changelog в черновик релизных заметок с разделами. Публикацию оставляет человеку: скилл только предлагает текст. CX Codex +1 ★ 11 819звёзд репо release-announcement Necmttn Скилл release-announcement составляет анонсы релизов и страницы чейнджлогов для сайта проекта ax. Скилл восстанавливает ход разработки через историю сессий ax и коммиты Git. CX Codex +1 ★ 124звёзд репо release-notes phuryn release-notes — скилл для Claude Code, который превращает тикеты и внутренние журналы изменений в заметки для пользователей. Он включается при подготовке релиза или описании выпущенных обновлений. CX Codex +1 3 100установок deliver-release-notes product-on-purpose Скилл deliver-release-notes превращает список изменений в релиз-ноты, которые читают пользователи: что нового, что улучшили, что починили. CX Codex +1 843установок

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

Весь набор →
reframe-voice Скилл reframe-voice для Claude Code задаёт стиль доказательных колонок с переосмыслением привычных идей. Помогает разбирать сложные темы в лонгридах без рекламного пафоса. CX Codex +1 ★ 173звёзд репо excalidraw-diagrams Скилл excalidraw-diagrams создаёт и обновляет схемы Excalidraw через интерактивный просмотр MCP или локальный Python-скрипт. CX Codex +1 ★ 173звёзд репо idrive-backup Помогает проверять и менять настройки iDrive Backup на macOS, включая пути резервного копирования и исключения. При изменениях инструмент автоматически сохраняет копии конфигурации. CX Codex +1 ★ 173звёзд репо ghostty-config Скилл ghostty-config помогает настраивать терминал Ghostty: подсказывает синтаксис config.ghostty, валидирует параметры и учитывает отличия macOS и Linux. CX Codex +1 ★ 173звёзд репо pptx-to-md Скилл pptx-to-md для Claude Code превращает PPTX в Markdown: один файл на слайд, с текстом, позициями изображений и описанием диаграмм и скриншотов. CX Codex +1 ★ 173звёзд репо web-artifacts-builder-v2 Скилл web-artifacts-builder-v2 собирает сложные HTML-артефакты на React с несколькими компонентами, состоянием или маршрутизацией. Он пригодится, когда нужен готовый автономный HTML-файл. CX Codex +1 ★ 173звёзд репо glean-cli Скилл glean-cli учит агента работать с CLI glean: искать по корпоративному индексу, спрашивать Glean Assistant, читать документы и карточки людей. CX Codex +1 ★ 173звёзд репо ai-changelog Скилл ai-changelog внедряет в репозиторий систему ведения CHANGELOG.md силами ИИ-агентов. Поддерживает SemVer, CalVer и датированные записи для проектов без сборщика. CX Codex +1 ★ 173звёзд репо

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

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