skills.rest
ehmetlabs
ehmetlabsCOMMUNITY
Explore all skills by this author →
GitHub

release-branch-notes

Create a release branch and generate release notes from the latest Git tag to HEAD.

Updated Aug 27, 2026
Search Tags:#automation#git#changelog#python#branching#release#release-notes
One-click install
npx skills add https://github.com/ehmetlabs/release-branch-notes-skill --skill release-branch-notes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release-branch-notes
Source: https://github.com/ehmetlabs/release-branch-notes-skill/tree/main
Command: npx skills add https://github.com/ehmetlabs/release-branch-notes-skill --skill release-branch-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Create a release branch and generate release notes from the latest tag to HEAD, then update CHANGELOG.md.

Core Features & Use Cases

  • Create a release branch: release/x.y.z
  • Generate release notes from the latest tag
  • Prepend the new section to CHANGELOG.md
  • Notes: A dirty working tree prints a warning but does not abort; Fails fast if the branch already exists or no tags are found; Does not run git commit / git push / git fetch

Quick Start

Run ./scripts/release_branch_notes.py --version 1.2.3 --base main --tag v1.2.2 to create the release branch and update CHANGELOG.md

Frequently Asked Questions about release-branch-notes

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

FAQPage Schema
How do I auto-create a release branch and generate release notes from the latest git tag?▼

To auto-create a release branch and generate release notes, run the script with --version, --base, and --tag parameters. It creates the release branch, generates notes to HEAD, and prepends them to CHANGELOG.md.

What happens if my git working tree is dirty when generating release notes?▼

A dirty git working tree prints a warning but does not abort the release notes generation process. This allows you to proceed with creating the release branch and updating CHANGELOG.md despite uncommitted changes.

Does the release branch creation script automatically commit and push changes?▼

No, the script does not run git commit, git push, or git fetch. It only creates the release branch and updates CHANGELOG.md locally, leaving the actual committing and pushing to the user.

What are the prerequisites for generating release notes from a git tag?▼

Generating release notes requires a git repository with at least one existing tag, or a tag provided via the --tag parameter. The script fails fast if no tags are found or if the target release branch already exists.

How do I specify the base branch and starting tag for release branch creation?▼

Use the optional --base and --tag parameters to specify the base branch and starting git tag for release branch creation. This guides the starting point for generating notes and branching.

Why does release branch creation fail if the branch already exists?▼

Release branch creation fails if the branch already exists to ensure safe, deterministic operation. This prevents overwriting or duplicating existing release branches and maintains repository integrity.

Related Skills

Explore More Software Engineering Skills→
good-ideagood-idea
3

using-git-worktrees

Create Git worktrees for isolated feature development and cleanup optionally deleting branches.

Community
Intermediate
lety-ailety-ai

pr-production

Finalize release candidate versions and create a production pull request from staging to master.

Official
Advanced
mpauloskympaulosky

release-process-base

Automate version bumping, branch merging, tagging, and CI/CD verification for Git-backed releases.

Community
Advanced
BordaBorda
24

release

Generate release notes, changelog entries, and migration guides from git history.

Community
Advanced