release

Automates end-to-end npm releases for Rove with changeset detection, gates, and CI monitoring.

136|8|Updated May 9, 2026
One-click install
npx skills add https://github.com/Sma1lboy/rove --skill release-sma1lboy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/Sma1lboy/rove/tree/main/.claude/skills/release
Command: npx skills add https://github.com/Sma1lboy/rove --skill release-sma1lboy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cutting a release manually involves many error-prone steps: detecting the semver bump from changesets, running lint/typecheck/test gates, tagging and pushing, then watching GitHub Actions until npm publish completes. This Skill automates that entire chain while catching common failures like unintended minor bumps, wrong branches, and silent CI failures. ## Core Features & Use Cases - Semver Bump Detection: Inspects pending .changeset/*.md files, computes the resulting bump, and stops to confirm when an unexpected minor or major changeset would promote the release. - Gate Enforcement: Runs lint, typecheck, tests, build, and the golden perf suite locally before invoking scripts/release.sh, which handles version, changelog, commit, tag, and push. - CI Monitoring & Diagnosis: Polls the GitHub Actions Release workflow with gh, verifies the published versions on npm, and maps CI failures (npm token errors, registry 404, tag mismatch, E409) to precise remediation steps. - Use Case: A maintainer says "cut a release" — the Skill checks whether the automatic changesets workflow already handles it, otherwise runs the local release flow, confirms the tag pushed to main, and reports the published version and release URL. ## Quick Start Ask the agent to cut a release for Rove and it will detect the bump, run the gates, tag and push, then watch CI until the new version is live on npm.

Frequently Asked Questions about release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I cut a release for an npm package using changesets?▼

Run the release flow which inspects pending .changeset/*.md files to compute the semver bump, executes lint, typecheck, test, and build gates, then runs scripts/release.sh to version, commit, tag, and push. The tag push triggers the GitHub Actions Release workflow that publishes to npm.

How do I monitor a GitHub Actions release workflow until npm publish finishes?▼

Use gh run list --workflow=release.yml to find the run for the tag, then gh run watch <run-id> --exit-status to block until completion. Afterwards verify with npm view @sma1lboy/rove@<version> and gh release view to confirm the publish actually landed.

Why did my changeset release bump a minor version instead of a patch?▼

A pending changeset file carries a minor or major bump type in its frontmatter, and changeset version takes the maximum of all pending bumps. The Skill flags this before releasing and asks for confirmation, since an upstream changeset can silently promote the release.

What causes npm publish to fail with 401 or ENEEDAUTH in CI?▼

The NPM_TOKEN secret is missing, expired, or has the wrong scope. Token rotation is a manual task in repository Settings under secrets, and republishing after fixing it requires a new version because npm will not overwrite an existing one.

Can I retry a failed release by force-pushing or retagging the same version?▼

No. The Skill forbids force-pushes, retagging over existing tags, and republishing the same version. A failed publish after a tag push requires a new patch version, while a red CI before tagging lets you fix on main and re-run scripts/release.sh in resume mode.