publish-release

Validate a version argument and publish a GitHub release from the main branch.

5|5|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/erraggy/oastools --skill publish-release-erraggy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publish-release
Source: https://github.com/erraggy/oastools/tree/main/.claude/skills/publish-release
Command: npx skills add https://github.com/erraggy/oastools --skill publish-release-erraggy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the final GitHub release deployment by wrapping a prepared release into a safe, irreversible publish step.

Core Features & Use Cases

  • Validates a provided version argument and enforces a strict vX.Y.Z format before publishing.
  • Ensures release notes exist and that the release is performed from the main branch with an automated tag, GitHub release, and CI checks.
  • Provides guardrails by requiring user confirmation before proceeding with an irreversible publish and by executing the release script from the repository root.

Quick Start

Run /publish-release <version> after preparing notes with /prepare-release <version>.

Frequently Asked Questions about publish-release

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

FAQPage Schema
How do I automate a GitHub release deployment safely from the main branch?

To automate a GitHub release deployment safely, you can use a workflow that enforces main-branch checks, validates the version format, and prompts for user confirmation before publishing. This ensures the release step is deterministic and irreversible.

What is the best way to enforce version validation before publishing a GitHub release?

Enforcing version validation before publishing a GitHub release requires checking the version argument against a strict vX.Y.Z format. This prevents invalid tags from being pushed and ensures release notes are verified prior to execution.

How do I run a release script from the repository root with automated tagging?

You can run a release script from the repository root with automated tagging by triggering a publish command that executes the script and verifies the published release. This wraps the deployment into a single validated operation.

Does this release workflow require me to prepare release notes beforehand?

Yes, this release workflow requires you to prepare release notes beforehand. It ensures release notes exist and verifies them before proceeding with the automated GitHub release and tagging process.

Why should I use an irreversible publish step for single-version release flows?

You should use an irreversible publish step for single-version release flows to provide guardrails against accidental deployments. It requires explicit user confirmation and validates the environment before executing the final release.