npm-release

Automates tag-triggered npm releases with changelog extraction, provenance, and dist-tag verification.

28|1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/NauelG/astro-blocks --skill npm-release-nauelg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: npm-release
Source: https://github.com/NauelG/astro-blocks/tree/main/.agents/skills/npm-release
Command: npx skills add https://github.com/NauelG/astro-blocks --skill npm-release-nauelg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Publishing the @astroblocks/astro-blocks package involves strict tag formats, a machine-parsed changelog contract, provenance attestation, and dist-tag rules; a single formatting mistake silently aborts the release workflow. ## Core Features & Use Cases - Tag and Version Validation: Enforces the vX.Y.Z or vX.Y.Z-alpha.N tag format and requires exact match with package.json version before publishing. - Changelog Contract: Defines the required ## [X.Y.Z] - YYYY-MM-DD header and mandatory ### Title sub-heading parsed by the extract-changelog-entry script. - Dist-Tag and Provenance Rules: Documents that stable releases get only the latest tag while pre-releases get both latest and alpha, and that npm publish --provenance is mandatory. - Use Case: Before cutting release 1.2.0, follow the pre-release checklist to commit a valid changelog entry, run npm version minor, push with --follow-tags, and confirm dist-tags with npm view. ## Quick Start Ask the assistant to walk you through cutting a new stable release of astro-blocks, including the changelog entry, version bump, tag push, and dist-tag verification.

Frequently Asked Questions about npm-release

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

FAQPage Schema
How do I publish a new npm release for astro-blocks?▼

Commit a valid CHANGELOG.md entry, run npm version with a release message, then push with git push --follow-tags. The release-tag.yml workflow validates the tag, runs tests, publishes with provenance, and creates a GitHub Release.

What changelog format does the release workflow require?▼

Each entry needs a header like ## [1.2.0] - 2026-05-01 with square brackets and a space-hyphen-space separator, plus a mandatory ### Title sub-heading with non-empty content. Missing the Title heading aborts the release job.

Why does the release fail with tag version does not match package.json?▼

The workflow requires the Git tag version to exactly equal package.json version without the v prefix. Update package.json via npm version before tagging rather than creating tags manually.

Do alpha pre-releases get different npm dist-tags than stable releases?▼

Yes. Stable releases receive only the latest dist-tag, while pre-releases tagged vX.Y.Z-alpha.N receive both latest and alpha. Verify placement after publishing with npm view @astroblocks/astro-blocks dist-tags.

Can I publish this package manually without provenance?▼

No. Publishing must use npm publish --provenance, which the workflow handles via the id-token: write permission. Publishing without provenance produces an unattested release that consumers cannot verify.