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

changelog · itechmeat — скилл для Claude Code: CHANGELOG.md по Keep a Changelog

Скилл задаёт структуру CHANGELOG.md по Keep a Changelog 1.1.0: разделы Added/Changed/Fixed, заголовки версий, даты ISO 8601 и ссылки на сравнения.

MIT 192 установок ★ 23 обновлён 2026-10-24

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

Что делает changelog

Скилл описывает, как агент должен писать CHANGELOG.md: шесть разделов для записей (Added, Changed, Deprecated, Removed, Fixed, Security), заголовок версии вида ## [X.Y.Z] - YYYY-MM-DD, даты в ISO 8601 и блок [Unreleased] для того, что ещё не вышло. В конце файла — ссылки на сравнение версий.

Отдельная часть посвящена тому, что портит changelog: свалки из git log, даты вроде 01/02/2024, пропущенные пометки об устаревании, пустые заголовки разделов. Записи начинаются с глагола, называют затронутый компонент и несут номер задачи вроде (#123). Есть таблица соответствия Conventional Commits: feat: идёт в Added, fix: в Fixed. Из генераторов названы conventional-changelog, semantic-release и release-please.

Английский здесь обязателен: любая запись переводится на английский, смешивать языки в одном файле нельзя. Имя файла тоже фиксировано — заглавный CHANGELOG.md. Если команда привыкла вести changelog по-русски, скилл это сломает.

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

  • Завести CHANGELOG.md с нуля по спецификации
  • Разложить изменения релиза по шести разделам
  • Проставить версии и даты ISO 8601 без путаницы в региональных форматах
  • Пометить отозванный релиз как [YANKED]
  • Связать коммиты Conventional Commits с разделами файла

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

  • Обнови CHANGELOG.md: перенеси изменения с последнего тега в [Unreleased], новые фичи — в Added.
  • Готовь релиз 1.2.0: добавь заголовок ## [1.2.0] - 2024-01-20 и ссылки на сравнение в конец файла.
  • Переведи записи в CHANGELOG.md на английский и приведи даты к ISO 8601.

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

1Через Skills CLI (Vercel)

npx skills add itechmeat/llm-code --skill changelog -a claude-code

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

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

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

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

Вопросы о changelog

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

Выполните npx skills add itechmeat/llm-code --skill changelog -a claude-code. Скилл появится в ~/.claude/skills/changelog/SKILL.md.

Что делает changelog?

Даёт агенту письменную спецификацию CHANGELOG.md: типы разделов, формат заголовка версии, даты ISO 8601, ссылки на сравнения и правила хорошей записи.

Зачем он, если есть GitHub Releases?

Релизы на GitHub дополняют файл, но не заменяют его. CHANGELOG.md лежит в репозитории, переносится вместе с ним и не привязан к одной платформе.

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

SKILL.md · MIT
---
name: changelog
description: "Keep a Changelog format. Covers structure, change types, versioning. Use when creating or updating CHANGELOG.md files following the Keep a Changelog specification, or applying semver-compatible changelog conventions. Keywords: CHANGELOG.md, semver, Keep a Changelog."
metadata:
  version: "1.1.0"
  release_date: "2023-03-06"
---

# Changelog

Format specification for CHANGELOG.md based on Keep a Changelog 1.1.0.

## Language Requirement (Mandatory)

- All changelog content MUST be written in English.
- If source information is provided in another language, translate it to English.
- Do not mix languages within the same changelog.

## Quick Reference

### File Header

```markdown
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
```

### Section Structure

```markdown
## [Unreleased]

### Added

- New feature description

## [1.0.0] - 2024-01-15

### Added

- Feature A
- Feature B

### Changed

- Modified behavior X

### Fixed

- Bug fix Y
```

## Types of Changes

| Type         | Purpose                           |
| ------------ | --------------------------------- |
| `Added`      | New features                      |
| `Changed`    | Changes in existing functionality |
| `Deprecated` | Soon-to-be removed features       |
| `Removed`    | Now removed features              |
| `Fixed`      | Bug fixes                         |
| `Security`   | Vulnerabilities                   |

## Format Rules

### Version Header

```markdown
## [X.Y.Z] - YYYY-MM-DD
```

- Version in brackets, linked to comparison
- Date in ISO 8601 format (YYYY-MM-DD)

### Date-Based Versioning (Alternative)

For projects using date-based versioning instead of semver:

```markdown
## [YYYY-MM-DD]
```

Use current date instead of `[Unreleased]`. This project uses date-based versioning.

### Yanked Releases

```markdown
## [0.0.5] - 2014-12-13 [YANKED]
```

Use when version was pulled due to serious bug or security issue.

### Comparison Links (at file end)

```markdown
[unreleased]: https://github.com/user/repo/compare/v1.0.0...HEAD
[1.0.0]: https://github.com/user/repo/compare/v0.9.0...v1.0.0
[0.9.0]: https://github.com/user/repo/releases/tag/v0.9.0
```

## Guiding Principles

1. **For humans, not machines** — Write clear, readable entries
2. **Entry for every version** — Document all releases
3. **Group same types** — Keep Added/Changed/Fixed together
4. **Linkable versions** — Use comparison links
5. **Latest first** — Reverse chronological order
6. **Show release dates** — Use ISO 8601 format
7. **State versioning scheme** — Mention Semantic Versioning if used

## Complete Example

```markdown
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

- New authentication method

## [1.2.0] - 2024-01-20

### Added

- User profile page
- Export to CSV functionality

### Changed

- Improved loading performance by 40%

### Deprecated

- Legacy API endpoint `/api/v1/users` (use `/api/v2/users`)

### Fixed

- Login timeout issue on slow connections

## [1.1.0] - 2024-01-10

### Added

- Dark mode support

### Security

- Fixed XSS vulnerability in comment field

## [1.0.0] - 2024-01-01

### Added

- Initial release with core features
- User registration and login
- Dashboard with analytics

[unreleased]: https://github.com/user/project/compare/v1.2.0...HEAD
[1.2.0]: https://github.com/user/project/compare/v1.1.0...v1.2.0
[1.1.0]: https://github.com/user/project/compare/v1.0.0...v1.1.0
[1.0.0]: https://github.com/user/project/releases/tag/v1.0.0
```

## Bad Practices

### Commit log diffs

**Don't** dump git log into changelog:

- Full of noise (merge commits, obscure titles)
- Not human-readable
- Mixes important and trivial changes

### Ignoring deprecations

**Don't** skip deprecation notices:

- Users need to know what will break
- Document deprecations before removals
- List breaking changes clearly

### Confusing dates

**Don't** use regional date formats:

- Use ISO 8601: `YYYY-MM-DD`
- Avoids ambiguity (is 01/02/2024 Jan 2 or Feb 1?)

### Inconsistent changes

**Don't** document only some changes:

- Changelog should be single source of truth
- Important changes must be mentioned
- Consistently updated

## Writing Tips

### Good Entry Examples

```markdown
### Added

- OAuth2 authentication with Google and GitHub providers
- Rate limiting for API endpoints (100 req/min)

### Changed

- Database queries now use prepared statements for better security
- Upgraded dependency `lodash` from 4.17.20 to 4.17.21

### Fixed

- Memory leak in WebSocket connection handler
- Race condition in concurrent file uploads
```

### Entry Guidelines

- Review current git changes (diff or changed files list) before drafting; ensure all material changes are covered.
- Start with verb or noun describing the change
- Be specific (mention affected component/endpoint)
- Reference issue/PR numbers when relevant: `(#123)`
- Keep entries concise but informative
- Omit empty sections (do not include a section header if there are no entries for it)

## File Naming

Required: `CHANGELOG.md` (uppercase). Do not use lowercase or alternative names.

Do not use alternative filenames.

## GitHub Releases vs CHANGELOG.md

| Aspect          | GitHub Releases | CHANGELOG.md      |
| --------------- | --------------- | ----------------- |
| Portability     | GitHub-only     | Universal         |
| Discoverability | Less visible    | Standard location |
| Version control | Separate UI     | In repository     |
| Diff links      | Manual setup    | Easy to add       |

GitHub Releases can complement but shouldn't replace CHANGELOG.md.

## Conventional Commits Integration

Changelogs work best with [Conventional Commits](../commits/SKILL.md) format:

| Commit Type       | Changelog Section    |
| ----------------- | -------------------- |
| `feat:`           | Added                |
| `fix:`            | Fixed                |
| `perf:`           | Changed              |
| `refactor:`       | Changed              |
| `docs:`           | (often omitted)      |
| `BREAKING CHANGE` | Highlight in Changed |
| Security fix      | Security             |
| `revert:`         | Removed or Fixed     |

### Automated Generation

Tools that parse Conventional Commits and generate changelogs:

- [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog)
- [semantic-release](https://semantic-release.gitbook.io/)
- [release-please](https://github.com/googleapis/release-please)

See [commits skill](../commits/SKILL.md) for commit message format.

## Workflow Integration

### Unreleased Section Pattern

1. Add changes to `## [Unreleased]` during development
2. At release time, rename to `## [X.Y.Z] - YYYY-MM-DD`
3. Create new empty `## [Unreleased]` section
4. Add comparison link for new version

### Pre-commit Checklist

Before release:

- [ ] All notable changes documented
- [ ] Unreleased section moved to version
- [ ] Date added in ISO 8601 format
- [ ] Comparison link added
- [ ] Breaking changes highlighted
- [ ] Deprecations documented

## Critical Prohibitions

- Do not use git log as changelog
- Do not omit breaking changes or deprecations
- Do not use ambiguous date formats
- Do not leave changelog inconsistently updated
- Do not forget to update Unreleased → version at release
- Do not write changelog entries in any language other than English

## README Synchronization

After writing changelog, review the project's main README.md:

1. **Check for outdated information** — features, skills, tools lists
2. **Add new entries** — if changelog introduces new skills, features, or components
3. **Remove deprecated items** — if changelog removes functionality
4. **Update descriptions** — if changelog changes existing functionality

**What to sync:**

- Skills/features tables
- Compatibility lists
- Installation instructions
- Links and references

**What NOT to sync:**

- Changelog content itself (no duplication)
- Version history
- Detailed change descriptions

**Do NOT mention README.md updates in CHANGELOG** — README synchronization is implied and should not be logged as a separate change.

## Links

- Official specification: https://keepachangelog.com/en/1.1.0/
- Semantic Versioning: https://semver.org/spec/v2.0.0.html
- Related: [commits skill](../commits/SKILL.md) — Conventional Commits format

## Templates

- [CHANGELOG.template.md](assets/CHANGELOG.template.md) — Empty template to start
- [CHANGELOG.example.md](assets/CHANGELOG.example.md) — Complete working example

© itechmeat · MIT · itechmeat/llm-code

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

Все скиллы по теме «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 Shpigford Составляет понятный пользователям список изменений по закрытым PR и добавляет его прямо в статическую страницу site/changelog.html. CX Codex +1 135установок changelog chrisbanes Сверяет заметки к релизу с историей Git и подтверждениями из задач и PR. Запускается при подготовке или проверке записей changelog. CX Codex +1 159установок changelog pipecat-ai Автоматически генерирует файлы changelog для значимых коммитов в PR. CX Codex +1 ★ 17 367звёзд репо add-to-changelog davila7 Команда add-to-changelog для Claude Code, которая добавляет запись в CHANGELOG.md по формату Keep a Changelog. Принимает версию, тип изменения и описание прямо в аргументах. CX Codex +1 277установок changelog-maintenance aj-geddes Скилл changelog-maintenance помогает агенту писать и поддерживать CHANGELOG.md по формату Keep a Changelog: разделы Added, Changed, Fixed, Security и отметки о ломающих изменениях. CX Codex +1 503установок changelog-writer patricio0312rev Скилл changelog-writer собирает CHANGELOG и release notes из git-коммитов, заголовков PR и ссылок на issues. Пригодится перед релизом, когда нужно разложить изменения по типам и подобрать версию. CX Codex +1 631установок changelog-generator Alireza Rezvani Скилл changelog-generator для Claude Code формирует заметки к релизу из Conventional Commits и определяет следующий SemVer-бамп. Запускается при подготовке релиза, проверке сообщений коммитов и планировании hotfix. CX Codex +1 618установок ai-changelog sammcj Скилл ai-changelog внедряет в репозиторий систему ведения CHANGELOG.md силами ИИ-агентов. Поддерживает SemVer, CalVer и датированные записи для проектов без сборщика. CX Codex +1 ★ 173звёзд репо Changelog Generator claude-office-skills Скилл Changelog Generator группирует коммиты и списки правок в готовые описания релизов. Пригодится разработчикам и лидам перед публикацией новой версии проекта. CX Codex +1 4 800установок

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

Весь набор →
social-writer Скилл social-writer для Claude Code и Codex готовит посты и треды для X, LinkedIn, Threads, Instagram и Facebook. Он помогает выбрать формат и соблюдать стиль площадки. CX Codex +1 270установок base-ui Скилл обучает ИИ-ассистента собирать доступные UI-компоненты на базе @base-ui/react, настраивать оверлеи и работать с паттерном render prop. CX Codex +1 238установок refine-dev Скилл refine-dev по Refine: агент знает, как связать data provider, ресурсы и хуки, чтобы собрать админку на React поверх REST, GraphQL, Supabase или Strapi. CX Codex +1 210установок vitest Помогает писать и настраивать тесты Vitest: моки, снимки, покрытие и браузерный режим. Работает с Vite- и TypeScript-проектами. CX Codex +1 202установок makefile Помогает агенту создавать и поддерживать Makefile: правила, переменные, рецепты, проверки и сборку. Автоматизирует команды проекта. CX Codex +1 181установок commits Помогает агенту оформлять Git-коммиты по Conventional Commits с учётом breaking changes. Формат используют для changelog и SemVer. CX Codex +1 178установок skill-master Скилл skill-master для Claude и других агентов: помогает писать, проверять и сравнивать Agent Skills по спецификации agentskills.io — от структуры папок до замеров срабатывания. CX Codex +1 161установок openapi Скилл подсказывает ИИ-агенту структуру документов OpenAPI 3.x: обязательные поля, операции, схемы, параметры и безопасность. CX Codex +1 125установок

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

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