Skip to content

docs: add a release skill - #65

Merged
frantufro merged 1 commit into
mainfrom
docs/release-skill
Aug 29, 2026
Merged

docs: add a release skill#65
frantufro merged 1 commit into
mainfrom
docs/release-skill

Conversation

@frantufro

Copy link
Copy Markdown
Owner

Adds .claude/skills/release/SKILL.md, alongside the existing rust-dev,
rust-review and git-merge skills.

It documents the release as it actually runs today: the four files that carry
the version and the verify job that compares them to the tag, the local gate,
the rebase-only merge, the tag push, and what each job in release.yml
produces.

It also records the things that are only obvious once you have hit them:

  • --squash fails on this repository; rebase is the only merge mode.
  • The .sha256 sidecars are consumed by both skulk update and
    bin/install.mjs, so a packaging change has to keep emitting them.
  • The npm OIDC trust configuration has to be registered on the package's web
    access page, because the npm trust CLI on npm 11.x is rejected with an
    empty 400.
  • A version spent on a failed release can never be republished, so the
    recovery is a new patch.
  • The packument lags the registry write path, so a fresh publish can look
    missing for minutes.

CONTRIBUTING.md keeps its release checklist. The skill is the long form for
an agent driving the release.

@frantufro
frantufro merged commit 9ecfba8 into main Aug 29, 2026
6 checks passed
@frantufro
frantufro deleted the docs/release-skill branch August 29, 2026 16:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant