create-release-version
Create or update a release version entry in version.md. Use when drafting a new version, cutting a release, or when the user asks to create or update release notes.
SKILL.md.claude/skills/create-release-version/SKILL.md
GitHubCreate release version
Release note structure
Every version entry in version.md must include at least one of ## Added or ## Changed.
# X.Y
## Added
- short description
## Changed
- short description
# X.Y— Version as H1 (two parts, e.g.0.67; release tags arevX.Y). Must be the very first line of the block.- No
# NEXT. A feature branch writes the real next version from the start (main's first heading + 1) and renumbers only if another PR takes that number first (nightlysteps 4 and 7). CI fails on# NEXT, andmainnever carries it. ## Added— New features. Omit if nothing added.## Changed— Behavior/UI changes. Omit if nothing changed.
Content guidelines: User-facing changes only. Skip internal refactors unless they affect behavior. One bullet = one line. Keep it short.
Instructions
- Add a new H1 block at the top of version.md (above existing versions).
- Every version needs at least one of
## Addedor## Changed. No empty sections. - Initial release:
## Addedwith one sentence describing what the app does. No## Changed. - Later releases: use whichever sections apply. One line per change is fine.
Example: initial release
# 0.1
## Added
- Initial release. Tag-based file reviewer: play clips, assign tags, rename files.
Example: later release
# 0.61
## Added
- Click empty window to open file picker.
## Changed
- Migrations consolidated into a single initial schema.
File
- version.md — Single file at repo root. Prepend new version blocks; keep older versions below.
- The GitHub Actions release workflow reads the first line (
# VERSION) to determine the release tag.