SkillsAdd

matteocervelli/llms

release

Plan version scope, verify release integrity (commit↔CHANGELOG, tag↔artifacts), generate changelogs, and run full releases.

First seen May 25, 2026

Installation

$ npx skills add matteocervelli/llms --skill release
View on skills.sh ↗ GitHub repository ↗

Summary

  • Plan version scope, verify release integrity (commit↔CHANGELOG, tag↔artifacts), generate changelogs, and run full releases.
  • Use when cutting a release or bumping a version.
  • Trigger on "cut a release", "bump the version", "generate changelog", "release plan", "verify the release".

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

analyzing-release-readiness Similar name
aws/agent-toolkit-for-aws

Trigger a pre-merge release readiness review on a GitHub PR, GitLab MR, or local branch. Use wh…

1.1K installs
running-release-tests Similar name
aws/agent-toolkit-for-aws

Run automated release testing (UI or API) via the AWS DevOps Agent using a pre-configured test …

1.1K installs
sentry-setup-releases Similar name
getsentry/sentry-for-ai

Set up Sentry releases and deploy tracking — tag events with a version and environment, create …

32 installs
write-release-notes Similar name
tldraw/tldraw

Writing release notes articles for tldraw SDK releases. Use when creating new release documenta…

323 installs
update-release-notes Similar name
tldraw/tldraw

Update the release notes file at `apps/docs/content/releases/next.mdx` in the tldraw/tldraw rep…

107 installs
release-skills Similar name
jimliu/baoyu-skills

Universal release workflow. Auto-detects version files and changelogs. Supports Node.js, Python…

24.4K installs

Also in this package

Other skills from matteocervelli/llms · top by installs.

npx skills add matteocervelli/llms
api-test-generator 52 typescript-quality-checker 32 documentation-updater 32 pr-merge 25 design 25 code-reviewer 24 doc-fetcher 24 doc-analyzer 23 unit-test-writer 23 implementation 23

Browse all from matteocervelli/llms

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 25
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsRead, Write, Edit, Bash, Grep, Glob
Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,597 B
  • docs SUMMARY.md 299 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 6 installs

SKILL.md

Release Skill

Unified entry point for all release operations. Delegates to the right subcommand template based on the first argument.

Subcommands

Command What it does
/release plan Scope version, analyze milestones/issues/tags, create GitHub milestone
`/release verify [commits\ tags\ history]` Integrity checks: commit↔CHANGELOG, tag↔releases↔artifacts, history audit
/release changelog Generate CHANGELOG entries + version bump propagation across manifest files
/release full Full orchestrator: plan → health → fix blockers → docs → tag+ship
/release Auto-detect what's needed (see below)

Auto-Detection (no subcommand)

LAST_TAG=$(git describe --tags --abbrev=0 --match "v*" 2>/dev/null)
UNRELEASED=$(git log --no-merges --oneline "${LAST_TAG:-$(git rev-list --max-parents=0 HEAD)}..HEAD" | wc -l)
OPEN_MILESTONE=$(gh api "repos/$(gh repo view --json nameWithOwner --jq '.nameWithOwner')/milestones" \
  --jq '[.[] | select(.state=="open")] | length' 2>/dev/null || echo 0)
CLOSED_ISSUES=$(gh api "repos/$(gh repo view --json nameWithOwner --jq '.nameWithOwner')/milestones" \
  --jq '[.[] | select(.state=="open" and .open_issues==0)] | length' 2>/dev/null || echo 0)

Decision tree:

  1. Milestone exists with 0 open issues → suggest /release full
  2. Unreleased commits > 0, no milestone → suggest /release plan
  3. Clean main, recent tag → suggest /release verify tags
  4. Default → show the subcommand table above and ask what's needed

Execution

Load the template matching the subcommand and follow it completely:

  • plan → ~/.claude/skills/release/templates/plan.md
  • verify → ~/.claude/skills/release/templates/verify.md
  • changelog → ~/.claude/skills/release/templates/changelog.md
  • full → ~/.claude/skills/release/templates/cycle.md

Pass any additional args through:

  • /release verify commits → load verify.md, execute the commits subcommand
  • /release verify tags → load verify.md, execute the tags subcommand
  • /release verify history → load verify.md, execute the history subcommand

Gotchas

  • Auto-detection commands fail soft (|| echo 0) when gh is unauthenticated or there's no GitHub remote — a 0 open-milestone count may mean "no GitHub access", not "no milestones"; verify before trusting the decision tree.
  • git describe --tags --match "v*" only finds tags reachable from HEAD — a tag on a sibling branch is invisible, so "no last tag" can be a false negative.
  • /release changelog propagates the version bump across manifest files (pyproject.toml, package.json, etc.) — verify all manifests moved together; a partial bump ships mismatched versions.
  • /release full tags and ships — it is not a dry run. Run /release plan first to confirm scope.