ralphctl: Skill for Claude Code

Release

End-to-end release flow for lukas-grigis/ralphctl. Mirrors the established release pattern: branch → bump → changelog → PR → CI → merge → tag → workflow.

Arg

• <version> — semver, no v prefix (e.g. 0.4.5, 1.0.0-rc.1). Reject anything that doesn't match ^\d+\.\d+\.\d+(-[A-Za-z0-9.-]+)?$.

Pre-flight (stop on any failure — don't try to recover)

git rev-parse --abbrev-ref HEAD                   # must be `main`
[ -z "$(git status --porcelain)" ]                # working tree clean
git fetch origin && git pull --ff-only origin main
node -p "require('./package.json').version"       # must be < <version>

If any check fails, surface the exact problem and stop. Don't stash, don't switch branches, don't auto-fix — the user wants to know.

## [Unreleased] auto-draft

Check whether ## [Unreleased] has content. Grab the body between that heading and the next ## [ heading:

awk '/^## \[Unreleased\]/{flag=1;next} /^## \[/{flag=0} flag' CHANGELOG.md | sed '/^$/d'

If empty, auto-draft entries from the commit range since the last tag, skipping contributor-side tooling that isn't shipped to npm (.claude/**, .github/**, CHANGELOG.md, CLAUDE.md):

LAST_TAG="$(git describe --tags --abbrev=0)"
git log --no-merges --pretty='- %s' "${LAST_TAG}..HEAD" -- \
  ':!.claude' ':!.github' ':!CHANGELOG.md' ':!CLAUDE.md'

Group the surviving commit subjects by conventional-commit prefix into ### Added (feat:), ### Fixed (fix:), ### Changed (refactor: / perf: / user-facing chore:). Write the result under ## [Unreleased] in CHANGELOG.md (edit only — don't commit yet; the release commit in step 5 picks it up).

If the filtered git log is also empty, there's nothing user-facing to release — stop and tell the user. Don't promote an empty section; release.yml hard-fails on a missing or empty ## [<version>] section (there is no fallback), so the workflow would die after the tag is already public.