changelog · shpigford — скилл для Claude Code: что делает и как установить
Составляет понятный пользователям список изменений по закрытым PR и добавляет его прямо в статическую страницу site/changelog.html.
MIT 135 установок ★ 653 обновлён 2026-11-02
npx skills add Shpigford/nurb --skill changelog -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/changelog/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/changelog/
1Через Skills CLI (Vercel)
npx skills add Shpigford/nurb --skill changelog -a codex2Вручную: положить файлы
.agents/skills/changelog/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Shpigford/nurb --skill changelog -a cursor2Вручную: положить файлы
.cursor/skills/changelog/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Shpigford/nurb .claude/skills/changelog2Вручную: положить файлы
.github/skills/changelog/SKILL.md1Через Skills CLI (Vercel)
npx skills add Shpigford/nurb --skill changelog -a gemini-cli2Командой платформы
gemini skills install https://github.com/Shpigford/nurb --path .claude/skills/changelogВручную: положить файлы
.devin/skills/changelog/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Shpigford/nurb --skill changelog -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.