release-process

Automate npm-based Squad releases with semver validation and rollback procedures.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/WayneWalterBerry/MMO --skill release-process-waynewalterberry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-process
Source: https://github.com/WayneWalterBerry/MMO/tree/main/.copilot/skills/release-process
Command: npx skills add https://github.com/WayneWalterBerry/MMO --skill release-process-waynewalterberry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The release process for Squad is error-prone and lacks a single authoritative runbook to avoid disasters like mis-bumped versions, incorrect tokens, and incomplete releases.

Core Features & Use Cases

  • Step-by-step verification and gating for version bump, tag creation, and release publishing.
  • Enforces semver validity, NPM_TOKEN automation token, clean git state, and blocked build bump in release mode.
  • Supports rollback and manual publish fallback.

Quick Start

Follow this runbook to execute a clean, auditable Squad release from main to a tagged version.

Frequently Asked Questions about release-process

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

FAQPage Schema
How do I automate an npm release process to prevent versioning disasters?

You can prevent npm publishing disasters by enforcing a release runbook that gates versioning with strict semver validation, requires a clean git state on the main branch, and mandates an NPM automation token before publishing.

What steps are required to publish an npm package from the main branch safely?

Publishing an npm package from the main branch safely requires a clean git state, disabled build bump scripts, semver validation, git tagging, and an NPM automation token to ensure a clean, auditable release.

How does semver validation work during a CI-CD npm release?

Semver validation during a CI-CD npm release works by gating the version bump step, ensuring the proposed version number strictly follows semantic versioning rules before allowing any git tagging or npm publishing to proceed.

Do I need an automation token to publish to npm during a release runbook?

Yes, you need an NPM automation token to publish during a release runbook. The process explicitly requires an automation token to authenticate package publishing and prevent unauthorized or incorrect deployments.

How do I rollback a failed npm package release?

To rollback a failed npm package release, follow the runbook's rollback procedures which support manual publish fallbacks to revert version bumps and recover from incomplete or mis-bumped deployments safely.

Why should I disable bump-build.mjs during an npm release?

You should disable bump-build.mjs during an npm release to prevent automated build scripts from overriding the manually validated version bump, ensuring the git tag and npm package version remain consistent and auditable.