Skip to main content
skill CX Codex

release-notes · justxor — Claude Code skill: what it does, how to install

Generates release notes and CHANGELOG entries between Git tags or from the latest tag to HEAD using Conventional Commits.

MIT ★ 353 updated 2026-10-01

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add justxor/claude-code-pro-course --skill release-notes -a claude-code
Open on GitHub

What release-notes does

This skill extracts commit history with git log excluding merge commits across a given range. When you omit tag arguments, it determines the starting tag automatically via git describe --tags --abbrev=0 and targets HEAD.

Entries are classified by Conventional Commits types. Breaking changes are placed at the very top, followed by features, fixes, and performance updates. Secondary tasks such as chore, docs, and ci get condensed into a single line. The skill translates raw commit messages into user-facing product updates.

Whenever CHANGELOG.md exists in the project, the skill offers to prepend the new section following Keep a Changelog conventions. Repositories without tags require passing explicit commit bounds directly.

What it helps with

  • generate release notes between two Git tags
  • translate technical commit messages into user updates
  • isolate breaking changes into an upfront warning section
  • prepend a release block into an existing CHANGELOG.md

Example prompts for the agent

  • Draft release notes from the latest tag
  • Generate a changelog between tags v1.2.0 and v1.3.0
  • Review unreleased commits and update CHANGELOG.md

How to install release-notes

1Skills CLI (Vercel)

npx skills add justxor/claude-code-pro-course --skill release-notes -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/release-notes/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about release-notes

How to install release-notes in Claude Code?

Run npx skills add justxor/claude-code-pro-course --skill release-notes -a claude-code or save the skill file directly to ~/.claude/skills/release-notes/SKILL.md.

What does the release-notes skill do?

It parses commit history via Git, sorts items by Conventional Commits conventions, and crafts readable changelogs for end users.

Which tools does the skill require?

It needs Bash execution permissions for git log, git tag, and git describe, along with file Read and Edit access.

Source text

SKILL.md · MIT
---
name: release-notes
description: Генерирует release notes / CHANGELOG между двумя тегами или от последнего тега. Используй, когда просят release notes, changelog или список изменений релиза.
allowed-tools: Bash(git log:*), Bash(git tag:*), Bash(git describe:*), Read, Edit
argument-hint: "[от-тега] [до-тега]"
---

# Release notes

Диапазон: `$ARGUMENTS` (если пусто — от последнего тега `git describe --tags --abbrev=0` до HEAD).

1. `git log <от>..<до> --pretty=format:'%h %s (%an)' --no-merges`
2. Сгруппируй по типам Conventional Commits:
   - ✨ Новое (`feat`)
   - 🐛 Исправления (`fix`)
   - ⚡ Производительность (`perf`)
   - ♻️ Рефакторинг и прочее (`refactor`, `chore`, `docs`, `ci`) — кратко, одной строкой
   - 💥 **Breaking changes** (`!` или `BREAKING CHANGE`) — всегда первым блоком
3. Переписывай технические сообщения на язык пользователя: что изменилось для него.
4. Если есть `CHANGELOG.md` — предложи добавить секцию сверху (формат Keep a Changelog).

© justxor · MIT · justxor/claude-code-pro-course

Similar skills

All skills for Git and GitHub →

release-notes by other authors comes first.

release-notes phuryn release-notes is a Claude Code skill that turns tickets and internal change logs into user-facing release notes. It runs for release write-ups and summaries of shipped updates. CX Codex +1 3,100installs release-notes anyproto Automates writing and updating release notes in whatsNew.ts with entries for features, improvements, and bug fixes. Pulls data from conversation context, git branches, or Linear issues. CX Codex +1 ★ 9,124repo stars release-notes kenryu42 release-notes updates the body of the latest GitHub Release using code diffs and merged pull requests via the gh command-line tool. CX Codex +1 ★ 2,088repo stars release-notes garrytan release-notes is a Claude Code skill that drafts Lantern release notes from merged PRs. It activates for requests about customer changelogs or what shipped. CX Codex +1 ★ 172repo stars generate-release-notes donnfelker generate-release-notes — a Claude Code skill that turns git history into release notes and changelogs. Parse conventional commits, group them by type, write the result to a file. CX Codex +1 764installs jackin-release-notes jackin-project jackin-release-notes collects PRs since the last tag, assigns Keep a Changelog categories, and updates the [Unreleased] section in CHANGELOG.md. CX Codex +1 469installs release-notes-composer qodex-ai release-notes-composer builds clear release notes and customer-facing changelogs directly from git commit history. CX Codex +1 134installs update-release-notes tldraw update-release-notes — a skill that maintains the release notes file next.mdx in the tldraw repo: collects PRs since the last release and archives next.mdx to a versioned file when a new version ships. CX Codex +1 ★ 51,527repo stars draft-release-notes Cobus Greyling draft-release-notes generates categorized release notes drafts from repository scan data into clean Markdown. Keeps prompt injection safety checks active before you publish. CX Codex +1 ★ 11,819repo stars release-notes-showcase official Kayla Cinnamon release-notes-showcase — a GitHub Copilot plugin that drafts launch-ready release notes with contributor callouts. The output is meant for export, not just an internal changelog. ★ 41,430repo stars

From the same set15

The whole set →
pr-description pr-description generates clear pull request titles and descriptions by inspecting branch commits and diffs against main. CX Codex +1 ★ 353repo stars architect The architect subagent examines a project before implementation, compares design options, and lays out a change plan. Use it to scope a feature or a major refactor. CX Codex ★ 353repo stars code-reviewer code-reviewer reads your diff, flags security holes, missing tests and edge cases, then returns a severity-sorted report with a file and line for each fix. CX Codex ★ 353repo stars write-tests write-tests generates unit tests for a chosen file or function while matching existing project patterns. It runs new checks and flags discovered bugs instead of bending assertions. CX Codex +1 ★ 353repo stars commit This skill reviews your working changes and creates a git commit in Conventional Commits format. Use it when you want an agent to make a commit that follows the repository’s message style. CX Codex +1 ★ 353repo stars refactor Runs refactoring as a sequence of small, behavior-preserving steps. Use it when you ask the agent to split a module or remove duplication. CX Codex +1 ★ 353repo stars onboard The onboard skill gives a new developer a guided introduction to a codebase, from its layout to its main workflows. Use it when someone needs to get oriented and find a first task. CX Codex +1 ★ 353repo stars code-review The code-review skill checks changes in the current branch against main and produces a report with notes on correctness, security, tests, and readability. CX Codex +1 ★ 353repo stars

Project sponsors

Companies that keep this analytics open