release-npm-packages - SKILL.md Agent Skill

name: release-npm-packages description: Release npm workspace packages with a deterministic git-based flow: run quality gates, infer semantic version bump from conventional commits since the last version tag, update all publishable package versions, update root CHANGELOG.md, commit release changes, and create a git tag. Use when preparing a new package release in this repository.

Release Npm Packages

Overview

Run this workflow to create a release commit and tag for all publishable packages in this workspace. Use the bundled script for deterministic behavior.

Workflow

Confirm prerequisites.

Run from repository root.
Ensure git working tree is clean before release.
Ensure npm auth is configured if publishing after tagging.

Run release script.

node skills/release-npm-packages/scripts/release-packages.mjs

Verify output.

Check version updates in packages/*/package.json.
Review top entry in CHANGELOG.md.
Confirm new commit message: chore(release): vX.Y.Z.
Confirm new git tag: vX.Y.Z.

Publish packages if requested.

npm publish -w @frenchfryai/core
npm publish -w @frenchfryai/react
npm publish -w @frenchfryai/runtime

Script Behavior

Run quality gates in this order:
- npm run lint
- npm run format:check
- npm run typecheck
- npm run test -- --coverage
- npm run build
Find last release tag matching v* (semver sorted).
Parse conventional commits since last tag (or full history if no tag).
Select bump type:
- major if any commit has BREAKING CHANGE or type(scope)!:
- minor if any feat(...)/feat:
- patch for any other conventional commit type
Update all packages/*/package.json versions to the new version.
Update internal workspace dependencies pinned to old version.
Create or update root CHANGELOG.md.
Create commit and tag.

Failure Handling

If quality gates fail, stop and fix before retry.
If no conventional commits are found, stop and ask user whether to proceed manually.
If git working tree is dirty, stop and ask user to clean/stash unrelated changes first.