create-release-notes

Generate categorized release notes from git history and PR descriptions.

6|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/GeneralJerel/chalk-skills --skill create-release-notes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-release-notes
Source: https://github.com/GeneralJerel/chalk-skills/tree/main/skills/create-release-notes
Command: npx skills add https://github.com/GeneralJerel/chalk-skills --skill create-release-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Release notes are often manual, error-prone, and time-consuming to produce from git history and PR descriptions; this skill automates the generation of clear, user-facing notes from commits and descriptions.

Core Features & Use Cases

  • Generate user-facing release notes from git history and PR descriptions
  • Group changes by impact category (breaking changes, new features, improvements, bug fixes, deprecations, security)
  • Save notes to the project's release notes file in .chalk/docs/product with automatic versioning
  • Use in product planning, marketing communication, and user onboarding

Quick Start

Generate release notes for version v1.2.0 between v1.1.0 and v1.2.0.

Frequently Asked Questions about create-release-notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically generate release notes from git history and PR descriptions?

You can automatically generate release notes by processing git history and PR descriptions between specified version tags, categorizing changes into structured markdown output for user-facing documentation.

Can I group git commits into categories like breaking changes and bug fixes for changelogs?

Yes, you can group commits into changelog categories. The Skill automatically formats notes into Breaking Changes, New Features, Improvements, Bug Fixes, Deprecations, and Security for clear user-facing communication.

How do I specify the version range for generating release notes between two tags?

You specify the version range by providing starting and ending references, such as two previous version tags or a previous tag and HEAD, to filter the relevant git history for release notes generation.

Where are the generated release notes saved in the software project repository?

Generated release notes are saved as markdown files in the project repository, automatically output to the `.chalk/docs/product/` directory with a version number appended to the filename.

Do I need any external dependencies to automate changelog generation from git commits?

No external dependencies are required to automate changelog generation. The Skill operates independently to parse git history and PR descriptions without needing additional component installations.