release-notes

Generate Markdown release notes from Git history between two refs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Nymbo/Skills --skill release-notes-nymbo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-notes
Source: https://github.com/Nymbo/Skills/tree/main/release-notes
Command: npx skills add https://github.com/Nymbo/Skills --skill release-notes-nymbo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Drafts accurate, scannable release notes and changelogs from Git history between two refs, including breaking changes, migrations, and upgrade steps.

Core Features & Use Cases

  • Range-based summaries: Capture changes between two refs.
  • Categorization: Highlights, breaking changes, features, fixes, docs, dependencies, infra.
  • Template-based output: Consistent release notes format.

Quick Start

Provide release version + date and a range like from_ref..to_ref; the tool outputs a ready-to-paste Markdown release notes block.

Frequently Asked Questions about release-notes

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

FAQPage Schema
How do I generate release notes from Git history?

Release notes can be drafted automatically from Git history between two refs—tags, SHAs, or branches. Provide a version, date, and range like `from_ref..to_ref`; the tool parses commits and first-parent merges, categorizes changes, and outputs ready-to-paste Markdown with breaking changes, features, fixes, and upgrade guidance.

Can I categorize changes like breaking changes and features in my changelog?

Yes. The tool categorizes Git commits into highlights, breaking changes, features, fixes, performance improvements, security updates, deprecations, docs, and dependencies. It identifies breaking changes and migrations automatically, then generates Markdown with structured sections for each category.

What information does a generated release note include?

Generated release notes include categorized changes, breaking changes with migration steps, upgrade and rollback instructions, feature summaries, fixes, security and performance updates, dependency changes, and documentation updates—all formatted in consistent, scannable Markdown ready to publish.

Do I need to manually format release notes after generation?

No. The tool applies a stable template and outputs release notes as ready-to-paste Markdown. You provide the version, date, and Git range; the tool handles parsing, categorization, and formatting to meet functional requirements for end users, developers, and internal ops.

What Git scenarios does this support?

The tool handles any release range defined by Git tags, SHAs, or branches. It parses first-parent merges and commits, supports complex scenarios like multi-branch releases, and generates notes suitable for major/minor/patch versions with appropriate breaking change and upgrade guidance.

Can this tool work with monorepos or multiple services?

The tool processes Git history between any two refs, making it adaptable to monorepos, microservices, or single-repo releases. Range-based filtering by ref lets you target specific branches or tags across your Git structure, though filtering by service or package requires custom upstream parsing.