skills-lock

release-helper

Use when preparing a new tagged release of skil-lock. Inspects recent commits since the last tag, drafts release notes against the conventional-commit prefixes in this repo (feat, fix, build, docs, test, chore), and shows the version bump that GoReleaser will apply. Does not push tags or publish releases — those steps stay manual.

skills-lock 3 Updated 3mo ago
GitHub

Install

npx skillscat add skills-lock/skil-lock/release-helper

Install via the SkillsCat registry.

About this skill

This skill inspects commits since the last tag in the skil-lock repository, groups them by conventional-commit prefixes, and drafts release notes matching the existing changelog format. It helps developers prepare tagged releases by showing the proposed version bump and release content without pushing tags or publishing. Use it from the repository root before manually tagging a release.

SKILL.md

release-helper

Helper for cutting a new tagged release. Surfaces the commits the
release would include and drafts notes in the same format the existing
GitHub release pages use.

When to use

Invoke this skill from ~/Projects/skil-lock/ (the repository root)
just before tagging a release. The skill is read-only with respect to
the repository; it never modifies tracked files.

What it does

  1. Find the previous tag:
git describe --tags --abbrev=0
  1. List the commits since then:
git log "${PREV_TAG}..HEAD" --pretty=format:'%h %s'
  1. Group commits by conventional-commit prefix (feat:, fix:,
    build:, docs:, test:, chore:) into a draft markdown
    document.

  2. Read the existing changelog so the draft slots in cleanly:

cat CHANGELOG.md
  1. Print the proposed next tag based on the prefixes seen
    (fix: only → patch bump; feat: present → minor bump;
    anything labeled BREAKING CHANGE: → major bump).

What it does not do

  • Never runs git tag, git push, or gh release create — those
    remain manual so a human reviews the draft.
  • Does not touch the .goreleaser.yml file.
  • Does not call any external network endpoint.

Constraints for the agent

Run only the commands listed above (git describe, git log,
cat CHANGELOG.md). Do not interpret unrelated arguments; if the user
asks for something outside the scope of preparing a release draft,
ask them to clarify instead of running additional shell commands.

Categories