new-release - SKILL.md Agent Skill

name: new-release description: Creates a GitHub pre-release for Oinkoin with a tag, release name, and bullet-point changelog. Use when the user wants to ship a new version. argument-hint: ""

Skill: new-release

Create a pre-release on GitHub for the given version.

Usage

/new-release 1.9.0

Steps

Step 1 — Confirm the version

The version comes from the skill argument (e.g. 1.9.0). If the user didn't provide one, ask for it before continuing.

Step 2 — Find the previous release tag

gh release list --limit 10

Identify the most recent non-draft, non-pre-release tag to use as the comparison base.

Step 3 — Collect commits since the previous tag

git log <previous-tag>..HEAD --oneline

Step 4 — Draft the changelog with the user

From the commit list, propose a set of bullet points that summarise the user-facing changes. Rules:

Each bullet must be under 100 characters (including the leading - )
Skip internal/chore commits (version bumps, CI, typos) unless they matter to users
Group related commits into a single bullet when it reads more clearly
Write in plain English, present tense ("Add X", "Fix Y", "Improve Z")
Show the draft to the user and ask for approval or edits before creating the release

Step 5 — Create the tag and pre-release

Once the user approves the changelog:

# Create and push the tag
git tag <version>
git push origin <version>

# Create the pre-release
gh release create <version> \
  --title "<version>" \
  --notes "<approved bullet points>" \
  --prerelease

Step 6 — Confirm

Print the release URL returned by gh release create so the user can review it on GitHub.