github-releases

Creates GitHub releases with semver versioning, tagging, and curated release notes.

Updated Jul 25, 2026
One-click install
npx skills add https://github.com/RorySullivan1/powerapp_taskmaster --skill github-releases-rorysullivan1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-releases
Source: https://github.com/RorySullivan1/powerapp_taskmaster/tree/main/.claude/skills/github-releases
Command: npx skills add https://github.com/RorySullivan1/powerapp_taskmaster --skill github-releases-rorysullivan1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cutting a release involves error-prone decisions: picking the right semver bump, tagging the correct commit, and writing notes that tell users whether to upgrade. This Skill guides the full release workflow so version numbers stay honest and notes stay useful. ## Core Features & Use Cases - Semver decision support: Chooses major, minor, or patch bumps based on the nature of changes, including Conventional Commits signals and pre-release labeling. - Tag and release mechanics: Reads current state via GitHub MCP tools (list_releases, get_latest_release, list_tags) and creates releases with gh release create or the REST API, with draft and pre-release handling. - Release notes authoring: Structures notes with Keep a Changelog sections, breaking-change call-outs, migration steps, and curated highlights instead of raw auto-generated lists. - Use Case: After merging a sprint of PRs, ask for the next version and a drafted release — the Skill inspects existing tags, proposes v1.5.0, and drafts grouped notes with upgrade guidance. ## Quick Start Ask the assistant to draft the next GitHub release for this repository, including the version number, tag, and release notes based on recently merged pull requests.

Frequently Asked Questions about github-releases

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

FAQPage Schema
How do I decide between a major, minor, or patch version bump?▼

Choose based on the nature of the change, not its size. Breaking changes require a major bump, new backward-compatible features a minor, and backward-compatible fixes a patch. Conventional Commits can derive this automatically: `!` or BREAKING CHANGE means major, `feat:` minor, `fix:` patch.

How do I create a GitHub release from the command line?▼

Use `gh release create v1.5.0 --title "..." --notes-file notes.md`, adding `--prerelease`, `--draft`, or `--target <sha>` as needed. Read existing state first with `list_releases` and `list_tags` to match tag conventions.

Should I use GitHub auto-generated release notes?▼

Auto-generated notes are a starting draft, not a final product. A flat list of commit titles buries what users need, so curate them into highlights, group by Keep a Changelog sections, and call out breaking changes with migration steps.

Can I edit or move a tag after publishing a release?▼

No. Never move or delete a published tag, because people and build systems pin to it. Fix forward by publishing a new patch version instead of mutating a release that downstream users already pulled.

How do I publish a pre-release on GitHub without affecting latest?▼

Append a label to the version such as `2.0.0-rc.1` and mark the release as a pre-release with the `--prerelease` flag. This prevents the untested build from appearing as the "Latest" release for users pinning to it.