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

changelog · shpigford — скилл для Claude Code: что делает и как установить

Составляет понятный пользователям список изменений по закрытым PR и добавляет его прямо в статическую страницу site/changelog.html.

MIT 135 установок ★ 653 обновлён 2026-11-02

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

Что делает changelog

Скилл автоматизирует ведение журнала релизов для проекта nurb. Он находит последнюю версию в site/changelog.html, сопоставляет номера SemVer с тегами Git по стандарту PEP 440 и собирает коммиты между релизами. Вместо сухого технического лога агент изучает закрытые PR через GitHub CLI и отбирает только то, что действительно заметит пользователь в интерфейсе.

Внутрь страницы вставляется готовый блок <article class="release"> с разметкой тегами new, improved или fixed. Служебные правки вроде тестов, настроек CI или рефакторинга скилл отсекает. Для проверки запускается локальный сервер python3 -m http.server 7878 -d site, после чего агент сверяет вёрстку скриншотом и ищет случайные длинные тире или повторяющиеся версии.

Скилл жёстко привязан к структуре nurb: без файла site/changelog.html и соответствующей схемы тегов Git сценарий работать не сможет.

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

  • выбрать из закрытых PR только видимые пользователю изменения
  • сформировать HTML-разметку релиза с тегами new, improved и fixed
  • сопоставить теги версий PEP 440 с форматом SemVer
  • проверить вёрстку на локальном сервере и отсечь лишние символы

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

  • Сформируй список изменений по закрытым пулл-реквестам.
  • Обнови журнал релизов в site/changelog.html.
  • Подготовь описание изменений для новой версии перед слиянием ветки.

Как установить changelog

1Через Skills CLI (Vercel)

npx skills add Shpigford/nurb --skill changelog -a claude-code

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

~/.claude/skills/changelog/SKILL.md

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

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

Вопросы о changelog

Как установить changelog в Claude Code?

Выполните команду npx skills add Shpigford/nurb --skill changelog -a claude-code. Файл сохранится по пути ~/.claude/skills/changelog/SKILL.md.

Что делает скилл changelog?

Он читает коммиты и PR между релизами, отфильтровывает служебный код и добавляет понятные описания функций в файл site/changelog.html.

Какие изменения попадают в итоговый список?

В журнал входят только новшества, которые видит пользователь интерфейса. Правки CI, тесты, документация репозитория и рефакторинг исключаются автоматически.

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

SKILL.md · MIT
---
name: changelog
description: Write nurb.app changelog entries from the releases since the last published one. Filters the release's merged PRs to what a user would actually notice, drafts each in the site's voice, and inserts the release into site/changelog.html. Use when the user says "changelog", "update the changelog", "announce this", or after cutting a release.
---

# nurb changelog

One surface: `site/changelog.html`, the static page behind nurb.app/changelog. One `<article class="release">` per released version, newest first. There is no build step and no data file; the HTML is the data.

Releases are the unit. A nurb release is a version bump merged to main; `desktop/scripts/release.sh` tags it and publishes it as a GitHub release. Final releases use the same spelling everywhere (`v1.0.0`); prerelease git tags use PEP 440 (`v1.0.0a1`) while the app and changelog use SemVer (`v1.0.0-alpha.1`). The changelog entry for a version is written from the commits merged between one git tag and the next, filtered hard.

## Step 1: Find the gap

The newest `id="vX.Y.Z"` in `site/changelog.html` is the high-water mark in SemVer spelling. Map prereleases to PEP 440 before looking for their git tag: `v1.0.0-alpha.1` maps to `v1.0.0a1`, `beta` to `b`, and `rc` loses only the hyphen and dot (`v1.0.0-rc.1` to `v1.0.0rc1`).

```bash
grep -m1 'id="v' site/changelog.html
git fetch --tags && git tag --sort=-v:refname | head -20
```

