release

Draft changelog entries from commits and execute the project's release process.

7|4|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/nklisch/skills --skill release-nklisch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/nklisch/skills/tree/main/plugins/workflow/skills/release
Command: npx skills add https://github.com/nklisch/skills --skill release-nklisch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Releases are often manual, error-prone, and time-consuming: identifying the next version, summarizing commits into a changelog, and invoking the correct release mechanism are repetitive tasks that delay shipping and introduce human mistakes.

Core Features & Use Cases

  • Discover version source: Locates package.json, Cargo.toml, pyproject.toml, version.txt, or similar to read the current version.
  • Detect release mechanism: Finds release scripts, Makefile targets, package scripts, or CI workflows to determine how to publish.
  • Draft and confirm changelog: Summarizes commits since the last tag into categorized changelog entries and requests user approval before writing.
  • Execute release: Runs the discovered release command or creates and pushes tags while reporting the final version and next steps.

Quick Start

Create a patch release by drafting a changelog from commits since the last tag and then run the project's release script after you confirm the draft.

Frequently Asked Questions about release

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

FAQPage Schema
How do I automate changelog drafting from git commits?

To automate changelog drafting from git commits, the skill parses your repository's commit history since the last tag, categorizes the entries, and requests your confirmation before writing the final changelog.

How do I execute a release using a Makefile target or package script?

You can execute a release using a Makefile target or package script by having the skill detect your project's specific release mechanism and run the necessary shell or package-manager commands to tag and publish.

Can I use this to publish a release for a project with a pyproject.toml or Cargo.toml manifest?

Yes, you can use this to publish a release for projects with a pyproject.toml or Cargo.toml manifest because the skill locates and reads these package files to determine the current version before releasing.

What is the best way to determine the next version for a software release?

The best way to determine the next version for a software release is to automatically locate and read your repository's version source files, such as package.json or version.txt, to establish the baseline.

Does the release process require manual confirmation before publishing?

Yes, the release process requires manual confirmation before publishing, as the skill drafts the changelog entries and explicitly requests your approval before executing any tagging or release commands.