release

Installation
SKILL.md

Release

Use this skill for repos that publish from GitHub Releases and want human-written notes instead of GitHub's generated summary.

Guardrails

  • Prefer the repo's default branch from gh repo view; do not guess.
  • Start from a clean working tree. If tracked files are dirty, stop and ask before continuing.
  • If the current branch is not the default branch, stop and ask before switching.
  • Fetch before planning: git fetch origin --tags.
  • Fast-forward the default branch before editing: git pull --ff-only origin <default-branch>.
  • Never force-push the default branch.
  • Never use GitHub generated release notes for this workflow.
  • Always create the release tag with a leading v, for example v0.6.0.
  • Always pin the release to the exact changelog commit SHA with gh release create --target <sha>.
  • If origin/<default-branch> moves after planning or before pushing, stop and regenerate the release plan.

Helper Script

Related skills
Installs
1
Repository
pwrdrvr/ghcrawl
GitHub Stars
14
First Seen
Mar 24, 2026