Every tagged release newer than the high-water mark needs an entry. If the user describes a feature in free text instead, write that one entry into the version it shipped in (or the pending version if it hasn't shipped yet) and skip the sweep.

When /release invokes this before the bump PR merges, the newest version has no tag or GitHub release yet. Write its entry anyway: source it from the PRs merged since the last release (`gh pr list --state merged --base main --json title,number,mergedAt`) plus whatever the release branch itself ships, date it today, and write the version as plain text, like every entry already on the page. The entry lands as part of the release PR, so commit it there instead of leaving it uncommitted.

For each missing version:

```bash
git for-each-ref --format='%(creatordate:iso-strict)' refs/tags/vPEP440
git log --format='%h %s' vPREVIOUS_PEP440..vPEP440
```

The tag date is the publish date and the commits between tags are the release contents. Read a PR (`gh pr view N`) whenever a commit or PR title alone doesn't tell you what a user would notice.

## Step 2: Filter to what earns a line

Most PRs are not changelog lines. A PR earns one only if **someone using nurb could notice the difference without reading the code.**

Yes: a new capability in the viewer or the modeling vocabulary, a new check, a behavior change they'd feel, a fix for something that visibly broke, a change to how their AI works with them (asks for measurements, names sliders in their words).

No: CI, tests, refactors, repo docs, CLAUDE.md, release plumbing, skill-file mechanics with no visible effect, marketing site tweaks.

Group by capability, not by PR. Several PRs polishing one feature collapse into one line. A version whose every PR is internal gets no entry at all; say so in the report rather than padding.

## Step 3: Draft the copy

The audience is a hobbyist with a printer, not a programmer. They talk to their AI and judge parts in a browser.

- Never mention Python, module names, function names, build123d, OCCT, or agent-harness jargon. `stand()` is "diagonal printing"; `nurb inspect` is "your AI can inspect a part".
- "Your AI" is the actor for agent-side changes, matching the landing page.
- Sentence case, second person, plain English. Say what changed and what they can now do, then stop. No rationale, no design defense.
- No em-dashes, no exclamation points, no emoji, no marketing fluff.
- Each line gets a tag: `new`, `improved`, or `fixed`. Only `new` also carries the class (`<b class="tag new">`); the other two are `<b class="tag">improved</b>` and `<b class="tag">fixed</b>`.
- A headline capability may lead its line with a bold two-or-three-word name: `<b>Assemblies.</b>`.

## Step 4: Write the page

Insert the new `<article class="release" id="vX.Y.Z">` at the **top** of `<main>`, right after the `.lede` paragraph. Copy the markup shape of the entry below it exactly:

```html
<article class="release" id="v0.9.0">
  <div class="meta"><span class="ver">v0.9.0</span><time datetime="2026-07-31">July 31, 2026</time></div>
  <ul>
    <li><b class="tag new">new</b><span><b>Diagonal printing.</b> A part that prints better tilted...</span></li>
    <li><b class="tag">fixed</b><span>...</span></li>
  </ul>
</article>
```

The date is the annotated tag's creator date, not today (a pre-merge entry uses today, which becomes the release date when the PR merges). Never reword or delete an already-published entry; its `id` is a live anchor.

## Step 5: Verify

Look at the page, don't just lint it: serve `site/` (`python3 -m http.server 7878 -d site`), open `http://localhost:7878/changelog.html` with whatever browser tooling is available, and screenshot it. Check the new entry renders like its neighbors, then kill the server. Also, silence is pass on both of these:

```bash
git diff -U0 site/changelog.html | grep '^+.*—'   # em-dashes in what you added
grep -o 'id="v[^"]*"' site/changelog.html | uniq -d  # duplicate versions
```

And confirm by eye that versions still descend down the page.

## Step 6: Report

List each version with its lines and tags, plus one line for what was skipped and why. Leave the change uncommitted unless asked.

© Shpigford · MIT · Shpigford/nurb

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

Все скиллы по теме «Git и GitHub» →

Сначала — changelog от других авторов.

changelog Donchitos Скилл changelog для Claude Code и других платформ. Собирает историю изменений по коммитам и отчётам спринтов в двух видах: внутренний и для игроков — перед релизом без ручной писанины. CX Codex +1 659установок changelog Remocn Скилл changelog для Claude Code собирает изменения из git-тегов, коммитов или pull request'ов, формулирует их понятным языком и строит видео-анонс релиза. CX Codex +1 462установок changelog chrisbanes Сверяет заметки к релизу с историей Git и подтверждениями из задач и PR. Запускается при подготовке или проверке записей changelog. CX Codex +1 159установок changelog pipecat-ai Автоматически генерирует файлы changelog для значимых коммитов в PR. CX Codex +1 ★ 17 367звёзд репо changelog JetBrains Скилл changelog поддерживает CHANGES.md проекта IdeaVim: собирает заметки о релизах, проверяет коммиты и PR и оформляет изменения для пользователей. CX Codex +1 ★ 10 292звёзд репо utility-pm-changelog-curator product-on-purpose Скилл utility-pm-changelog-curator собирает черновик CHANGELOG из git log и проверяет правила оформления. Подходит для подготовки релиза и накопления ещё не опубликованных изменений. CX Codex +1 683установок changelog-draft dominikmartn Скилл changelog-draft для Claude Code собирает черновик чейнджлога по PR, слитым в диапазон релиза: явные маркеры CHANGELOG, категории для остальных, атрибуция внешних авторов. CX Codex +1 ★ 720звёзд репо changelog-automation Seth Hobson Скилл changelog-automation для Claude Code собирает changelog и release notes из коммитов, PR и релизов. Настраивает процесс релизов и единые правила коммитов. CX Codex +1 13 733установок changelog-writing Samuel Berthe Скилл changelog-writing превращает коммиты, пул-реквесты и тикеты в релиз-ноты, которые читают: что вышло, что это значит на практике и что ломается. CX Codex +1 13 400установок app-store-changelog Dimillian Скилл app-store-changelog для Claude Code, Codex, Cursor и других агентов собирает коммиты с последнего git-тега и превращает их в пользовательские заметки для App Store. CX Codex +1 1 400установок changelog-writer patricio0312rev Скилл changelog-writer собирает CHANGELOG и release notes из git-коммитов, заголовков PR и ссылок на issues. Пригодится перед релизом, когда нужно разложить изменения по типам и подобрать версию. CX Codex +1 631установок

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

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

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