releaselisted

# Release Skill > **Purpose:** Take a project from "code is ready" to "tagged and ready to push." Pre-flight validation, changelog from git history, version bumps across package files, release commit, annotated tag, and curated release notes. Everything is local and reversible. Publishing (including the GitHub Release page) is CI's job. --- ## Quick Start ```bash $release 1.7.0 # full release: changelog + bump + commit + tag $release 1.7.0 --dry-run # show what would happen, change nothing $release --check # readiness validation only (GO/NO-GO) $release # suggest version from commit analysis ``` --- ## Arguments | Argument | Required | Description | |----------|----------|-------------| | `version` | No | Semver string (e.g., `1.7.0`). If omitted, suggest based on commit analysis | | `--check` | No | Readiness validation only — don't generate or write anything | | `--dry-run` | No | Show generated changelog + version bumps without writing | | `--skip-checks` | No | Skip pre-flight validation (tests, lint) | | `--changelog-only` | No | Only update CHANGELOG.md — no version bumps, no commit, no tag | --- ## Modes ### Default: Full Release `$release [version]` — the complete local release workflow. Steps: pre-flight → changelog → release notes → version bump → user review → write → release commit → tag → guidance. ### Check Mode `$release --check` — standalone readiness validation. Runs all pre-flight checks