# Rust Release

> Rust release workflow for version bumps, changelogs, tags, cargo package, crates.io publishing, release-plz, cargo-dist, checksums, binaries, SBOMs, safeguards, and post-release verification. Use when this capability is needed.

- Skill: `tomevault-io/rust-release` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/rust-release`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/rust-release/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/rust-release

---


# Rust Release

## Rule

Validate before publishing and require explicit approval for irreversible operations.

## Hard Stops

Stop before:

- Tagging, publishing to crates.io, pushing release pages, signing artifacts, uploading
  binaries, publishing containers, or using credentials.
- Releasing from a dirty tree or with failing validation unless explicitly approved.
- Adding `release-plz`, `cargo-dist`, signing, SBOM, or provenance automation without
  approval.
- Publishing public crates without checking SemVer and package contents.

## Defaults

- Run full validation, inspect `cargo package`, and keep generated artifacts out of git.
- Use `cargo semver-checks` for public library crates when configured or before publishing.
- Use `release-plz` for crate release PRs/changelogs/version bumps when approved.
- Use `cargo-dist` for binary distribution when cross-platform installers/artifacts are
  needed and approved.
- Generate checksums for binary artifacts; add signing/SBOM/provenance only when policy
  requires it.
- Start new automation with dry runs.

## Workflow

1. Inspect version policy, changelog, git state, CI, crate metadata, features, and release
   targets.
2. Confirm target version and publish targets.
3. Run `just check`, package/build/doc checks, semver checks when relevant, and
   `cargo package --list`.
4. Build artifacts in ignored directories and inspect contents.
5. Ask before tagging, publishing, signing, or uploading.
6. Verify published crates or artifacts when approved.

## Completion

Report target version, files changed, artifacts, package checks, tag/publish actions
performed or skipped, and verification results.

---
> Source: [nyquistwilder/personal-pi](https://github.com/nyquistwilder/personal-pi) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->

