How do I install the Changelog skill?

Run npx skillmds@latest add 1t1scool/changelog in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Changelog safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Changelog?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Changelog free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Changelog?

1t1sCooL (@1t1scool) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Changelog by 1t1scool — Agent Skill

Name: Changelog
Author: 1t1sCooL

Changelog

Generate release notes from git history — parses Conventional Commits over a range (default last tag..HEAD), groups by type into human sections (Features/Fixes/Performance/...), drops noise (chore/merge), and outputs a markdown CHANGELOG section that can be prepended to CHANGELOG.md. Use when user says "сгенерируй чейнджлог", "релиз-ноты", "что изменилось с прошлого релиза", "changelog", "release notes", or types /changelog.

1t1sCooL Updated Sep 21, 2026

File contents

Changelog / Release Notes

Собирает релиз-ноты из git-истории: парсит Conventional Commits, группирует по типам в человекочитаемые секции, отбрасывает шум. Умеет печатать текст и допендивать новую секцию сверху в существующий CHANGELOG.md.

Что на входе (`$ARGUMENTS`)

Диапазон v1.2.0..HEAD — явный git-range.
--since <tag> — от тега до HEAD.

Пусто → автоматически последний тег → HEAD:

git describe --tags --abbrev=0   # последний тег; если тегов нет — взять всю историю

Опц. --write — допендить в CHANGELOG.md (иначе только напечатать).

Шаги

Собрать коммиты по диапазону (subject + body для footer'ов):
```
git log <range> --no-merges --pretty=format:'%H%x09%s%x09%b%x1e'
```
Распарсить Conventional Commits type(scope)!: subject и сгруппировать:
- feat → Features
- fix → Bug Fixes
- perf → Performance
- refactor → Refactoring
- docs → Documentation
- прочие типы (build, ci, test, style) → Other (по желанию).
- Пропустить шум: chore, merge-коммиты, бамп версий, мелочь без смысла для читателя.
- Breaking changes (! после типа или BREAKING CHANGE: в body) → отдельная верхняя секция ⚠ BREAKING CHANGES.
- В строке пункта: subject, scope в скобках если есть, короткий хеш. Группировать одинаковые/дублирующиеся.
Сформировать markdown-секцию:
```
## <version> — YYYY-MM-DD

### ⚠ BREAKING CHANGES
- ...

### Features
- **scope:** описание (`abc1234`)

### Bug Fixes
- ...
```
- version: из аргумента/целевого тега; иначе предложить по semver (feat → minor, fix-only → patch, breaking → major) или взять из package.json.
- дата: сегодняшняя (или дата тега).
Вывод/запись.
- Всегда напечатать готовую секцию пользователю.
- При --write: вставить секцию сверху в CHANGELOG.md (после возможного заголовка # Changelog), не трогая старые записи; создать файл с заголовком, если его нет.

Выход

Текст релиз-нот (markdown-секция, готовая к вставке).
При --write — обновлённый CHANGELOG.md (новая секция сверху) + путь к файлу.
Короткая сводка: диапазон, сколько коммитов учтено / отброшено как шум.

---name: changelogdescription: Generate release notes from git history — parses Conventional Commits over a range (default last tag..HEAD), groups by type into human sections (Features/Fixes/Performance/...), drops noise (chore/merge), and outputs a markdown CHANGELOG section that can be prepended to CHANGELOG.md. Use when user says "сгенерируй чейнджлог", "релиз-ноты", "что изменилось с прошлого релиза", "changelog", "release notes", or types /changelog.---# Changelog / Release NotesСобирает релиз-ноты из git-истории: парсит Conventional Commits, группирует по типамв человекочитаемые секции, отбрасывает шум. Умеет печатать текст и допендивать новуюсекцию сверху в существующий `CHANGELOG.md`.## Что на входе (`$ARGUMENTS`)- **Диапазон** `v1.2.0..HEAD` — явный git-range.- **`--since <tag>`** — от тега до `HEAD`.- **Пусто** → автоматически последний тег → `HEAD`: ```bash git describe --tags --abbrev=0 # последний тег; если тегов нет — взять всю историю ```- Опц. `--write` — допендить в `CHANGELOG.md` (иначе только напечатать).## Шаги1. **Собрать коммиты** по диапазону (subject + body для footer'ов): ```bash git log <range> --no-merges --pretty=format:'%H%x09%s%x09%b%x1e' ```2. **Распарсить Conventional Commits** `type(scope)!: subject` и сгруппировать: - `feat` → **Features** - `fix` → **Bug Fixes** - `perf` → **Performance** - `refactor` → **Refactoring** - `docs` → **Documentation** - прочие типы (`build`, `ci`, `test`, `style`) → **Other** (по желанию). - **Пропустить шум:** `chore`, merge-коммиты, бамп версий, мелочь без смысла для читателя. - **Breaking changes** (`!` после типа или `BREAKING CHANGE:` в body) → отдельная верхняя секция **⚠ BREAKING CHANGES**. - В строке пункта: subject, scope в скобках если есть, короткий хеш. Группировать одинаковые/дублирующиеся.3. **Сформировать markdown-секцию:** ```markdown ## <version> — YYYY-MM-DD ### ⚠ BREAKING CHANGES - ... ### Features - **scope:** описание (`abc1234`) ### Bug Fixes - ... ``` - **version**: из аргумента/целевого тега; иначе предложить по semver (feat → minor, fix-only → patch, breaking → major) или взять из `package.json`. - **дата**: сегодняшняя (или дата тега).4. **Вывод/запись.** - Всегда напечатать готовую секцию пользователю. - При `--write`: вставить секцию **сверху** в `CHANGELOG.md` (после возможного заголовка `# Changelog`), не трогая старые записи; создать файл с заголовком, если его нет.## Выход- Текст релиз-нот (markdown-секция, готовая к вставке).- При `--write` — обновлённый `CHANGELOG.md` (новая секция сверху) + путь к файлу.- Короткая сводка: диапазон, сколько коммитов учтено / отброшено как шум.

Frequently asked questions